Condividi tramite

InkEdit Messages (solo Win32)

  • Articolo

Il controllo InkEdit è una classe super del controlloRichEdit. 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);

Messaggio

La finestra padre del controllo InkEdit riceve messaggi di notifica degli eventi tramite il messaggio di 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 Descrizione
EM_GETINKMODE
 Ottiene la modalità di 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'enumerazioneInkMode, che specifica se l'insieme input penna è disabilitato, se l'input penna viene raccolto o se vengono raccolti input penna e movimenti.
EM_SETINKMODE
 Imposta la modalità di input penna del controllo InkEdit.
Parametri:
wParamSpecifica uno dei valori dell'enumerazioneInkMode, che specifica se l'insieme input penna è disabilitato, se l'input penna viene raccolto o se vengono raccolti input penna e movimenti.
lParamQuesto 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 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 input penna del controllo InkEdit. L'invio di questo messaggio non ha alcun effetto se usato con qualsiasi sistema operativo installato diverso da Microsoft Windows XP Tablet PC Edition.
Parametri:
wParamSpecifica uno dei valori dell'enumerazioneInkInsertMode, che specifica se l'input penna viene inserito nel controllo come testo o come input penna.
lParamQuesto 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:
wParamQuesto parametro non viene usato; deve essere 0.
lParamspecifica 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 la futura raccolta di input penna.
Parametri:
wParamQuesto parametro non viene usato; deve essere 0.
lParamspecifica 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:
wParamSpecifica il timeout di riconoscimento, espresso in millisecondi.
lParamQuesto 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:
wParamSpecifica il tipo di movimento, come definito nell'enumerazioneInkApplicationGesture.
lParamQuesto 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:
wParamSpecifica il tipo di movimento, come definito nell'enumerazioneInkApplicationGesture.
lParamspecifica 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:
wParamQuesto parametro non viene usato; deve essere 0.
lParamSpecifica un puntatore a un IInkRecognizer* per ricevere l'oggetto IInkRecognizer usato 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 riconoscitore utilizzato dal controllo InkEdit. Se per il controllo InkEdit viene utilizzato un factoid, deve essere riapplicato dopo l'invio del messaggio.
Parametri:
wParamQuesto parametro non viene usato; deve essere 0.
lParamSpecifica un puntatore a un IInkRecognizer* per impostare l'oggettoIInkRecognizerusato 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 utilizzata solo se il EM_GETSTATUS restituisce IES_Idle.
EM_GETFACTOID
 Ottiene il factoid da utilizzare per il riconoscimento.
Parametri:
wParamQuesto parametro non viene usato; deve essere 0.
lParamSpecifica 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 il factoid da usare per il riconoscimento.
Parametri:
wParamQuesto parametro non viene usato; deve essere 0.
lParamSpecifica il valore BSTR che contiene 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 utilizzata solo se il EM_GETSTATUS restituisce IES_Idle.
EM_GETSELINK
 Ottiene l'input penna all'interno della selezione. Prima di accedere tramite questo messaggio, è necessario riconoscere l'input penna. Se non viene riconosciuto per primo, EM_GETSELINK restituisce sempre zero oggetti InkDisp.
Parametri:
wParamQuesto parametro non viene usato; deve essere 0.
lParamSpecifica un puntatore a un valore VARIANT per ricevere una matrice sicura per ricevere InkDisp oggetti 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:
wParamQuesto parametro non viene usato; deve essere 0.
lParamSpecifica un puntatore a un valore 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 utilizzando uno dei valori dell'enumerazioneInkDisplayMode.
Parametri:
Questo messaggio non ha parametri; wParam e lParam devono essere 0.
Valori restituiti:
Questo messaggio restituisce uno dei valori dell'enumerazioneInkDisplayMode(IDM_Text o IDM_Ink), che specifica la modalità di visualizzazione di una selezione nel controllo.
EM_SETSELINKDISPLAYMODE
 Imposta l'aspetto dell'input penna nell'intervallo selezionato utilizzando uno dei valori dell'enumerazione InkDisplayMode.
Parametri:
wParamQuesto parametro non viene usato; deve essere 0.
lParamSpecifica 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, raccolta dell'input penna o 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:
wParamQuesto parametro non viene usato; deve essere 0.
lParamSpecifica un puntatore HICON* compilato con l'MouseIcon corrente HICON. Questo HICON può essere hicon o un valore 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:
wParamSpecifica 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 e distrugge l'HICON in modo appropriato. In caso contrario, il chiamante possiede l'HICON ed è responsabile dell'eliminazione.
lParamSpecifica 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:
wParamQuesto parametro non viene usato; deve essere 0.
lParamcontiene un puntatore InkMousePointer* compilato con il valore corrente MousePointer. Questo comportamento equivale 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:
wParamQuesto parametro non viene usato; deve essere 0.
lParamcontiene il nuovo valoremousepointerdefinito nell'enumerazioneInkMousePointer. Questo comportamento equivale alla 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:
wParamSpecifica un valore booleano che determina se considerare l'input del mouse come input penna.
lParamQuesto 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.
Messaggio di notifica degli eventi Descrizione
IECN_STROKE
 Notifica alla finestra padre del controllo InkEdit che è stata creata unaIInkStrokeDisp. Questo viene inviato in un messaggio di WM_NOTIFY con i parametri seguenti.
Parametri:
wParamSpecifica l'identificatore del controllo che ha inviato il messaggio.
lParamSpecifica 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 all'InkEdit finestra padre del controllo che è stato riconosciuto un movimento. Questo viene inviato in un messaggio di WM_NOTIFY con i parametri seguenti.
Parametri:
wParamSpecifica l'identificatore del controllo che ha inviato il messaggio.
lParamSpecifica 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. Questo viene inviato in un messaggio di WM_NOTIFY con i parametri seguenti.
Parametri:
wParamSpecifica l'identificatore del controllo che ha inviato il messaggio.
lParamSpecifica un puntatore alla struttura IEC_RECOGNITIONRESULTINFO.
Valori restituiti:
Il client restituisce 0 se elabora il messaggio.

Si applica a

strutturaIEC_GESTUREINFO (solo Win32)

strutturaIEC_STROKEINFO (solo Win32)

strutturaIEC_RECOGNITIONRESULTINFO (solo Win32)

Proprietà MousePointer

di enumerazione InkEditStatus

'enumerazione InkInsertMode

'enumerazione InkMode

interfaccia IInkCursor

Classe InkDrawingAttributes

interfaccia IInkRecognitionResult

interfaccia IInkRecognizer

Classe InkDisp

interfaccia IInkGesture