Classe InkOverlay

Articolo
06/13/2023

Rappresenta un oggetto utile per gli scenari di annotazione in cui gli utenti non sono interessati all'esecuzione del riconoscimento sull'input penna, ma sono interessati alle dimensioni, alla forma, al colore e alla posizione dell'input penna.

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

InkOverlay include questi tipi di membri:

Eventi
Interfacce
Metodi
Proprietà

Eventi

La classe InkOverlay include questi eventi.

Event	Descrizione
CursorButtonDown	Si verifica quando InkOverlay rileva un pulsante di cursore inattivo.
CursorButtonUp	Si verifica quando InkOverlay 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 InkOverlay 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 InkOverlay e viene premuto un pulsante del mouse.
Mousemove	Si verifica quando il puntatore del mouse viene spostato sull'oggetto InkOverlay .
Mouseup	Si verifica quando il puntatore del mouse si trova sull'oggetto InkOverlay e viene rilasciato un pulsante del mouse.
Mousewheel	Si verifica quando la rotellina del mouse si sposta mentre l'oggetto InkOverlay 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 InkOverlay o l'utente sposta un mouse all'interno della finestra associata dell'oggetto InkOverlay .
NewPackets	Si verifica quando l'oggetto InkOverlay riceve pacchetti.
Dipinto	Si verifica quando l'oggetto InkOverlay ha completato il ridisegno stesso.
Pittura	Si verifica prima che l'oggetto InkOverlay si ridisegni.
SelectionChanged	Si verifica quando la selezione dell'input penna all'interno del controllo è stata modificata, ad esempio tramite modifiche all'interfaccia utente, alle procedure taglia e incolla o alla proprietà Selection .
Selectionchanging	Si verifica quando la selezione dell'input penna all'interno del controllo sta per modificare, ad esempio tramite modifiche all'interfaccia utente, le procedure taglia e incolla o la proprietà Selection .
Selezione spostata	Si verifica quando la posizione della selezione corrente è stata modificata, ad esempio tramite modifiche all'interfaccia utente, alle procedure taglia e incolla o alla proprietà Selection .
SelectionMoving	Si verifica quando la posizione della selezione corrente sta per cambiare, ad esempio tramite modifiche all'interfaccia utente, le procedure taglia e incolla o la proprietà Selection .
SelectionResized	Si verifica quando le dimensioni della selezione corrente sono state modificate, ad esempio tramite modifiche all'interfaccia utente, alle procedure taglia e incolla o alla proprietà Selection .
Selectionresizing	Si verifica quando la dimensione della selezione corrente sta per cambiare, ad esempio tramite modifiche all'interfaccia utente, le procedure taglia e incolla o la proprietà Selection .
Infarto	Si verifica al termine del disegno di un nuovo tratto su qualsiasi tablet.
StrokesDeleted	Si verifica dopo l'eliminazione dei tratti dalla proprietà Input penna .
StrokesDeleting	Si verifica prima che i tratti vengano eliminati dalla proprietà Input penna .
SystemGesture	Si verifica quando viene riconosciuto un movimento di sistema.
TabletAdded	Si verifica quando viene aggiunto un oggetto IInkTablet al sistema.
TabletRemoved	Si verifica quando un tablet viene rimosso dal sistema.

Interfacce

La classe InkOverlay definisce queste interfacce.

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

Metodi

La classe InkOverlay include questi metodi.

Metodo	Descrizione
Disegna	Imposta un rettangolo in cui ridisegnare l'input penna all'interno dell'oggetto InkOverlay .
GetEventInterest	Restituisce lo stato corrente di un determinato evento oggetto InkOverlay , ovvero se l'evento viene ascoltato o usato.
GetGestureStatus	Restituisce se l'oggetto InkOverlay è interessato a un determinato movimento.
GetWindowInputRectangle	Recupera il rettangolo della finestra, in pixel, all'interno del quale viene disegnato l'input penna.
HitTestSelection	Determina quale parte della selezione è stata raggiunta durante un hit test.
SetAllTabletsMode	Questa modalità consente all'oggetto InkOverlay di raccogliere input penna da qualsiasi tablet collegato al TABLET.
SetEventInterest	Imposta se un evento specifico deve essere in ascolto o usato.
SetGestureStatus	Imposta l'interesse dell'oggetto InkOverlay in un gesto noto.
SetSingleTabletIntegratedMode	Questa modalità consente all'oggetto InkOverlay di raccogliere input penna da un solo tablet. L'input penna da altri tablet viene ignorato dall'oggetto InkOverlay .
SetWindowInputRectangle	Imposta il rettangolo della finestra, in pixel, da usare per eseguire il mapping dell'input penna disegnato alla finestra.

Proprietà

La classe InkOverlay ha queste proprietà.

Proprietà	Tipo di accesso	Descrizione
AttachMode	Lettura/Scrittura	Ottiene o imposta il valore che specifica se l'oggetto InkOverlay è collegato dietro o davanti alla finestra nota.
AutoRedraw	Lettura/Scrittura	Ottiene o imposta un valore che specifica se inkOverlay esegue il repository 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 InkOverlay .
CollectionMode	Lettura/Scrittura	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	Lettura/Scrittura	Ottiene o imposta l'oggetto InkDrawingAttributes predefinito, che specifica gli attributi di disegno usati durante il disegno e la visualizzazione dell'input penna.
DesiredPacketDescription	Lettura/Scrittura	Ottiene o imposta l'interesse sugli aspetti del pacchetto associato all'input penna disegnato nell'oggetto InkOverlay .
DynamicRendering	Lettura/Scrittura	Ottiene o imposta un valore che indica se viene eseguito il rendering dell'input penna come viene disegnato.
ModificaMode	Lettura/Scrittura	Ottiene o imposta un valore che indica se InkOverlay è in modalità input penna, modalità di eliminazione o selezione/modifica della modalità.
Attivato	Lettura/Scrittura	Ottiene o imposta un valore che specifica se l'oggetto InkOverlay raccoglie l'input penna.
EraserMode	Lettura/Scrittura	Ottiene o imposta un valore che indica se l'input penna viene cancellato per tratto o in base al punto.
EraserWidth	Lettura/Scrittura	Ottiene o imposta un valore che specifica la larghezza della punta della penna di cancellazione.
Handle	Lettura/Scrittura	Ottiene o imposta l'handle della finestra a cui è collegato l'oggetto InkOverlay .
Input penna	Lettura/Scrittura	Ottiene o imposta l'oggetto InkDisp associato all'oggetto InkOverlay .
MarginX	Lettura/Scrittura	Ottiene o imposta i margini lungo l'asse x, in pixel.
MarginY	Lettura/Scrittura	Ottiene o imposta i margini lungo l'asse y, in pixel.
MouseIcon	Lettura/Scrittura	Ottiene o imposta l'icona del mouse personalizzata corrente.
Mousepointer	Lettura/Scrittura	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	Lettura/Scrittura	Ottiene o imposta l'oggetto InkRenderer utilizzato per disegnare l'input penna.
Selezione	Lettura/Scrittura	Ottiene o imposta l'insieme InkStrokes attualmente selezionato all'interno del controllo InkOverlay .
SupportHighContrastInk	Lettura/Scrittura	Ottiene o imposta un valore che specifica se l'input penna viene eseguito come un solo colore quando il sistema è in modalità a contrasto elevato.
SupportHighContrastSelectionUI	Lettura/Scrittura	Ottiene o imposta un valore che specifica se l'interfaccia utente di selezione viene disegnata in contrasto elevato quando il sistema è in modalità a contrasto elevato.
Tablet	Sola lettura	Ottiene il dispositivo tablet che l'oggetto InkOverlay sta attualmente usando per raccogliere l'input.

Note sull'implementazione MFC

Se è stato collegato l'oggetto InkOverlay a un oggetto CView, rilasciare l'oggetto InkOverlay in risposta al messaggio di WM_DESTROY, come illustrato nell'esempio seguente:

BOOL CRecognitionAlternatesSampleCppView::OnWndMsg(UINT msg, WPARAM wp, PARAM lp, LRESULT *pLR)
{
    if(WM_DESTROY == msg)
        m_spInkOverlay.Release();
    return CView::OnWndMsg(msg, wp, lp, pLR);
}

Commenti

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

L'oggetto InkOverlay è adatto per prendere nota e scricchiolare di base. L'uso principale di questo oggetto consiste nel visualizzare l'input penna come input penna.

In generale, l'interfaccia utente di runtime per questo oggetto è una finestra trasparente con input penna opaco.

Gli eventi MouseDown, MouseMove, MouseUp e MouseWheel restituiscono coordinate x e coordinate y in pixel e non le unità HIMETRIC associate allo spazio penna. Ciò avviee perché questi eventi sostituiscono gli eventi del mouse delle applicazioni pen-inconsapevoli e queste applicazioni comprendono solo pixel.

Attenzione

Se si imposta la proprietà AttachMode dell'oggetto InkOverlay su InFront, creare l'oggetto InkOverlay nel thread in cui è in esecuzione il modulo. L'applicazione può interrompere la risposta se l'oggetto InkOverlay viene creato in un thread diverso e la relativa proprietà AttachMode è impostata su InFront.

Nota

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

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