Справочник по элементу управления 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 Event[Элемент управления 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 | Происходит при добавлении планшета в систему. |
| Событие "Удалено планшетов" | Происходит при удалении планшета из системы. |
| Метод | Описание |
|---|---|
| Метод GetEventInterest | Возвращает значение, указывающее, имеет ли элемент управления InkPicture интерес к конкретному событию. |
| GetGestureStatus | Возвращает значение, указывающее, имеет ли элемент управления InkPicture интерес к определенному жесту приложения. |
| Метод GetWindowInputRectangle | Возвращает прямоугольник окна в пикселях, в котором рисуется рукописный ввод. |
| HitTestSelection | Возвращает элемент перечисления SelectionHitResult , который указывает, какая часть выделенного фрагмента, если она есть, была достигнута во время теста нажатия. |
| Метод SetAllTabletsMode | Позволяет элементу управления InkPicture собирать рукописные фрагменты с любого планшета, подключенного к планшетному компьютеру. |
| Метод SetEventInterest | Задает значение, указывающее, имеет ли элемент управления InkPicture интерес к указанному событию. |
| SetFocus | Перемещает фокус на элемент управления InkPicture. |
| Метод SetGestureStatus | Задает интерес объекта InkPicture в указанном жесте приложения. |
| Метод SetSingleTabletIntegratedMode | Задает элемент управления InkPicture для сбора рукописного ввода только с одного планшета, подключенного к планшетному компьютеру. Рукописный ввод с других планшетов игнорируется. |
| Метод SetWindowInputRectangle | Задает прямоугольник окна, заданный в координатах окна, в которых рисуется рукописный ввод. |
| ShowWhatsThis | Отображает выбранный раздел в файле справки с помощью всплывающего окна "Что это", предоставляемого справкой в 32-разрядных операционных системах Майкрософт Windows (только во время разработки). |
| ZOrder | Помещает элемент управления в передней или задней части z-порядка в графическом уровне (только во время разработки). |
| Свойство | Описание |
|---|---|
| Свойство AutoRedraw | Возвращает или задает значение, указывающее, перерисовывается ли элемент управления InkPicture при недопустимом окне (возвращается ли объект InkDisp , связанный с элементом управления InkPicture, автоматически перерисовывается, когда окно, связанное с InkPicture, получает WM_PAINT сообщение). |
| Backcolor | Возвращает или задает цвет фона для элемента управления InkPicture. Цвет фона по умолчанию — это цвет фона системного окна, который обычно белый. |
| Свойство CollectingInk | Возвращает значение, указывающее, собирает ли элемент управления InkPicture рукописный ввод (только время выполнения). |
| CollectionMode | Возвращает или задает режим сбора, определяющий, распознаются ли рукописные фрагменты, жесты или рукописные и жесты как пользователь записывает. |
| Свойство Cursors | Возвращает коллекцию IInkCursors , доступную для использования в области рукописного ввода элемента управления InkPicture. |
| CustomStrokes | Возвращает коллекцию IInkCustomStrokes , сохраняемую с помощью рукописного ввода (только во время разработки). |
| Свойство DefaultDrawingAttributes | Возвращает или задает коллекцию InkDrawingAttributes по умолчанию, используемую при рисовании и отображении рукописного ввода (только во время выполнения). |
| DesiredPacketDescription Property | Возвращает или задает описание пакета элемента управления InkPicture (только во время выполнения). |
| Свойство DynamicRendering | Возвращает или задает значение, указывающее, динамически ли элемент управления InkPicture отрисовывает рукописный ввод по мере сбора. |
| EditingMode | Возвращает или задает значение, указывающее, находится ли элемент управления InkPicture в режиме рукописного ввода, режиме удаления или в режиме выбора или редактирования. |
| Включен | Возвращает или задает значение, определяющее, может ли элемент управления InkPicture реагировать на события, созданные пользователем.[! Примечание] |
| EraserMode | Возвращает или задает значение, указывающее, удаляется ли рукописный фрагмент по росчерку или по точкам. |
| EraserWidth | Возвращает или задает значение, указывающее ширину кончика пера ластика. |
| Hwnd | Возвращает дескриптор окна, к которому привязан элемент управления InkPicture. (только время выполнения) |
| Рукописный ввод | Возвращает или задает объект InkDisp , связанный с элементом управления InkPicture (только во время выполнения). |
| InkEnabled | Возвращает или задает значение, указывающее, собирает ли элемент управления InkPicture входные данные пера (пакеты в воздухе, курсор в событиях диапазона и т. д.). |
| Свойство MarginX | Возвращает или задает поле оси X вокруг прямоугольника окна в координатах экрана. |
| Свойство MarginY | Возвращает или задает поле оси Y вокруг прямоугольника окна в координатах экрана. |
| MouseIcon Property | Возвращает или задает текущий настраиваемый значок мыши. |
| Свойство MousePointer | Возвращает или задает значение, указывающее тип указателя мыши, который появляется, когда указатель мыши находится над определенной частью элемента управления InkPicture. |
| Picture | Возвращает графический файл, отображаемый в элементе управления InkPicture. |
| Свойство отрисовщика | Возвращает или задает объект InkRenderer , используемый для рисования рукописного ввода в элементе управления InkPicture (только во время выполнения). |
| Выбор | Возвращает коллекцию InkStrokes , выбранную в элементе управления InkPicture (только во время выполнения). |
| SizeMode | Возвращает или задает способ обработки размещения и изменения размера изображения элементом управления. |
| Свойство SupportHighContrastInk | Возвращает значение, указывающее, отображается ли рукописный ввод как только один цвет, Color = COLOR_WINDOWTEXT (из вызова GetSystemMetrics), когда система находится в режиме высокой контрастности. |
| SupportHighContrastSelectionUI | Возвращает или задает значение, указывающее, рисуются ли все пользовательские интерфейсы выбора (ограничивающие прямоугольники и маркеры выделения) в режиме высокой контрастности, если система находится в режиме высокой контрастности. |
| Свойство Планшета | Возвращает объект IInkTablet , который в настоящее время используется элементом управления InkPicture для сбора входных данных. |
Remarks
Пользовательский интерфейс времени выполнения для элемента управления 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 .