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
Msinkaut.h (también requiere Msinkaut_i.c)
Biblioteca
InkObj.dll

Consulte también

IInkStrokeDisp (Interfaz)

InkStrokes (colección)

IInkTablet (interfaz)