Classe InkDisp

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

InkDisp include questi tipi di membri:

• Eventi
• Interfacce
• Metodi
• Proprietà

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