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