Clase InkDisp
Representa los trazos recopilados de la entrada de lápiz dentro de un espacio de entrada de lápiz.
InkDisp tiene estos tipos de miembros:
Eventos
La clase InkDisp tiene estos eventos.
| Evento | Descripción |
|---|---|
| InkAdded | Se produce cuando se agrega un trazo al objeto InkDisp . |
| InkDeleted | Se produce cuando se elimina un trazo del objeto InkDisp . |
Interfaces
La clase InkDisp define estas interfaces.
| Interfaz | Descripción |
|---|---|
| IInkDisp | Este objeto implementa la interfaz COM de IInkDisp . |
Métodos
La clase InkDisp tiene estos métodos.
| Método | Descripción |
|---|---|
| AddStrokesAtRectangle | Inserta una colección de trazos en el objeto InkDisp en el rectángulo especificado. |
| CanPaste | Indica si el objeto IDataObject se puede convertir en un objeto InkDisp . |
| Clip | Quita partes de un trazo o colección de trazos que están fuera de un rectángulo. |
| ClipboardCopy | Copia la colección InkStrokes en el Portapapeles. |
| ClipboardCopyWithRectangle | Copia los objetos IInkStrokeDisp contenidos en el rectángulo conocido en el Portapapeles. |
| PortapapelesPaste | Copia el IDataObject del Portapapeles en el objeto InkDisp . |
| Clon | Crea un objeto InkDisp duplicado. |
| CreateStroke | Crea un trazo a partir de puntos o datos de paquetes. |
| CreateStrokes | Crea una colección InkStrokes para este objeto InkDisp . |
| DeleteStroke | Elimina un trazo del objeto InkDisp . |
| DeleteStrokes | Elimina trazos del objeto InkDisp . |
| ExtractStrokes (método) | Extrae trazos del objeto InkDisp y devuelve un nuevo objeto InkDisp que contiene los trazos extraídos. |
| ExtractWithRectangle (método) | Corta o copia trazos de un objeto InkDisp Class existente y los pega en un nuevo objeto InkDisp Class , mediante el rectángulo conocido para determinar qué trazos se van a extraer. |
| GetBoundingBox | Recupera el cuadro de límite de todos los trazos del objeto InkDisp . |
| HitTestCircle | Recupera la colección InkStrokes que está completamente dentro o intersecada por un círculo conocido. |
| HitTestWithLasso | Recupera los trazos dentro de un área de selección de polilínea. |
| HitTestWithRectangle | Recupera los trazos contenidos en un rectángulo especificado. |
| Carga | Rellena un nuevo objeto InkDisp con datos binarios conocidos. |
| NearestPoint | Recupera el IInkStrokeDisp dentro del objeto InkDisp más cercano a un punto conocido, proporcionando opcionalmente información adicional. |
| Guardar | Convierte la entrada de lápiz en un formato especificado y devuelve los datos binarios. |
Propiedades
La clase InkDisp tiene estas propiedades.
| Propiedad | Tipo de acceso | Descripción |
|---|---|---|
|
CustomStrokes |
Solo lectura |
Obtiene la colección IInkCustomStrokes que se va a conservar con la entrada de lápiz. |
|
Sucio |
Lectura/escritura |
Obtiene o establece el valor que indica si se ha modificado un objeto InkDisp desde la última vez que se guardó la entrada de lápiz. |
|
ExtendedProperties |
Solo lectura |
Obtiene la colección de datos definidos por la aplicación. |
|
Trazos |
Solo lectura |
Obtiene la colección InkStrokes contenida en el objeto InkDisp . |
Comentarios
Este objeto se puede crear una instancia llamando al método CoCreateInstance en C++.
Nota
La primera instancia de este objeto hace que también se cree una instancia de GDI+. Un efecto secundario es que si usa un solo objeto de entrada de lápiz en un bucle y lo crea y destruye dentro del bucle, hará que se cree una instancia de GDI+ sobre y más. Esto puede provocar una degradación del rendimiento en la aplicación. Para evitar esto, mantenga una única instancia de un objeto de entrada de lápiz en todo momento mientras la aplicación usa la entrada de lápiz.
Un objeto InkDisp es un contenedor de datos de trazo (punto). Los datos de trazo, o los puntos recopilados por el lápiz, se colocan en un objeto InkDisp . La propiedad Strokes contiene los datos de todos los trazos dentro del objeto InkDisp .
El objeto InkCollector , el objeto InkOverlay y el control InkPicture recopilan puntos del dispositivo de entrada y los colocan en un objeto InkDisp . Estos objetos actúan básicamente como el origen que distribuye la entrada de lápiz en uno o muchos objetos InkDisp diferentes, que actúan como contenedores que contienen la entrada de lápiz distribuida.
El espacio de tinta es un espacio de coordenadas virtual al que se asignan las coordenadas del contexto de la tableta. Este espacio se fija en un sistema de coordenadas HIMETRIC. En las coordenadas de espacio de entrada de lápiz, un movimiento de 0 a 1 es igual a 1 unidad HIMETRIC. Esta asignación facilita la relación de varios objetos InkDisp .
El objeto InkRenderer administra las asignaciones entre la entrada de lápiz y la ventana de presentación.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows XP Tablet PC Edition [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
No se admite ninguno |
| Encabezado |
|
| Biblioteca |
|