Condividi tramite

Messaggi InkEdit (solo Win32)

  • Articolo

Il controllo InkEdit è una super classe del controllo RichEdit . Ogni messaggio RichEdit viene passato, direttamente nella maggior parte dei casi, e ha esattamente lo stesso effetto di RichEdit. Questo vale anche per i messaggi di notifica degli eventi.

Per inviare questi messaggi, chiamare la funzione SendMessage con i parametri seguenti:

C++ 
LRESULT SendMessage(  HWND hWnd,      // handle to destination window  UINT Msg,       // message  WPARAM wParam,  // first message parameter  LPARAM lParam   // second message parameter);

Message

La finestra padre del controllo InkEdit riceve messaggi di notifica degli eventi tramite il messaggio WM_NOTIFY:

LRESULT CALLBACK WindowProc(
    HWND hWnd,                // handle to window
    UINT uMsg,                // WM_NOTIFY
    WPARAM wParam,        // InkEdit control identifier
    LPARAM lParam            // see documentation for notification messages
);
Get/set message (Ottieni/imposta messaggio) Descrizione
EM_GETINKMODE
 Ottiene la modalità input penna del controllo InkEdit .
Parametri
Questo messaggio non ha parametri; wParam e lParam devono essere 0.
Valori restituiti:
Questo messaggio restituisce uno dei valori definiti nell'enumerazione InkMode , che specifica se l'insieme input penna è disabilitato, se viene raccolto l'input penna o se vengono raccolti input penna e movimenti.
EM_SETINKMODE
 Imposta la modalità input penna del controllo InkEdit .
Parametri
Wparam Specifica uno dei valori dell'enumerazione InkMode , che specifica se la raccolta input penna è disabilitata, se viene raccolto l'input penna o se vengono raccolti input penna e movimenti.
Lparam Questo parametro non viene usato; deve essere 0.
Valori restituiti:
Questo messaggio restituisce 0 se ha esito positivo o diverso da zero se si verifica un errore.
Osservazioni:
Questa operazione deve essere utilizzata solo se il EM_GETSTATUS restituisce IES_Idle.
EM_GETINKINSERTMODE
 Ottiene la modalità di inserimento dell'input penna del controllo InkEdit .
Parametri
Questo messaggio non ha parametri; wParam e lParam devono essere 0.
Valori restituiti:
Questo messaggio restituisce uno dei valori dell'enumerazione InkInsertMode , che specifica se l'input penna viene inserito nel controllo come testo o come input penna.
EM_SETINKINSERTMODE
 Imposta la modalità di inserimento dell'input penna del controllo InkEdit . L'invio di questo messaggio non ha alcun effetto se utilizzato con qualsiasi sistema operativo installato diverso da Microsoft Windows XP Tablet PC Edition.
Parametri
Wparam Specifica uno dei valori dell'enumerazione InkInsertMode , che specifica se l'input penna viene inserito nel controllo come testo o come input penna.
Lparam Questo parametro non viene usato; deve essere 0.
Valori restituiti:
Questo messaggio restituisce 0 se ha esito positivo o diverso da zero se si verifica un errore.
EM_GETDRAWATTR
 Ottiene gli attributi di disegno correnti del controllo InkEdit .
Parametri
Wparam Questo parametro non viene usato; deve essere 0.
Lparam Specifica un puntatore (IInkDrawingAttributes **pDrawAttr) per ricevere l'oggetto InkDrawingAttributes corrente.
Valori restituiti:
Questo messaggio restituisce 0 se ha esito positivo o diverso da zero se si verifica un errore.
EM_SETDRAWATTR
 Imposta gli attributi di disegno da utilizzare per una raccolta di input penna futura.
Parametri
Wparam Questo parametro non viene usato; deve essere 0.
Lparam Specifica un puntatore (IInkDrawingAttributes *pDrawAttr) a un oggetto InkDrawingAttributes .
Valori restituiti:
Questo messaggio restituisce 0 se ha esito positivo o diverso da zero se si verifica un errore.
EM_GETRECOTIMEOUT
 Ottiene il timeout di riconoscimento, espresso in millisecondi, per il controllo InkEdit .
Parametri
Questo messaggio non ha parametri; wParam e lParam devono essere 0.
Valori restituiti:
Questo messaggio restituisce il timeout di riconoscimento, espresso in millisecondi.
EM_SETRECOTIMEOUT
 Imposta il timeout di riconoscimento, espresso in millisecondi, per il controllo InkEdit .
Parametri
Wparam Specifica il timeout di riconoscimento, espresso in millisecondi.
Lparam Questo parametro non viene usato; deve essere 0.
Valori restituiti:
Questo messaggio restituisce 0 se ha esito positivo o diverso da zero se si verifica un errore.
EM_GETGESTURESTATUS
 Ottiene lo stato del movimento per il controllo InkEdit .
Parametri
Wparam Specifica il tipo di movimento, come definito nell'enumerazione InkApplicationGesture .
Lparam Questo parametro non viene usato; deve essere 0.
Valori restituiti:
Questo messaggio restituisce TRUE se il controllo InkEdit sottoscrive il movimento o FALSE se il controllo InkEdit non sottoscrive il movimento.
EM_SETGESTURESTATUS
 Imposta lo stato del movimento per il controllo InkEdit .
Parametri
Wparam Specifica il tipo di movimento, come definito nell'enumerazione InkApplicationGesture .
Lparam Specifica TRUE se la sottoscrizione al movimento è abilitata o FALSE se l'ascolto del movimento non è abilitato.
Valori restituiti:
Questo messaggio restituisce 0 se ha esito positivo o diverso da zero se si verifica un errore.
Osservazioni:
Questa operazione deve essere utilizzata solo se il EM_GETSTATUS restituisce IES_Idle.
EM_GETRECOGNIZER
 Ottiene il riconoscimento utilizzato dal controllo InkEdit .
Parametri
Wparam Questo parametro non viene usato; deve essere 0.
Lparam Specifica un puntatore a un oggetto IInkRecognizer* per ricevere l'oggetto IInkRecognizer utilizzato dal controllo InkEdit .
Valori restituiti:
Questo messaggio restituisce 0 se ha esito positivo o diverso da zero se si verifica un errore.
EM_SETRECOGNIZER
 Imposta il riconoscimento utilizzato dal controllo InkEdit . Se viene usato un Factoid per il controllo InkEdit, deve essere riapplicato dopo l'invio del messaggio.
Parametri
Wparam Questo parametro non viene usato; deve essere 0.
Lparam Specifica un puntatore a un oggetto IInkRecognizer* per impostare l'oggetto IInkRecognizer usato dal controllo InkEdit per un uso successivo.
Valori restituiti:
Questo messaggio restituisce 0 se ha esito positivo o diverso da zero se si verifica un errore.
Osservazioni:
Questa operazione deve essere usata solo se il EM_GETSTATUS restituisce IES_Idle.
EM_GETFACTOID
 Ottiene factoid da usare per il riconoscimento.
Parametri
Wparam Questo parametro non viene usato; deve essere 0.
Lparam Specifica un puntatore a un BSTR per ricevere la stringa factoid.
Valori restituiti:
Questo messaggio restituisce 0 se ha esito positivo o diverso da zero se si verifica un errore.
EM_SETFACTOID
 Imposta factoid da usare per il riconoscimento.
Parametri
Wparam Questo parametro non viene usato; deve essere 0.
Lparam Specifica la stringa BSTR contenente la stringa factoid.
Valori restituiti:
Questo messaggio restituisce 0 se ha esito positivo o diverso da zero se si verifica un errore.
Osservazioni:
Questa operazione deve essere usata solo se il EM_GETSTATUS restituisce IES_Idle.
EM_GETSELINK
 Ottiene l'input penna all'interno della selezione. L'input penna deve essere riconosciuto prima di essere accessibile tramite questo messaggio. Se non viene riconosciuto prima, EM_GETSELINK restituisce sempre zero oggetti InkDisp .
Parametri
Wparam Questo parametro non viene usato; deve essere 0.
Lparam Specifica un puntatore a un variant per ricevere una matrice sicura per ricevere oggetti InkDisp all'interno della selezione corrente.
Valori restituiti:
Questo messaggio restituisce 0 se ha esito positivo o diverso da zero se si verifica un errore.
EM_SETSELINK
 Imposta l'input penna all'interno della selezione. L'invio di questo messaggio non ha alcun effetto se usato con qualsiasi sistema operativo installato diverso da Windows XP Tablet PC Edition.
Parametri
Wparam Questo parametro non viene usato; deve essere 0.
Lparam Specifica un puntatore a un variant con una matrice sicura di oggetti InkDisp per sostituire la selezione corrente.
Valori restituiti:
Questo messaggio restituisce 0 se ha esito positivo o diverso da zero se si verifica un errore.
EM_GETSELINKDISPLAYMODE
 Restituisce l'aspetto corrente dell'input penna nell'intervallo selezionato usando uno dei valori dell'enumerazione InkDisplayMode .
Parametri
Questo messaggio non ha parametri; wParam e lParam devono essere 0.
Valori restituiti:
Questo messaggio restituisce uno dei valori dell'enumerazione InkDisplayMode (IDM_Text o IDM_Ink), che specifica come viene visualizzata una selezione nel controllo.
EM_SETSELINKDISPLAYMODE
 Imposta l'aspetto dell'input penna nell'intervallo selezionato usando uno dei valori dell'enumerazione InkDisplayMode .
Parametri
Wparam Questo parametro non viene usato; deve essere 0.
Lparam Specifica la modalità di visualizzazione dell'input penna nell'intervallo selezionato, come definito nell'enumerazione InkDisplayMode .
Valori restituiti:
Questo messaggio restituisce 0 se ha esito positivo o diverso da zero se si verifica un errore. L'invio di questo messaggio non ha alcun effetto se usato con qualsiasi sistema operativo installato diverso da Windows XP Tablet PC Edition.
EM_GETSTATUS
 Ottiene lo stato del controllo InkEdit .
Parametri
Questo messaggio non ha parametri; wParam e lParam devono essere 0.
Valori restituiti:
Questo messaggio restituisce uno dei valori dell'enumerazione InkEditStatus , che specifica se il controllo è inattivo, la raccolta dell'input penna o il riconoscimento dell'input penna.
EM_RECOGNIZE
 Forza il riconoscimento.
Parametri
Questo messaggio non ha parametri; wParam e lParam devono essere 0.
Valori restituiti:
Questo messaggio restituisce 0 se ha esito positivo o diverso da zero se si verifica un errore.
EM_GETMOUSEICON
 Ottiene l'icona del mouse.
Parametri
Wparam Questo parametro non viene usato; deve essere 0.
Lparam Specifica un puntatore HICON* compilato con l'HICON HICON corrente. Questo HICON può essere un valore HICON o NULL .
Valori restituiti:
Questo messaggio restituisce 0 se ha esito positivo o diverso da zero se si verifica un errore.
EM_SETMOUSEICON
 Imposta l'icona del mouse.
Parametri
Wparam Specifica un valore BOOLEAN impostato su TRUE se il controllo InkEdit deve essere proprietario dell'handle HICON o FALSE se il controllo InkEdit non deve essere proprietario dell'handle HICON. Se il controllo InkEdit possiede l'HICON, si occupa di e distrugge in modo appropriato HICON. In caso contrario, il chiamante possiede HICON ed è responsabile dell'eliminazione.
Lparam Specifica il nuovo valore HICON. Usare NULL per cancellare il valore. Il valore predefinito è NULL.
Valori restituiti:
Questo messaggio restituisce 0 se ha esito positivo o diverso da zero se si verifica un errore.
EM_GETMOUSEPOINTER
 Ottiene il puntatore del mouse.
Parametri
Wparam Questo parametro non viene usato; deve essere 0.
Lparam Contiene un puntatore InkMousePointer* compilato con il valore mousepointer corrente. Questo comportamento corrisponde alla proprietà InkCollector::get_MousePointer .
Valori restituiti:
Questo messaggio restituisce 0 se ha esito positivo o diverso da zero se si verifica un errore.
EM_SETMOUSEPOINTER
 Imposta il puntatore del mouse.
Parametri
Wparam Questo parametro non viene usato; deve essere 0.
Lparam Contiene il nuovo valore MousePointer , definito nell'enumerazione InkMousePointer . Ciò si comporta come la proprietà InkCollector::p ut_MousePointer .
Valori restituiti:
Questo messaggio restituisce 0 se ha esito positivo o diverso da zero se si verifica un errore.
EM_GETUSEMOUSEFORINPUT
 Ottiene lo stato di se l'input del mouse viene considerato come input penna.
Parametri
Questo messaggio non ha parametri; wParam e lParam devono essere 0.
Valori restituiti:
Questo messaggio restituisce 0 se FALSE o 1 se TRUE.
EM_SETUSEMOUSEFORINPUT
 Imposta lo stato di se l'input del mouse viene considerato come input penna.
Parametri
Wparam Specifica un valore booleano che determina se considerare l'input del mouse come input penna.
Lparam Questo parametro non viene usato; deve essere 0.
Valori restituiti:
Questo messaggio restituisce 0 se ha esito positivo o diverso da zero se si verifica un errore.
Osservazioni:
Questa operazione deve essere usata solo se il EM_GETSTATUS restituisce IES_Idle.
Messaggio di notifica degli eventi Descrizione
IECN_STROKE
 Notifica alla finestra padre del controllo InkEdit che è stato creato un oggetto IInkStrokeDisp . Viene inviato in un messaggio di WM_NOTIFY con i parametri seguenti.
Parametri
Wparam Specifica l'identificatore del controllo che ha inviato il messaggio.
Lparam Specifica un puntatore alla struttura IEC_STROKEINFO .
Valori restituiti:
Il client restituisce 0 per accettare il tratto e 1 per annullare il tratto.
IECN_GESTURE
 Notifica alla finestra padre del controllo InkEdit che è stato riconosciuto un movimento. Viene inviato in un messaggio di WM_NOTIFY con i parametri seguenti.
Parametri
Wparam Specifica l'identificatore del controllo che ha inviato il messaggio.
Lparam Specifica un puntatore alla struttura IEC_GESTUREINFO .
Valori restituiti:
Il client restituisce 0 per accettare il movimento e 1 per annullare il movimento.
IECN_RECOGNITIONRESULT
 Notifica alla finestra padre del controllo InkEdit che si è verificato il riconoscimento. Viene inviato in un messaggio di WM_NOTIFY con i parametri seguenti.
Parametri
Wparam Specifica l'identificatore del controllo che ha inviato il messaggio.
Lparam Specifica un puntatore alla struttura IEC_RECOGNITIONRESULTINFO .
Valori restituiti:
Il client restituisce 0 se elabora il messaggio.

Si applica a

IEC_GESTUREINFO struttura (solo Win32)

IEC_STROKEINFO struttura (solo Win32)

IEC_RECOGNITIONRESULTINFO struttura (solo Win32)

MousePointer, proprietà

Enumerazione InkEditStatus

Enumerazione InkInsertMode

Enumerazione InkMode

Interfaccia IInkCursor

Classe InkDrawingAttributes

Interfaccia IInkRecognitionResult

Interfaccia IInkRecognizer

Classe InkDisp

Interfaccia IInkGesture