Справочник по элементу управления InkPicture

Элемент управления InkPicture предоставляет возможность поместить изображение в приложение и позволить пользователям добавлять рукописные данные поверх него. Он предназначен для сценариев, в которых рукописный ввод не распознается как текст, а сохраняется в виде рукописных данных.

Экземпляр элемента управления InkPicture можно создать, вызвав метод CoCreateInstance в C++.

Примечание

Элемент управления InkPicture не помечен как надежный для создания скриптов. Элемент управления InkPicture не должен использоваться на страницах HTML или ASP.NET.

Создание элемента управления InkPicture за прозрачным элементом управления (например, GroupBox с _ _ набором свойств WS ex) предотвратит Сбор рукописных данных.

Элементы

Перечисление Описание
инкпиктуресиземоде Определяет значения, которые определяют, как фоновое изображение ведет себя внутри элемента управления InkPicture.
Событие Описание
ChangeUICues Не рекомендуется.
Щелкните Происходит, когда пользователь щелкает элемент управления InkPicture.
Событие Курсорбуттондовн Происходит, когда элемент управления InkCollector обнаруживает неиинккурсорбуттоный объект.
Событие Курсорбуттонуп Происходит, когда элемент управления InkPicture обнаруживает иинккурсорбуттон .
Событие Курсордовн Происходит, когда подсказка курсора обращается к поверхности планшета в дигитайзере.
Событие Курсоринранже Происходит при входе курсора в диапазон физического обнаружения (близость) контекста планшета.
Событие Курсораутофранже Происходит, когда курсор покидает диапазон физического обнаружения (близость) контекста планшета.
Кнопки Происходит при двойном щелчке элемента управления InkPicture.
Этот метод события определен в интерфейсе _ иинкпиктуривентс . Интерфейс _ иинкпиктуривентс реализует интерфейс IDISPATCH с идентификатором DISPID _ ипедблкликк.
Событие жеста Происходит при распознавании жеста приложения.
[Элемент управления InkPicture события KeyDown] Происходит при нажатии клавиши и в расположении вниз, пока элемент управления InkPicture находится в фокусе.
[Элемент управления InkPicture события KeyPress] Происходит при нажатии клавиши, когда элемент управления InkPicture имеет фокус.
[Элемент управления InkPicture события KeyUp] Происходит при освобождении ключа, когда элемент управления InkPicture имеет фокус.
[Элемент управления InkPicture события MouseDown] Происходит при нажатии кнопки мыши, когда указатель мыши находится над элементом управления InkPicture.
События Происходит, когда указатель мыши входит в элемент управления InkPicture.
маусеховер Происходит при наведении указателя мыши на элемент управления InkPicture.
MouseLeave Происходит, когда указатель мыши покидает элемент управления InkPicture.
[Элемент управления InkPicture события MouseMove] Происходит при перемещении указателя мыши над элементом управления InkPicture.
[Элемент управления InkPicture события MouseUp] Происходит при отпускании кнопки мыши, когда указатель мыши находится над элементом управления InkPicture.
маусевхил Происходит при движении колесика мыши, когда элемент управления InkPicture имеет фокус.
Событие Невинаирпаккетс Происходит при обнаружении пакета в эфире.
Событие Невпаккетс Происходит, когда элемент управления InkPicture получает пакет.
Окрашивает Происходит при завершении перерисовки элемента управления InkPicture.
Оформленные Происходит перед перерисовкой элемента управления InkPicture.
Изменить размер Происходит при изменении размера элемента управления InkPicture.
SelectionChanged Происходит при изменении выделения текста внутри элемента управления InkPicture, например при преобразовании в пользовательский интерфейс, процедурах вырезания и вставки или свойством Selection .
селектиончангинг Происходит при изменении выделения текста внутри элемента управления InkPicture, например посредством изменений пользовательского интерфейса, процедур копирования и вставки или свойства Selection .
селектионмовед Происходит при изменении расположения текущего выделения, например посредством изменений пользовательского интерфейса, процедур копирования и вставки или свойства Selection .
[Элемент управления InkPicture события селектионмовинг] Происходит, когда расположение текущего выделения собирается измениться, например, посредством изменений пользовательского интерфейса, процедур копирования и вставки или свойства Selection .
селектионресизед Происходит при изменении размера текущего выделения, например с помощью изменений пользовательского интерфейса, процедур копирования и вставки или свойства Selection .
селектионресизинг Происходит, когда размер текущего выделения собирается измениться, например посредством изменений пользовательского интерфейса, процедур копирования и вставки или свойства Selection .
SizeChanged Происходит после изменения размера элемента управления InkPicture, в частности после того, как изменяется значение свойства Width или Height .
сиземодечанжед Происходит после изменения свойства сиземоде элемента управления InkPicture.
стилечанжед Не реализован.
Водок Происходит, когда пользователь рисует новый штрих на любом планшете.
строкесделетед Происходит после удаления объектов иинкстрокедисп из свойства Ink .
строкесделетинг Происходит перед удалением объектов иинкстрокедисп из свойства Ink .
системколорсчанжед Происходит после изменения системных цветов.
системжестуре Происходит при распознавании системного жеста.
Событие Таблетаддед Происходит при добавлении планшета в систему.
Событие Таблетремовед Происходит при удалении планшета из системы.
Метод Описание
Метод Жетевентинтерест Возвращает значение, указывающее, имеет ли элемент управления InkPicture интерес к определенному событию.
жетжестурестатус Возвращает значение, указывающее, имеет ли элемент управления InkPicture интерес к определенному жесту приложения.
Метод Жетвиндовинпутректангле Возвращает прямоугольник окна (в пикселях), в котором рисуются рукописные данные.
хиттестселектион Возвращает член перечисления селектионхитресулт , указывающий, какая часть выбора (если таковая имеется) была достигнута во время проверки попадания.
Метод Сеталлтаблетсмоде Позволяет элементу управления InkPicture сохранять рукописный ввод с любого планшета, подключенного к планшетному ПК.
Метод Сетевентинтерест Задает значение, указывающее, имеет ли элемент управления InkPicture объект в указанном событии.
SetFocus Перемещает фокус на элемент управления InkPicture.
Метод Сетжестурестатус Задает интерес объекта InkPicture в указанном жесте приложения.
Метод Сетсинглетаблетинтегратедмоде Задает элемент управления InkPicture для получения рукописных данных только с одного планшета, подключенного к планшетному ПК. Рукописный ввод с других планшетов игнорируется.
Метод Сетвиндовинпутректангле Задает прямоугольник окна для установки в координатах окна, в которых рисуются рукописные данные.
шоввхатссис Отображает выбранный раздел в файле справки, используя всплывающее меню «что это», предоставляемое справкой в 32-разрядных операционных системах Microsoft Windows (только во время разработки).
зордер Помещает элемент управления на передний или задний план z-порядка в его графическом уровне (только во время разработки).
Свойство Описание
Ауторедрав, свойство Возвращает или задает значение, указывающее, перерисовывается ли элемент управления InkPicture при недействительности окна (объект инкдисп , который в данный момент связан с элементом управления InkPicture, автоматически перерисовывается, когда окно, связанное с InkPicture, получает сообщение WM_PAINT).
BackColor Возвращает или задает цвет фона для элемента управления InkPicture. Цвет фона по умолчанию — это цвет фона системного окна, который обычно является белым.
Коллектингинк, свойство Возвращает значение, указывающее, собирает ли элемент управления InkPicture рукописный ввод (только время выполнения).
Режиме CollectionMode Возвращает или задает режим сбора, определяющий, распознаются ли рукописный ввод, жесты или рукописный ввод и жесты при записи пользователем.
Cursor, свойство Возвращает коллекцию иинккурсорс , доступную для использования в области рукописного ввода в элементе управления InkPicture.
кустомстрокес Возвращает коллекцию иинккустомстрокес , которая должна быть сохранена с рукописным вводом (только во время разработки).
DefaultDrawingAttributes, свойство Возвращает или задает коллекцию инкдравингаттрибутес по умолчанию, используемую при прорисовке и отображении рукописного ввода (только во время выполнения).
Десиредпаккетдескриптион, свойство Возвращает или задает описание пакета для элемента управления InkPicture (только время выполнения).
Динамикрендеринг, свойство Возвращает или задает значение, указывающее, будет ли элемент управления InkPicture динамически отображать рукописный ввод при его сборе.
EditingMode Возвращает или задает значение, указывающее, находится ли элемент управления InkPicture в режиме рукописного ввода, режиме удаления или режиме правки или выбора.
Активировано Возвращает или задает значение, определяющее, может ли элемент управления InkPicture отвечать на создаваемые пользователем события.
[!Note]
Это свойство эквивалентно свойству инкенаблед .

ерасермоде Возвращает или задает значение, указывающее, удаляются ли рукописные данные по штрихам или по точкам.
ерасервидс Возвращает или задает значение, указывающее ширину кончика пера ластика.
hWnd Возвращает описатель окна, к которому привязан элемент управления InkPicture. (только время выполнения)
Рукописный ввод Возвращает или задает объект инкдисп , связанный с элементом управления InkPicture (только время выполнения).
инкенаблед Возвращает или задает значение, указывающее, собирает ли элемент управления InkPicture входные данные пера (пакеты в сети Air, курсоры в пределах диапазона и т. д.).
Маргинкс, свойство Возвращает или задает поле оси x вокруг прямоугольника окна в экранных координатах.
Свойство Margin Возвращает или задает поле оси y вокруг прямоугольника окна в экранных координатах.
Маусеикон, свойство Возвращает или задает текущий пользовательский значок мыши.
MousePointer, свойство Возвращает или задает значение, указывающее тип указателя мыши, который появляется при наведении указателя мыши на определенную часть элемента управления InkPicture.
Picture Возвращает графический файл, отображаемый в элементе управления InkPicture.
Свойство модуля подготовки отчетов Возвращает или задает объект инкрендерер , используемый для рисования рукописного ввода в элементе управления InkPicture (только время выполнения).
Выбор Возвращает коллекцию инкстрокес , выбранную в данный момент в элементе управления InkPicture (только время выполнения).
SizeMode Возвращает или задает способ, которым элемент управления обрабатывает размещение и изменение размера изображения.
Суппорсигхконтрастинк, свойство Возвращает значение, указывающее, отображаются ли рукописные данные только в одном цвете, Color = COLOR_WINDOWTEXT (из вызова Жетсистемметрикс), когда система находится в режиме высокая контрастность.
суппорсигхконтрастселектионуи Возвращает или задает значение, указывающее, отображаются ли все пользовательские интерфейсы выделения (ограничивающие прямоугольники выделения и маркеры выделения) с высокой контрастностью, когда система находится в режиме высокая контрастность.
Свойство планшета Возвращает объект иинктаблет , который в настоящее время использует элемент управления InkPicture для получения входных данных.

Комментарии

Пользовательский интерфейс времени выполнения для элемента управления InkPicture — это окно с непрозрачным фоном (один цвет, фон изображения или и то, и другое), которое содержит непрозрачные рукописные данные.

Элемент управления InkPicture можно использовать для визуализации рукописного ввода в Microsoft Windows 2000, Windows Server 2003, любом выпуске Windows XP, отличном от Windows XP Tablet PC Edition, и любой версии Windows Vista. Однако вы можете ввести рукописный ввод, принять жесты или распознать рукописный ввод только при следующих условиях:

  • Рукописный ввод может быть введен и распознан при установке Windows Vista или XP Tablet PC Edition 2005.
  • Также можно распознать жесты.
  • Рукописный ввод можно распознать как текст, если рукописный ввод создан на компьютерах с более ранними версиями Windows, при условии наличия распознавателей.

При использовании Windows 2000, Windows Server 2003, любого выпуска Windows XP, отличного от Windows XP Tablet PC Edition 2005, можно присваивать значения внешним свойствам элемента управления InkPicture, а затем копировать и вставлять рукописные данные в другие приложения. Однако значение его свойства Инкенаблед всегда будет равно false.

Сохраненные объекты инкдисп можно загружать и отображать во всех выпусках Windows Vista и XP, а также в системах, где установлен только пакет средств разработки программного обеспечения Windows XP Tablet PC Edition (SDK). Объекты инкдисп можно преобразовать в текст (распознается), если установлен Windows Vista или Windows XP Tablet PC Edition 2005.

Если операции с этим элементом управления не выполнены, возвращается юридическое значение HRESULT. При возникновении условий ошибки проверьте возвращенное значение HRESULT для ошибки.

Дополнительные сведения об элементах управления рукописного ввода см. в разделе Рукописный ввод.

Сведения о том, какие потоки вызывают определенные события, см. в разделе потоки, в которых может срабатывать событие.

Чтобы повысить производительность приложения, вручную удалите элемент управления InkPicture, когда он больше не нужен.

Примечание

Если элемент управления InkPicture накладывается на другой элемент управления, такой как GroupBox , для которого задано значение Transparent, то функция InkPicture не будет выполнять накопление рукописного ввода. InkPicture должен быть самым верхним элементом управления в Z-порядке или дочерним по отношению к GroupBox.

Реализация COM

Этот объект реализует COM-интерфейс иинкпиктуре .

Ссылка на элемент управления InkEdit

Класс InkOverlay