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 |
|
| Libreria |
|