Referencia del control InkPicture
El control InkPicture proporciona la capacidad de colocar una imagen en una aplicación y permitir que los usuarios agreguen 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.
Se puede crear una instancia del control InkPicture 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 | En desuso. |
| Haga clic | Se produce cuando un usuario hace clic en el control InkPicture. |
| CursorButtonDown (evento) | Se produce cuando el control InkCollector detecta un objeto IInkCursorButton que está inactivo. |
| CursorButtonUp (evento) | Se produce cuando el control InkPicture detecta un IInkCursorButton que está arriba. |
| CursorDown (evento) | Se produce cuando la punta del cursor se pone en contacto con la superficie de la tableta digitalizada. |
| CursorInRange (evento) | Se produce cuando un cursor entra en el intervalo de detección físico (proximidad) del contexto de la tableta. |
| CursorOutOfRange (evento) | Se produce cuando el cursor sale del 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. |
| Evento de gesto | Se produce cuando se reconoce un gesto de aplicación. |
| Evento KeyDown [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 [Control InkPicture] | Se produce cuando se libera 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 sale del 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. |
| NewInAirPackets (evento) | Se produce cuando se ve un paquete en el aire. |
| NewPackets (evento) | Se produce cuando el control InkPicture recibe un paquete. |
| Pintado | Se produce cuando el control InkPicture se ha completado para volver a dibujarse. |
| Representación | Se produce antes de que el control InkPicture se vuelva a dibujar. |
| Cambiar de 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 cortar y pegar 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 cortar y pegar o la propiedad Selection . |
| SelectionMoved | Se produce cuando la posición de la selección actual ha cambiado, por ejemplo, mediante 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 cortar y pegar o la propiedad Selection . |
| SelectionResized | Se produce cuando el tamaño de la selección actual ha cambiado, por ejemplo, mediante modificaciones en la interfaz de usuario, procedimientos de corte y pegado o la propiedad Selection . |
| SelectionResizing | 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 cortar y pegar o la propiedad Selection . |
| SizeChanged | Se produce después de cambiar el tamaño del control InkPicture, específicamente, después de que cambie el valor de la propiedad Width o Height . |
| SizeModeChanged | Se produce después de cambiar la propiedad SizeMode del control InkPicture. |
| StyleChanged | Sin implementar. |
| Golpe | Se produce cuando el usuario dibuja un trazo nuevo en cualquier tableta. |
| StrokesDeleted | Se produce después de eliminar objetos IInkStrokeDisp de la propiedad Ink . |
| StrokesDeleting | Se produce antes de que los objetos IInkStrokeDisp se eliminen de la propiedad Ink . |
| SystemColorsChanged | Se produce después de que cambien los colores del sistema. |
| SystemGesture | Se produce cuando se reconoce un gesto del sistema. |
| Evento TabletAdded | Se produce cuando se agrega una tableta al sistema. |
| TabletRemoved (evento) | Se produce cuando se quita una tableta del sistema. |
| Método | Descripción |
|---|---|
| GetEventInterest (método) | 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. |
| GetWindowInputRectangle (método) | 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 enumeración SelectionHitResult , que especifica qué parte de una selección, si existe, se ha alcanzado durante una prueba de posicionamiento. |
| SetAllTabletsMode (método) | Permite que el control InkPicture recopile tinta de cualquier tableta conectada al pc tablet. |
| SetEventInterest (método) | Establece un valor que indica si un control InkPicture tiene interés en un evento especificado. |
| SetFocus | Mueve el foco al control InkPicture. |
| SetGestureStatus (método) | Establece el interés del objeto InkPicture en un gesto de aplicación especificado. |
| SetSingleTabletIntegratedMode (método) | 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. |
| SetWindowInputRectangle (método) | Especifica el rectángulo de ventana que se va a establecer, en coordenadas de ventana, dentro del cual se dibuja la entrada de lápiz. |
| ShowWhatsThisThis | Muestra un tema seleccionado en un archivo de Ayuda mediante el menú 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 |
|---|---|
| AutoRedraw (propiedad) | Obtiene o establece un valor que especifica si el control InkPicture vuelve a pintar 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. |
| CollectingInk (propiedad) | Obtiene el valor que especifica si el control InkPicture está recopilando entrada de lápiz (solo en tiempo de ejecución). |
| CollectionMode | 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. |
| Cursors (propiedad) | 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 tinta (solo en tiempo de diseño). |
| DefaultDrawingAttributes (propiedad) | Obtiene o establece la colección InkDrawingAttributes predeterminada que se usará al dibujar y mostrar la entrada de lápiz (solo en tiempo de ejecución). |
| DesiredPacketDescription (propiedad) | Obtiene o establece la descripción del paquete del control InkPicture (solo en 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 entrada de lápiz, en modo de eliminación o en modo de selección o 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 propiedad InkEnabled . |
| EraserMode | Obtiene o establece el valor que especifica si la entrada de lápiz se borra por trazo o por punto. |
| EraserWidth | 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 en tiempo de ejecución) |
| Entrada de lápiz | Obtiene o establece el objeto InkDisp asociado al control InkPicture (solo en tiempo de ejecución). |
| InkEnabled | Obtiene o establece un valor que especifica si el control InkPicture recopila la entrada del lápiz (paquetes en aire, cursor en eventos de intervalo, etc.). |
| MarginX (propiedad) | Obtiene o establece el margen del eje X alrededor del rectángulo de ventana en coordenadas de pantalla. |
| MarginY (propiedad) | Obtiene o establece el margen del eje Y alrededor del rectángulo de ventana en coordenadas de pantalla. |
| MouseIcon (propiedad) | Obtiene o establece el icono del mouse personalizado actual. |
| MousePointer (propiedad) | 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. |
| Renderer (propiedad) | Obtiene o establece el objeto InkRenderer que se usa para dibujar la entrada de lápiz en el control InkPicture (solo en tiempo de ejecución). |
| Número de selección | Obtiene la colección InkStrokes seleccionada actualmente dentro del control InkPicture (solo en tiempo de ejecución). |
| SizeMode | Obtiene o establece cómo el control controla la colocación y el tamaño de la imagen. |
| SupportHighContrastInk (propiedad) | 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 de contraste alto. |
| SupportHighContrastSelectionUI | Obtiene o establece un valor que especifica si todas las interfaces de usuario de selección (cuadro de límite de selección y identificadores de selección) se dibujan en contraste alto cuando el sistema está en modo de contraste alto. |
| Tablet (propiedad) | Obtiene el objeto IInkTablet que el control InkPicture usa actualmente para recopilar la entrada. |
Comentarios
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 entradas manuscritas, aceptar gestos o reconocer 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 las máquinas que ejecutan versiones anteriores de Windows siempre que haya reconocedores presentes.
Si usa Windows 2000, Windows Server 2003, cualquier edición de Windows XP que no sea Windows XP Tablet PC Edition 2005, puede asignar valores a las propiedades ambientales del control InkPicture y, a continuación, copiar y pegar tinta en otras aplicaciones. Sin embargo, el valor de su propiedad InkEnabled siempre será FALSE.
Los objetos InkDisp persistentes se pueden cargar y mostrar en todas las ediciones de Windows Vista y XP y en sistemas que solo tienen instalado el Kit de desarrollo de software (SDK) windows XP Tablet PC Edition. Los objetos InkDisp solo se pueden convertir en texto (reconocido), si Windows Vista o Windows XP Tablet PC Edition 2005 están instalados.
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 se puede desencadenar un evento.
Para mejorar el rendimiento de la aplicación, elimine manualmente un control InkPicture cuando ya no sea necesario.
Nota
Cuando un control InkPicture se superpone 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 de GroupBox.
Implementación de COM
Este objeto implementa la interfaz COM de IInkPicture .