Condividi tramite


Classe InkOverlay

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

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.

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);
}

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

Classe InkCollector

Informazioni di riferimento sul controllo InkPicture

Informazioni di riferimento sul controllo InkEdit