Condividi tramite


Classe InkDisp

Rappresenta i tratti raccolti di input penna all'interno di uno spazio penna.

InkDisp include questi tipi di membri:

Eventi

La classe InkDisp include questi eventi.

Event Descrizione
Input pennaAggiungi Si verifica quando un tratto viene aggiunto all'oggetto InkDisp .
InkDeleted Si verifica quando un tratto viene eliminato dall'oggetto InkDisp .

Interfacce

La classe InkDisp definisce queste interfacce.

Interfaccia Descrizione
IInkDisp Questo oggetto implementa l'interfaccia COM IInkDisp .

Metodi

La classe InkDisp include questi metodi.

Metodo Descrizione
AddStrokesAtRectangle Inserisce un insieme di tratti nell'oggetto InkDisp nel rettangolo specificato.
CanPaste Indica se l'oggetto IDataObject può essere convertito in un oggetto InkDisp .
Clip Rimuove parti di un tratto o di una raccolta di tratti esterni a un rettangolo.
ClipboardCopy Copia l'insieme InkStrokes negli Appunti.
ClipboardCopyWithRectangle Copia gli oggetti IInkStrokeDisp contenuti all'interno del rettangolo noto negli Appunti.
AppuntiPaste Copia IDataObject dagli Appunti all'oggetto InkDisp .
Clone Crea un oggetto InkDisp duplicato.
CreateStroke Crea un tratto da punti o dati di pacchetto.
CreateStrokes Crea un insieme InkStrokes per questo oggetto InkDisp .
DeleteStroke Elimina un tratto dall'oggetto InkDisp .
DeleteStrokes Elimina i tratti dall'oggetto InkDisp .
Metodo ExtractStrokes Estrae i tratti dall'oggetto InkDisp e restituisce un nuovo oggetto InkDisp contenente i tratti estratti.
ExtractWithRectangle, metodo Taglia o copia i tratti da un oggetto Classe InkDisp esistente e li incolla in un nuovo oggetto Classe InkDisp usando il rettangolo noto per determinare quali tratti estrarre.
GetBoundingBox Recupera il rettangolo di selezione di tutti i tratti nell'oggetto InkDisp .
HitTestCircle Recupera l'insieme InkStrokes completamente all'interno o intersecato da un cerchio noto.
HitTestWithLasso Recupera i tratti all'interno di un'area di selezione polilinea.
HitTestWithRectangle Recupera i tratti contenuti all'interno di un rettangolo specificato.
Load Popola un nuovo oggetto InkDisp con dati binari noti.
Più vicino aPoint Recupera IInkStrokeDisp all'interno dell'oggetto InkDisp più vicino a un punto noto, facoltativamente fornendo informazioni aggiuntive.
Salva Converte l'input penna in un formato specificato e restituisce i dati binari.

Proprietà

La classe InkDisp ha queste proprietà.

Proprietà Tipo di accesso Descrizione
CustomStrokes
Sola lettura
Ottiene l'insieme IInkCustomStrokes da rendere persistente con l'input penna.
Sporco
Lettura/Scrittura
Ottiene o imposta il valore che indica se un oggetto InkDisp è stato modificato dall'ultima volta che è stato salvato l'input penna.
ExtendedProperties
Sola lettura
Ottiene la raccolta di dati definiti dall'applicazione.
Tratti
Sola lettura
Ottiene l'insieme InkStrokes contenuto nell'oggetto InkDisp .

Commenti

Questo oggetto può essere creato un'istanza chiamando il metodo CoCreateInstance in C++.

Nota

La prima istanza di questo oggetto causa anche l'istanza di GDI+. Un effetto collaterale è che se si usa un singolo oggetto penna in un ciclo e lo si elimina all'interno del ciclo, si causerà l'istanza di GDI+ su e oltre. Ciò può causare una riduzione delle prestazioni nell'applicazione. Per evitare questo problema, mantenere un'unica istanza di un oggetto input penna in ogni momento mentre l'applicazione usa l'input penna.

Un oggetto InkDisp è un contenitore di dati di tratto (punto). I dati del tratto o i punti raccolti dalla penna vengono inseriti in un oggetto InkDisp . La proprietà Strokes contiene i dati per tutti i tratti all'interno dell'oggetto InkDisp .

L'oggetto InkCollector , l'oggetto InkOverlay e il controllo InkPicture raccoglie i punti dal dispositivo di input e li inserisce in un oggetto InkDisp . Questi oggetti fungono essenzialmente dall'origine che distribuisce l'input penna in uno o più oggetti InkDisp diversi, che fungono da contenitori che contengono l'input penna distribuito.

Lo spazio penna è uno spazio di coordinate virtuale a cui vengono mappate le coordinate del contesto del tablet. Questo spazio è fisso a un sistema di coordinate HIMETRIC. Nelle coordinate dello spazio penna, uno spostamento da 0 a 1 uguale a 1 unità HIMETRIC. Questo mapping semplifica la correlazione di più oggetti InkDisp .

L'oggetto InkRenderer gestisce i mapping tra input penna e la finestra di visualizzazione.

Requisiti

Requisito Valore
Client minimo supportato
Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato
Nessuno supportato
Intestazione
Msinkaut.h (richiede anche Msinkaut_i.c)
Libreria
InkObj.dll

Vedi anche

Interfaccia IInkStrokeDisp

Insieme InkStrokes

Interfaccia IInkTablet