Справочник по элементу управления 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 .