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

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

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

Примечание

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

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

Элементы

Перечисление Описание
InkPictureSizeMode Определяет значения, определяющие поведение фонового рисунка внутри элемента управления InkPicture.
Событие Описание
ChangeUICues Не рекомендуется.
Щелкните Происходит, когда пользователь щелкает элемент управления InkPicture.
Событие CursorButtonDown Происходит, когда элемент управления InkCollector обнаруживает неактивный объект IInkCursorButton .
Событие CursorButtonUp Происходит, когда элемент управления InkPicture обнаруживает IInkCursorButton , который работает.
Событие CursorDown Происходит, когда подсказка курсора связывается с оцифровываемой поверхностью планшета.
Событие CursorInRange Происходит, когда курсор входит в физический диапазон обнаружения (близкое расположение) контекста планшета.
Событие CursorOutOfRange Происходит, когда курсор покидает физический диапазон обнаружения (близость) контекста планшета.
DblClick Происходит при двойном щелчке элемента управления InkPicture.
Этот метод события определяется в интерфейсе _IInkPictureEvents . Интерфейс _IInkPictureEvents реализует интерфейс IDispatch с идентификатором DISPID_IPEDblClick.
Событие жеста Происходит при распознавании жеста приложения.
Событие KeyDown [Элемент управления InkPicture] Происходит при нажатии клавиши в положении вниз, когда элемент управления InkPicture имеет фокус.
Событие KeyPress[Элемент управления InkPicture] Происходит при нажатии клавиши при фокусе элемента управления InkPicture.
Событие KeyUp [Элемент управления InkPicture] Происходит при освобождении ключа, когда элемент управления InkPicture имеет фокус.
Событие MouseDown [элемент управления InkPicture] Происходит при наведении указателя мыши на элемент управления InkPicture и нажатии кнопки мыши.
Mouseenter Происходит, когда указатель мыши входит в элемент управления InkPicture.
MouseHover Происходит при наведении указателя мыши на элемент управления InkPicture.
Mouseleave Происходит, когда указатель мыши покидает элемент управления InkPicture.
Событие MouseMove [Элемент управления InkPicture] Происходит при перемещении указателя мыши над элементом управления InkPicture.
Событие MouseUp [элемент управления InkPicture] Происходит при наведении указателя мыши на элемент управления InkPicture и отпускании кнопки мыши.
Mousewheel Происходит при перемещении колесика мыши при фокусе элемента управления InkPicture.
Событие NewInAirPackets Происходит при просмотре пакета в воздухе.
Событие NewPackets Происходит, когда элемент управления InkPicture получает пакет.
Окрашены Происходит, когда элемент управления InkPicture завершил перерисовку.
Рисование Происходит перед перерисовкой элемента управления InkPicture.
Изменения размера Происходит при изменении размера элемента управления InkPicture.
SelectionChanged Происходит при изменении выделения текста в элементе управления InkPicture, например путем изменения пользовательского интерфейса, процедур вырезания и вставки или свойства Selection .
SelectionChanging Происходит при изменении выделения текста в элементе управления InkPicture, например путем изменения пользовательского интерфейса, процедур вырезания и вставки или свойства Selection .
SelectionMoved Происходит при изменении позиции текущего выделенного фрагмента, например путем изменения пользовательского интерфейса, процедур вырезания и вставки или свойства Selection .
Событие SelectionMoving [Элемент управления InkPicture] Происходит при изменении позиции текущего выделенного фрагмента, например путем изменения пользовательского интерфейса, процедур вырезания и вставки или свойства Selection .
SelectionResized Происходит при изменении размера текущего выделенного фрагмента, например путем изменения пользовательского интерфейса, процедур вырезания и вставки или свойства Selection .
SelectionResizing Происходит при изменении размера текущего выделенного фрагмента, например путем изменения пользовательского интерфейса, процедур вырезания и вставки или свойства Selection .
Sizechanged Происходит после изменения размера элемента управления InkPicture, в частности после изменения значения свойства Width или Height .
SizeModeChanged Происходит после изменения свойства SizeMode элемента управления InkPicture.
StyleChanged Не реализован.
Инсульта Происходит, когда пользователь рисует новый росчерк на любом планшете.
StrokesDeleted Происходит после удаления объектов IInkStrokeDisp из свойства Ink .
Удаление штрихов Происходит перед удалением объектов IInkStrokeDisp из свойства Ink .
SystemColorsChanged Происходит после изменения системных цветов.
SystemGesture Происходит при распознавании системного жеста.
Событие TabletAdded Происходит при добавлении планшета в систему.
Событие TabletRemoved Происходит при удалении планшета из системы.
Метод Описание
Метод GetEventInterest Возвращает значение, указывающее, заинтересован ли элемент управления InkPicture в определенном событии.
GetGestureStatus Возвращает значение, указывающее, заинтересован ли элемент управления InkPicture в определенном жесте приложения.
Метод GetWindowInputRectangle Возвращает прямоугольник окна в пикселях, внутри которого рисуется рукописный ввод.
HitTestSelection Возвращает элемент перечисления SelectionHitResult , который указывает, какая часть выделенного фрагмента была достигнута во время проверки нажатия.
Метод SetAllTabletsMode Позволяет элементу управления InkPicture собирать рукописные фрагменты с любого планшета, подключенного к планшетному компьютеру.
Метод SetEventInterest Задает значение, указывающее, заинтересован ли элемент управления InkPicture в указанном событии.
SetFocus Перемещает фокус на элемент управления InkPicture.
Метод SetGestureStatus Задает интерес объекта InkPicture в указанном жесте приложения.
Метод SetSingleTabletIntegratedMode Задает элемент управления InkPicture для сбора рукописного ввода только с одного планшета, подключенного к планшетному компьютеру. Рукописный ввод с других планшетов игнорируется.
Метод SetWindowInputRectangle Задает прямоугольник окна в координатах окна, в пределах которого рисуется рукописный ввод.
ShowWhatsThis Отображает выбранный раздел в файле справки с помощью всплывающего окна "Что это", предоставленного справкой в 32-разрядных операционных системах Microsoft Windows (только во время разработки).
ZOrder Размещает элемент управления в передней или задней части Z-порядка в пределах графического уровня (только во время разработки).
Свойство Описание
Свойство AutoRedraw Возвращает или задает значение, указывающее, перерисовывается ли элемент управления InkPicture, когда окно становится недействительным (если объект InkDisp , связанный в данный момент с элементом управления InkPicture, автоматически перерисовывается, когда окно, связанное с InkPicture, получает сообщение WM_PAINT).
Backcolor Возвращает или задает цвет фона для элемента управления InkPicture. Цвет фона по умолчанию — это цвет фона системного окна, который обычно является белым.
Свойство CollectingInk Возвращает значение, указывающее, собирает ли элемент управления InkPicture рукописный ввод (только во время выполнения).
CollectionMode Получает или задает режим сбора, который определяет, распознаются ли рукописные фрагменты, жесты или рукописные фрагменты и жесты при записи пользователем.
Свойство Cursors Возвращает коллекцию IInkCursors, доступную для использования в области рукописного ввода элемента управления InkPicture.
CustomStrokes Возвращает коллекцию IInkCustomStrokes , сохраняемую с помощью рукописного ввода (только во время разработки).
Свойство DefaultDrawingAttributes Возвращает или задает коллекцию по умолчанию InkDrawingAttributes , используемую при рисовании и отображении рукописного ввода (только во время выполнения).
Свойство DesiredPacketDescription Возвращает или задает описание пакета элемента управления InkPicture (только во время выполнения).
Свойство DynamicRendering Возвращает или задает значение, указывающее, будет ли элемент управления InkPicture динамически отрисовывать рукописный ввод по мере его сбора.
EditingMode Возвращает или задает значение, указывающее, находится ли элемент управления InkPicture в режиме рукописного ввода, в режиме удаления или в режиме выбора или редактирования.
Активировано Возвращает или задает значение, определяющее, может ли элемент управления InkPicture реагировать на события, созданные пользователем.
Примечание: Это свойство эквивалентно свойству InkEnabled .
EraserMode Возвращает или задает значение, указывающее, удаляются ли рукописные фрагменты росчерком или точкой.
EraserWidth Возвращает или задает значение, указывающее ширину кончика пера ластика.
Hwnd Возвращает дескриптор окна, к которому привязан элемент управления InkPicture. (только во время выполнения)
Рукописный ввод Возвращает или задает объект InkDisp , связанный с элементом управления InkPicture (только во время выполнения).
InkEnabled Возвращает или задает значение, указывающее, собирает ли элемент управления InkPicture входные данные пером (пакеты в воздухе, курсор в событиях диапазона и т. д.).
Свойство MarginX Возвращает или задает поле оси X вокруг прямоугольника окна в координатах экрана.
Свойство MarginY Возвращает или задает поле оси Y вокруг прямоугольника окна в координатах экрана.
Свойство MouseIcon Возвращает или задает текущий пользовательский значок мыши.
Свойство MousePointer Возвращает или задает значение, указывающее тип указателя мыши, который отображается при наведении указателя мыши на определенную часть элемента управления InkPicture.
Картину Возвращает графический файл, отображаемый в элементе управления InkPicture.
Свойство отрисовщика Возвращает или задает объект InkRenderer , используемый для рисования рукописного ввода в элементе управления InkPicture (только во время выполнения).
Выбор Возвращает коллекцию InkStrokes, выбранную в данный момент внутри элемента управления InkPicture (только во время выполнения).
SizeMode Возвращает или задает способ обработки размещения и изменения размера изображения элементом управления.
Свойство SupportHighContrastInk Возвращает значение, указывающее, отображается ли рукописный ввод только как один цвет, Color = COLOR_WINDOWTEXT (из вызова GetSystemMetrics), когда система находится в режиме высокой контрастности.
SupportHighContrastSelectionUI Возвращает или задает значение, указывающее, рисуются ли все пользовательские интерфейсы выбора (ограничивающие рамки выделения и маркеры выделения) с высокой контрастностью, когда система находится в режиме высокой контрастности.
Свойство Tablet Возвращает объект IInkTablet , который в настоящее время используется элементом управления 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, а затем скопировать и вставить рукописный ввод в другие приложения. Однако его свойство InkEnabled всегда будет иметь значение FALSE.

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

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

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

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

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

Примечание

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

Реализация COM

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

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

Класс InkOverlay