Referencia del control InkPicture
El control InkPicture proporciona la capacidad de colocar una imagen en una aplicación y permitir a los usuarios agregar entrada de lápiz sobre ella. Está pensado para escenarios en los que la entrada de lápiz no se reconoce como texto, sino que se almacena como entrada de lápiz.
El control InkPicture se puede crear una instancia llamando al método CoCreateInstance en C++.
Nota
El control InkPicture no está marcado como seguro para el scripting. El control InkPicture no debe usarse en html ni en páginas ASP.NET.
La creación del control InkPicture detrás de un control transparente (como groupBox con el conjunto de propiedades WS_EX_TRANSPARENT) impedirá que InkPicture recopile la entrada de lápiz.
Miembros
| Enumeración | Descripción |
|---|---|
| InkPictureSizeMode | Define valores que especifican cómo se comporta la imagen de fondo dentro del control InkPicture. |
| Evento | Descripción |
|---|---|
| ChangeUICues | Obsolescente. |
| haga clic en | Se produce cuando un usuario hace clic en el control InkPicture. |
| evento CursorButtonDown | Se produce cuando el control InkCollector detecta un objeto IInkCursorButton que está inactivo. |
| de eventosCursorButtonUp | Se produce cuando el control InkPicture detecta un IInkCursorButton que está arriba. |
| del evento CursorDown de | Se produce cuando la sugerencia del cursor se pone en contacto con la superficie de la tableta digitalizada. |
| de eventos CursorInRange | Se produce cuando un cursor entra en el intervalo de detección físico (proximidad) del contexto de la tableta. |
| evento CursorOutOfRange | Se produce cuando el cursor deja el intervalo de detección físico (proximidad) del contexto de la tableta. |
| DblClick | Se produce cuando se hace doble clic en el control InkPicture. Este método de evento se define en la interfaz _IInkPictureEvents. La interfaz _IInkPictureEvents implementa la interfaz IDispatch con un identificador de DISPID_IPEDblClick. |
| de eventosgesto | Se produce cuando se reconoce un gesto de aplicación. |
| Evento KeyDown de [Control InkPicture] | Se produce cuando se presiona una tecla y se encuentra en la posición abajo mientras el control InkPicture tiene el foco. |
| evento KeyPress[Control InkPicture] | Se produce cuando se presiona una tecla mientras el control InkPicture tiene el foco. |
| evento KeyUp de [Control InkPicture] | Se produce cuando se suelta una tecla mientras el control InkPicture tiene el foco. |
| evento MouseDown [Control InkPicture] | Se produce cuando el puntero del mouse está sobre el control InkPicture y se presiona un botón del mouse. |
| MouseEnter | Se produce cuando el puntero del mouse entra en el control InkPicture. |
| MouseHover | Se produce cuando el puntero del mouse mantiene el puntero sobre el control InkPicture. |
| mouseLeave | Se produce cuando el puntero del mouse deja el control InkPicture. |
| evento MouseMove [Control InkPicture] | Se produce cuando el puntero del mouse se mueve sobre el control InkPicture. |
| evento MouseUp [Control InkPicture] | Se produce cuando el puntero del mouse está sobre el control InkPicture y se suelta un botón del mouse. |
| MouseWheel | Se produce cuando la rueda del mouse se mueve mientras el control InkPicture tiene el foco. |
| de eventos NewInAirPackets | Se produce cuando se ve un paquete en el aire. |
| de eventos NewPackets | Se produce cuando el control InkPicture recibe un paquete. |
| pintado | Se produce cuando el control InkPicture se ha completado para volver a dibujarse. |
| cuadro | Se produce antes de que el control InkPicture vuelva a dibujarse. |
| Cambiar tamaño | Se produce cuando se cambia el tamaño del control InkPicture. |
| SelectionChanged | Se produce cuando la selección de texto dentro del control InkPicture ha cambiado, como a través de modificaciones en la interfaz de usuario, procedimientos de corte y pegado, o la propiedad Selection. |
| SelectionChanging | Se produce cuando la selección de texto dentro del control InkPicture está a punto de cambiar, como a través de modificaciones en la interfaz de usuario, procedimientos de corte y pegado, o la propiedad Selection. |
| SelectionMoved | Se produce cuando la posición de la selección actual ha cambiado, como a través de modificaciones en la interfaz de usuario, procedimientos de corte y pegado, o la propiedad Selection. |
| evento SelectionMoving [Control InkPicture] | Se produce cuando la posición de la selección actual está a punto de cambiar, como a través de modificaciones en la interfaz de usuario, procedimientos de corte y pegado, o la propiedad Selection. |
| SelectionResized | Se produce cuando el tamaño de la selección actual ha cambiado, como a través de modificaciones en la interfaz de usuario, procedimientos de corte y pegado, o la propiedad Selection. |
| SelecciónResizing | Se produce cuando el tamaño de la selección actual está a punto de cambiar, como a través de modificaciones en la interfaz de usuario, procedimientos de corte y pegado, o la propiedadSelection de. |
| SizeChanged | Se produce después de cambiar el tamaño del control InkPicture, en concreto, después de que cambie elwidth deo Height valor de propiedad. |
| SizeModeChanged | Se produce después de que se haya cambiado la propiedad SizeMode del control InkPicture. |
| StyleChanged | No implementado. |
| de trazo de | Se produce cuando el usuario dibuja un trazo nuevo en cualquier tableta. |
| StrokesDeleted | Se produce después de eliminar objetos IInkStrokeDisp de la propiedadInk. |
| StrokesDeleting | Se produce antes de que objetos IInkStrokeDisp se eliminen de la propiedad Ink. |
| SystemColorsChanged | Se produce después de que los colores del sistema cambien. |
| SystemGesture | Se produce cuando se reconoce un gesto del sistema. |
| de eventos TabletAdded | Se produce cuando se agrega una tableta al sistema. |
| evento TabletRemoved | Se produce cuando se quita una tableta del sistema. |
| Método | Descripción |
|---|---|
| método GetEventInterest | Devuelve un valor que indica si el control InkPicture tiene interés en un evento determinado. |
| GetGestureStatus | Devuelve un valor que indica si el control InkPicture tiene interés en un gesto de aplicación determinado. |
| método GetWindowInputRectangle | Devuelve el rectángulo de ventana, en píxeles, dentro del cual se dibuja la entrada de lápiz. |
| HitTestSelection | Devuelve un miembro de la SelectionHitResult enumeración, que especifica qué parte de una selección, si existe, se alcanzó durante una prueba de posicionamiento. |
| método SetAllTabletsMode | Permite que el control InkPicture recopile tinta de cualquier tableta conectada al pc tablet. |
| método SetEventInterest | Establece un valor que indica si un control InkPicture tiene interés en un evento especificado. |
| SetFocus | Mueve el foco al control InkPicture. |
| método SetGestureStatus | Establece el interés del objeto InkPicture en un gesto de aplicación especificado. |
| método SetSingleTabletIntegratedMode | Establece el control InkPicture para recopilar tinta de solo una tableta conectada al pc tablet. Se omite la entrada de lápiz de otras tabletas. |
| método SetWindowInputRectangle | Especifica el rectángulo de ventana que se va a establecer, en coordenadas de ventana, en el que se dibuja la entrada de lápiz. |
| ShowWhatsThisThis | Muestra un tema seleccionado en un archivo de Ayuda con el elemento emergente "What's This" proporcionado por la Ayuda en sistemas operativos Microsoft Windows de 32 bits (solo en tiempo de diseño). |
| ZOrder | Coloca el control en la parte delantera o posterior del orden z dentro de su nivel gráfico (solo en tiempo de diseño). |
| Propiedad | Descripción |
|---|---|
| propiedad AutoRedraw | Obtiene o establece un valor que especifica si el control InkPicture vuelve a dibujarse cuando se invalida la ventana (si el objeto InkDisp asociado actualmente al control InkPicture se vuelve a dibujar automáticamente cuando la ventana asociada a InkPicture recibe un mensaje de WM_PAINT). |
| BackColor | Obtiene o establece el color de fondo del control InkPicture. El color de fondo predeterminado es el color de fondo de la ventana del sistema, que suele ser blanco. |
| deCollectingInk | Obtiene el valor que especifica si el control InkPicture está recopilando entrada de lápiz (solo tiempo de ejecución). |
| CollectionMode de | Obtiene o establece el modo de colección que determina si la entrada de lápiz, los gestos o la entrada de lápiz y los gestos se reconocen como escribe el usuario. |
| de propiedad cursores de | Obtiene la colección IInkCursors disponible para su uso en la región de entrada manuscrita del control InkPicture. |
| CustomStrokes | Obtiene la colección IInkCustomStrokes que se va a conservar con la entrada de lápiz (solo en tiempo de diseño). |
| propiedad DefaultDrawingAttributes | Obtiene o establece el predeterminado InkDrawingAttributes colección que se usará al dibujar y mostrar la entrada de lápiz (solo tiempo de ejecución). |
| propiedad DesiredPacketDescription | Obtiene o establece la descripción del paquete del control InkPicture (solo tiempo de ejecución). |
| dynamicRendering (propiedad) | Obtiene o establece el valor que especifica si el control InkPicture representa dinámicamente la entrada de lápiz a medida que se recopila. |
| EditingMode | Obtiene o establece un valor que especifica si el control InkPicture está en modo de lápiz, modo de eliminación o selección o modo de edición. |
| habilitado | Obtiene o establece un valor que determina si el control InkPicture puede responder a eventos generados por el usuario. Nota: Esta propiedad es equivalente a la propiedadInkEnabled. |
| EraserMode | Obtiene o establece el valor que especifica si la entrada de lápiz se borra por trazo o por punto. |
| eraserWidth de | Obtiene o establece el valor que especifica el ancho de la punta del lápiz del borrador. |
| hWnd | Obtiene el identificador de ventana al que está enlazado el control InkPicture. (solo tiempo de ejecución) |
| ink | Obtiene o establece el objeto InkDisp asociado al control InkPicture (solo tiempo de ejecución). |
| InkEnabled | Obtiene o establece un valor que especifica si el control InkPicture recopila entradas de lápiz (paquetes en aire, cursor en eventos de intervalo, etc.). |
| de la propiedad MarginX de | Obtiene o establece el margen del eje X alrededor del rectángulo de ventana en coordenadas de pantalla. |
| de la propiedad MarginY de | Obtiene o establece el margen del eje Y alrededor del rectángulo de ventana en coordenadas de pantalla. |
| propiedad MouseIcon | Obtiene o establece el icono del mouse personalizado actual. |
| propiedad MousePointer | Obtiene o establece un valor que indica el tipo de puntero del mouse que aparece cuando el mouse está sobre una parte determinada del control InkPicture. |
| imagen | Obtiene el archivo de gráficos que se va a mostrar en el control InkPicture. |
| de la propiedad Renderer | Obtiene o establece el objeto InkRenderer que se usa para dibujar la entrada de lápiz en el control InkPicture (solo tiempo de ejecución). |
| selección | Obtiene la colección InkStrokes seleccionada actualmente dentro del control InkPicture (solo tiempo de ejecución). |
| SizeMode | Obtiene o establece cómo el control controla la colocación y el ajuste de tamaño de la imagen. |
| de la propiedad SupportHighContrastInk de | Obtiene un valor que especifica si la entrada de lápiz se representa como un solo color, Color = COLOR_WINDOWTEXT (desde la llamada a GetSystemMetrics) cuando el sistema está en modo contraste alto. |
| supportHighContrastSelectionUI | Obtiene o establece un valor que especifica si todas las interfaces de usuario de selección (cuadro de selección de selección y identificadores de selección) se dibujan en contraste alto cuando el sistema está en modo contraste alto. |
| de propiedad Tablet | Obtiene el objeto IInkTablet que el control InkPicture está usando actualmente para recopilar la entrada. |
Observaciones
La interfaz de usuario en tiempo de ejecución del control InkPicture es una ventana con un fondo opaco (color único, fondo de imagen o ambos) que contiene tinta opaca.
Puedes usar el control InkPicture para representar la entrada de lápiz en Microsoft Windows 2000, Windows Server 2003, cualquier edición de Windows XP que no sea Windows XP Tablet PC Edition y cualquier versión de Windows Vista. Sin embargo, puede introducir entrada de lápiz, aceptar gestos o reconocer la escritura a mano solo en las condiciones siguientes:
- La entrada de lápiz se puede introducir y reconocer si windows Vista o XP Tablet PC Edition 2005 está instalado.
- También se pueden reconocer gestos.
- La escritura a mano se puede reconocer como texto si la escritura a mano se originó en máquinas que ejecutan versiones anteriores de Windows siempre que haya reconocedores presentes.
Si usas Windows 2000, Windows Server 2003, cualquier edición de Windows XP distinta de Windows XP Tablet PC Edition 2005, puedes asignar valores a las propiedades ambientales del control InkPicture y, a continuación, copiar y pegar entrada de lápiz en otras aplicaciones. Sin embargo, el valor de su propiedad InkEnabled siempre será FALSE.
Se pueden cargar y mostrar objetos InkDisp en todas las ediciones de Windows Vista y XP y en sistemas que solo tienen instalado el Kit de desarrollo de software (SDK) de Windows XP Tablet PC Edition. objetos InkDisp solo se pueden convertir en texto (reconocido), si Windows Vista o Windows XP Tablet PC Edition 2005 está instalado.
Si las operaciones de este control no se realizan correctamente, se devuelve un VALOR HRESULT legal. Si se produce el resultado de las condiciones de error, compruebe el VALOR HRESULT devuelto en el error.
Para obtener más información sobre los controles de entrada de lápiz, vea Ink.
Para obtener información sobre qué subprocesos generan eventos concretos, vea Subprocesos en los que un evento puede desencadenar.
Para mejorar el rendimiento de la aplicación, elimine manualmente un control InkPicture cuando ya no sea necesario.
Nota
Cuando se superpone un control InkPicture con otro control, como un GroupBox establecido en transparente, InkPicture no recopilará la entrada de lápiz. InkPicture debe ser el control superior en el orden Z o debe ser un elemento secundario del GroupBox.
Implementación de COM
Este objeto implementa la interfaz COM de IInkPicture.