Справочник по элементу управления 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 Control] | Происходит при нажатии клавиши во время фокуса элемента управления 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 | Происходит при изменении размера текущего выбора, например путем изменения пользовательского интерфейса, процедур вырезания и вставки или свойства выбора. |
| SelectionResizing | Происходит при изменении размера текущего выделенного фрагмента, например путем изменения пользовательского интерфейса, процедур вырезания и вставки или свойства выбора. |
| 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-разрядных операционных системах Microsoft Windows (только во время разработки). |
| ZOrder | Размещает элемент управления на передней или задней части z-порядка в графическом уровне (только во время разработки). |
| Свойство | Описание |
|---|---|
| свойство AutoRedraw | Возвращает или задает значение, указывающее, будет ли элемент управления InkPicture переопределен, когда окно является недействительным (будет ли объект InkDisp, связанный с элементом управления InkPicture, автоматически перезаписывается, когда окно, связанное с InkPicture, получает сообщение WM_PAINT). |
| BackColor | Возвращает или задает цвет фона для элемента управления InkPicture. Цвет фона по умолчанию — это цвет фона системного окна, который обычно является белым. |
| CollectingInk Property | Возвращает значение, указывающее, собирает ли элемент управления InkPicture рукописный ввод (только время выполнения). |
| CollectionMode | Получает или задает режим коллекции, определяющий, распознаются ли рукописные рукописные и рукописные жесты, а также жесты. |
| свойства курсоров | Возвращает коллекцию 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 Property | Возвращает значение, указывающее, отображается ли рукописный ввод как только один цвет, Color = COLOR_WINDOWTEXT (из вызова GetSystemMetrics), когда система находится в режиме высокой контрастности. |
| SupportHighContrastSelectionUI | Возвращает или задает значение, указывающее, рисуются ли все пользовательские интерфейсы выбора (ограничивающие рамки выбора и дескриптор выделения) в режиме высокой контрастности. |
| свойства планшета | Возвращает объект 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 и на системах с установленным пакетом средств разработки программного обеспечения windows XP TABLET PC Edition (SDK). объекты InkDisp можно преобразовать только в текст (распознанный), если установлен Windows Vista или Windows XP Tablet PC Edition 2005.
Если операции с этим элементом управления не выполнены, возвращается юридический HRESULT. Если возникают ошибки, проверьте возвращенный HRESULT по ошибке.
Дополнительные сведения об элементах управления рукописным вводом см. в разделе рукописного ввода.
Сведения о том, какие потоки вызывают определенные события, см. в разделе Потоки, в которых событие может запускать.
Чтобы повысить производительность приложения, вручную удалите элемент управления InkPicture, когда он больше не нужен.
Заметка
Если элемент управления InkPicture наложен другим элементом управления, например GroupBox установлен на прозрачный, inkPicture не будет собирать рукописный ввод. InkPicture должен быть самым лучшим элементом управления в порядке Z или должен быть дочерним элементом GroupBox.
Реализация COM
Этот объект реализует интерфейс COM IInkPicture.