Classe InkCollector

Rappresenta l'oggetto usato per acquisire input penna dai dispositivi tablet disponibili.

La creazione del controllo InkCollector dietro un controllo trasparente (ad esempio un oggetto GroupBox con il set di proprietà WS_EX_TRANSPARENT ) impedirà a InkCollector di raccogliere input penna.

InkCollector include questi tipi di membri:

Eventi

La classe InkCollector include questi eventi.

Event Descrizione
CursorButtonDown Si verifica quando InkCollector rileva un pulsante di cursore inattivo.
CursorButtonUp Si verifica quando InkCollector rileva un pulsante di cursore su.
CursorDown Si verifica quando la punta del cursore contatta la superficie del tablet di digitalizzazione.
Cursorinrange Si verifica quando un cursore entra nell'intervallo di rilevamento fisico (prossimità) del contesto del tablet.
CursorOutOfRange Si verifica quando il cursore lascia l'intervallo di rilevamento fisico (prossimità) del contesto del tablet.
Doubleclick Si verifica quando l'oggetto InkCollector viene fatto doppio clic.
Movimento Si verifica quando viene riconosciuto un gesto specifico dell'applicazione.
Mousedown Si verifica quando il puntatore del mouse si trova sull'oggetto InkCollector e viene premuto un pulsante del mouse.
Mousemove Si verifica quando il puntatore del mouse viene spostato sull'oggetto InkCollector .
Mouseup Si verifica quando il puntatore del mouse si trova sull'oggetto InkCollector e viene rilasciato un pulsante del mouse.
Mousewheel Si verifica quando la rotellina del mouse si sposta mentre l'oggetto InkCollector ha lo stato attivo.
NewInAirPackets Si verifica quando viene visualizzato un pacchetto in aria, che si verifica quando un utente sposta una penna vicino al tablet e il cursore si trova all'interno della finestra dell'oggetto InkCollector o l'utente sposta un mouse all'interno della finestra associata dell'oggetto oggetto InkCollector .
NewPackets Si verifica quando l'oggetto InkCollector riceve pacchetti.
Infarto Si verifica al termine del disegno di un nuovo tratto su qualsiasi tablet.
SystemGesture Si verifica quando viene riconosciuto un movimento di sistema.
TabletAdded Si verifica quando un tablet viene aggiunto al sistema.
TabletRemoved Si verifica quando un tablet viene rimosso dal sistema.

Interfacce

La classe InkCollector definisce queste interfacce.

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

Metodi

La classe InkCollector include questi metodi.

Metodo Descrizione
GetEventInterest Recupera lo stato corrente di un particolare evento oggetto InkCollector , ovvero se l'evento viene ascoltato o usato.
GetGestureStatus Recupera se l'oggetto InkCollector è interessato a un determinato movimento.
GetWindowInputRectangle Recupera il rettangolo della finestra, in pixel, all'interno del quale viene disegnato l'input penna.
SetAllTabletsMode Questa modalità consente all'oggetto InkCollector di raccogliere input penna da qualsiasi tablet collegato al PC tablet.
SetEventInterest Modifica un valore che indica se un evento specifico deve essere in ascolto o usato.
SetGestureStatus Modifica l'interesse dell'oggetto InkCollector in un gesto noto.
SetSingleTabletIntegratedMode Questa modalità consente all'oggetto InkCollector di raccogliere input penna da un solo tablet. L'input penna da altri tablet viene ignorato dall'oggetto InkCollector .
SetWindowInputRectangle Modifica il rettangolo della finestra, in pixel, da usare per eseguire il mapping dell'input penna disegnato alla finestra.

Proprietà

La classe InkCollector ha queste proprietà.

Proprietà Tipo di accesso Descrizione
AutoRedraw
Sola lettura
Ottiene o imposta un valore che specifica se inkCollector esegue il repaint dell'input penna quando la finestra non è valida.
RaccoltaInk
Sola lettura
Ottiene un valore che specifica se l'input penna è attualmente in fase di disegno in un oggetto InkCollector .
CollectionMode
Sola lettura
Ottiene o imposta la modalità raccolta che determina se l'input penna, i movimenti o entrambi vengono riconosciuti come scrive l'utente.
Cursori
Sola lettura
Ottiene l'insieme Cursors disponibile per l'uso nell'area di input penna.
DefaultDrawingAttributes
Sola lettura
Ottiene o imposta l'oggetto InkDrawingAttributes predefinito, che specifica gli attributi di disegno usati durante il disegno e la visualizzazione dell'input penna.
DesiredPacketDescription
Sola lettura
Ottiene o imposta l'interesse sugli aspetti del pacchetto associato all'input penna disegnato nell'oggetto InkCollector .
DynamicRendering
Sola lettura
Ottiene o imposta un valore che indica se viene eseguito il rendering dell'input penna mentre viene disegnato.
Attivato
Sola lettura
Ottiene o imposta un valore che specifica se l'oggetto InkCollector raccoglie l'input penna.
Handle
Sola lettura
Ottiene o imposta l'handle della finestra a cui è associato l'oggetto InkCollector .
Input penna
Sola lettura
Ottiene o imposta l'oggetto InkDisp associato all'oggetto InkCollector .
MarginX
Sola lettura
Ottiene o imposta i margini lungo l'asse x, in pixel.
MarginY
Sola lettura
Ottiene o imposta i margini lungo l'asse y, in pixel.
MouseIcon
Sola lettura
Ottiene o imposta l'icona del mouse personalizzata corrente.
Mousepointer
Sola lettura
Ottiene o imposta un valore che indica il tipo di puntatore del mouse visualizzato quando il mouse si trova su una determinata parte dell'oggetto.
Renderer
Sola lettura
Ottiene o imposta l'oggetto InkRenderer utilizzato per disegnare l'input penna.
SupportHighContrastInk
Sola lettura
Ottiene o imposta un valore che specifica se viene eseguito il rendering dell'input penna come un solo colore quando il sistema è in modalità contrasto elevato.
Tablet
Sola lettura
Ottiene il dispositivo tablet attualmente utilizzato dall'oggetto InkCollector per raccogliere l'input.

Commenti

È possibile creare un'istanza di questo oggetto chiamando il metodo CoCreateInstance in C++.

L'oggetto InkCollector raccoglie solo input penna e movimenti che vengono inseriti nella finestra specifica a cui è associata. L'unico scopo di InkCollector è raccogliere l'input penna dall'hardware (ad esempio tramite un oggetto IInkCursor e IInkTablet ) e recapitarlo a un'applicazione. Funge essenzialmente da origine che distribuisce l'input penna in uno o più oggetti InkDisp diversi, che fungono da contenitore che contengono l'input penna distribuito.

Per usare un InkCollector, crearlo, indicare in quale finestra raccogliere l'input penna disegnato e abilitarlo. Dopo l'abilitazione, può essere impostata per la raccolta in una sola delle tre modalità (la modalità è specificata nell'enumerazione InkCollectionMode ):

  • InkOnly, in cui viene creato un oggetto IInkStrokeDisp .
  • GestureOnly, in cui viene creato un oggetto IInkGesture .
  • InkAndGesture, in cui viene creato un tratto, un movimento o potenzialmente entrambi, a seconda del modo in cui l'applicazione gestisce gli eventi.

Ciò significa che, per ogni movimento di un cursore compreso nell'intervallo di un tablet, InkCollector raccoglie sempre un tratto o un gesto e talvolta entrambi. Il supporto dei movimenti è integrato usando il riconoscimento movimento Microsoft.

Un InkCollector gestisce tutti gli input del tablet. L'inchiostro può essere raccolto contemporaneamente da tutte le compresse collegate (incluso il mouse). Le modifiche apportate agli oggetti IInkCursor e IInkCursorButton possono causare l'attivazione di un evento da parte dell'oggetto InkCollector .

Un InkCollector gestisce anche l'elenco di cursori che incontra durante la sua esistenza. Quando InkCollector rileva un nuovo cursore, l'evento CursorInRange viene generato con il parametro newCursor impostato su VARIANT_TRUE. Le applicazioni usano InkCollector per gestire i nuovi cursori.

È possibile associare più di un controllo InkCollector a un handle di finestra specifico, anche se le relative aree di raccolta, impostate nel costruttore o con il metodo SetWindowInputRectangle , si sovrappongono. Tuttavia, l'unico modo in cui questo scenario funziona è se ogni InkCollector chiama SetSingleTabletIntegratedMode e usa un tablet univoco. Questo comportamento semplifica l'archiviazione dell'input penna in un oggetto separato per ogni tablet.

Si verifica un errore se il rettangolo di input della finestra di un controllo InkCollectors abilitato (impostato con la proprietà Enabled ) sovrappone il rettangolo di input della finestra di un altro InkCollector abilitato.

Nota

La sovrapposizione può verificarsi senza un errore, purché solo uno dei rettangoli di input sia abilitato in qualsiasi momento noto.

Gli eventi MouseDown, MouseMove, MouseUp e MouseWheel restituiscono coordinate x e y in pixel e non le unità HIMETRIC associate allo spazio input penna. Questo perché questi eventi sostituiscono gli eventi del mouse di applicazioni non consapevoli della penna e queste applicazioni comprendono solo i pixel.

Nota

L'oggetto InkCollector non può essere rilasciato in modo sicuro in un thread non dell'interfaccia utente.

Per migliorare le prestazioni dell'applicazione, eliminare l'oggetto InkCollector quando non è più necessario.

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

Informazioni di riferimento sul controllo InkEdit

Classe InkDisp

Classe InkOverlay

Informazioni di riferimento sul controllo InkPicture