InkOverlay (classe)

Rappresenta un oggetto utile per gli scenari di annotazione in cui gli utenti non sono interessati a eseguire il riconoscimento sull'input penna ma sono interessati alla dimensione, alla forma, al colore e alla posizione dell'input penna.

La creazione del controllo InkOverlay dietro un controllo trasparente, ad esempio un GroupBox con il _ set di proprietà WS ex _ trasparente, impedisce a InkOverlay di raccogliere input penna.

InkOverlay presenta questi tipi di membri:

Eventi

La classe InkOverlay presenta questi eventi.

Event Descrizione
CursorButtonDown Si verifica quando l'oggetto InkOverlay rileva un pulsante del cursore inattivo.
CursorButtonUp Si verifica quando l'oggetto InkOverlay rileva un pulsante del cursore che è attivo.
CursorDown Si verifica quando il suggerimento del cursore Contatta la superficie del Tablet di digitalizzazione.
CursorInRange Si verifica quando un cursore entra nell'intervallo di rilevamento fisico (prossimità) del contesto della tavoletta.
CursorOutOfRange Si verifica quando il cursore esce dall'intervallo di rilevamento fisico (prossimità) del contesto della tavoletta.
DoubleClick Si verifica quando si fa doppio clic sull'oggetto InkOverlay .
Movimento Si verifica quando viene riconosciuto un movimento 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 viene spostata la rotellina del mouse mentre l'oggetto InkOverlay dispone dello stato attivo.
NewInAirPackets Si verifica quando viene rilevato un pacchetto in aria, che si verifica quando un utente sposta una penna accanto al tablet e il cursore si trova all'interno della finestra dell'oggetto InkOverlay oppure l'utente sposta il mouse all'interno della finestra associata dell'oggetto InkOverlay .
NewPackets Si verifica quando l'oggetto InkOverlay riceve i pacchetti.
Dipinto Si verifica quando l'oggetto InkOverlay ha completato il ridisegno.
Disegno Si verifica prima che l'oggetto InkOverlay venga ridisegnato.
SelectionChanged Si verifica quando la selezione dell'input penna all'interno del controllo viene modificata, ad esempio tramite le modifiche all'interfaccia utente, le procedure taglia e incolla o la proprietà di selezione .
SelectionChanging Si verifica quando la selezione dell'input penna all'interno del controllo sta per essere modificata, ad esempio tramite le modifiche all'interfaccia utente, le procedure taglia e incolla o la proprietà di selezione .
SelectionMoved Si verifica quando la posizione della selezione corrente viene modificata, ad esempio tramite le modifiche all'interfaccia utente, le procedure taglia e incolla o la proprietà di selezione .
SelectionMoving Si verifica quando la posizione della selezione corrente sta per essere modificata, ad esempio tramite le modifiche all'interfaccia utente, le procedure taglia e incolla o la proprietà di selezione .
SelectionResized Si verifica quando la dimensione della selezione corrente viene modificata, ad esempio tramite le modifiche all'interfaccia utente, le procedure taglia e incolla o la proprietà di selezione .
SelectionResizing Si verifica quando la dimensione della selezione corrente sta per essere modificata, ad esempio tramite le modifiche all'interfaccia utente, le procedure taglia e incolla o la proprietà di selezione .
Stroke Si verifica quando l'utente completa il disegno di un nuovo tratto su un tablet.
StrokesDeleted Si verifica dopo l'eliminazione dei tratti dalla proprietà Ink .
StrokesDeleting Si verifica prima che i tratti vengano eliminati dalla proprietà Ink .
SystemGesture Si verifica quando viene riconosciuto un movimento del sistema.
TabletAdded Si verifica quando un IInkTablet viene aggiunto 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 presenta questi metodi.

Metodo Descrizione
Disegna Imposta un rettangolo in cui ricreare l'input penna nell'oggetto InkOverlay .
GetEventInterest Restituisce lo stato corrente di un determinato evento dell'oggetto InkOverlay , ovvero se l'evento viene ascoltato o utilizzato.
GetGestureStatus Restituisce un valore che indica se l'oggetto InkOverlay è interessato a un movimento particolare.
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 PC.
SetEventInterest Imposta un valore che indica se è necessario ascoltare o utilizzare un evento specifico.
SetGestureStatus Imposta l'interesse dell'oggetto InkOverlay in un movimento noto.
SetSingleTabletIntegratedMode Questa modalità consente all'oggetto InkOverlay di raccogliere l'input penna da un solo tablet. L'input penna da altre tavolette viene ignorato dall'oggetto InkOverlay .
SetWindowInputRectangle Imposta il rettangolo della finestra, in pixel, da utilizzare per eseguire il mapping dell'input penna alla finestra.

Proprietà

La classe InkOverlay dispone di queste proprietà.

Proprietà Tipo di accesso Descrizione
AttachMode
Lettura/Scrittura
Ottiene o imposta il valore che specifica se l'oggetto InkOverlay è associato dietro o davanti alla finestra nota.
AutoRedraw
Lettura/Scrittura
Ottiene o imposta un valore che specifica se l'oggetto InkOverlay ridisegna l'input penna quando la finestra viene invalidata.
CollectingInk
Sola lettura
Ottiene un valore che specifica se l'input penna è attualmente in fase di disegno su un oggetto InkOverlay .
CollectionMode
Lettura/Scrittura
Ottiene o imposta la modalità di raccolta che determina se l'input penna, i movimenti o entrambi sono riconosciuti durante la scrittura dell'utente.
Cursori
Sola lettura
Ottiene l'insieme di cursori che è possibile utilizzare nell'area Inking.
DefaultDrawingAttributes
Lettura/Scrittura
Ottiene o imposta l'oggetto InkDrawingAttributes predefinito, che specifica gli attributi di disegno utilizzati durante il disegno e la visualizzazione dell'input penna.
DesiredPacketDescription
Lettura/Scrittura
Ottiene o imposta un interesse per gli aspetti del pacchetto associato all'input penna disegnato sull'oggetto InkOverlay .
DynamicRendering
Lettura/Scrittura
Ottiene o imposta un valore che indica se viene eseguito il rendering dell'input penna quando viene disegnato.
EditingMode
Lettura/Scrittura
Ottiene o imposta un valore che indica se l'oggetto InkOverlay è in modalità input penna, modalità di eliminazione o modalità di selezione o modifica.
Abilitato
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 è stato cancellato dal tratto o dal punto.
EraserWidth
Lettura/Scrittura
Ottiene o imposta un valore che specifica la larghezza della descrizione della penna della gomma.
Handle
Lettura/Scrittura
Ottiene o imposta l'handle della finestra a cui è associato 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 particolare parte dell'oggetto.
Renderer
Lettura/Scrittura
Ottiene o imposta l'oggetto InkRenderer utilizzato per creare input penna.
Selezione
Lettura/Scrittura
Ottiene o imposta la raccolta InkStrokes attualmente selezionata all'interno del controllo InkOverlay .
SupportHighContrastInk
Lettura/Scrittura
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.
SupportHighContrastSelectionUI
Lettura/Scrittura
Ottiene o imposta un valore che specifica se l'interfaccia utente di selezione viene disegnata in un contrasto elevato quando il sistema è in modalità Contrasto elevato.
Tablet
Sola lettura
Ottiene la tavoletta utilizzata attualmente dall'oggetto InkOverlay per raccogliere l'input.

Note sull'implementazione MFC

Se l'oggetto InkOverlay è stato collegato a un oggetto CView, rilasciare l'oggetto InkOverlay in risposta al _ messaggio 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

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

L'oggetto InkOverlay è particolarmente adatto per l'acquisizione di note e per la creazione di un scarabocchio di base. L'utilizzo previsto principale di questo oggetto consiste nel visualizzare input penna come input penna.

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

Gli eventi MouseDown, MouseMove, MouseUpe MouseWheel restituiscono coordinate x e y in pixel e non le unità HIMETRIC associate allo spazio di input penna. Questo è dovuto al fatto che questi eventi sostituiscono gli eventi del mouse per le applicazioni non compatibili con la penna e queste applicazioni comprendono solo i pixel.

Attenzione

Se si imposta la proprietà AttachMode dell'oggetto InkOverlay su Infront, creare l'oggetto InkOverlay nel thread in cui è in esecuzione il form. L'applicazione potrebbe smettere di rispondere se l'oggetto InkOverlay viene creato in un thread diverso e la relativa proprietà AttachMode è impostata su Infront.

Nota

Non è possibile rilasciare in modo sicuro l'oggetto InkOverlay in un thread non dell'interfaccia utente.

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

Se l'oggetto InkOverlay è stato collegato a un oggetto CView, rilasciare l'oggetto InkOverlay in risposta al _ messaggio 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
Solo app desktop Windows XP Tablet PC Edition []
Server minimo supportato
Nessuno supportato
Intestazione
Msinkaut. h (richiede anche Msinkaut _ i. c)
Libreria
InkObj.dll

Vedi anche

Classe InkCollector

Riferimento al controllo InkPicture

Riferimento al controllo InkEdit