Mensagens InkEdit (somente Win32)

  • Artigo

O controle InkEdit é uma super classe do controle RichEdit . Cada mensagem richedit é passada, diretamente na maioria dos casos, e tem exatamente o mesmo efeito que em RichEdit. Isso também se aplica a mensagens de notificação de eventos.

Para enviar essas mensagens, chame a função SendMessage com os seguintes parâmetros:

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

Mensagem

A janela pai do controle InkEdit recebe mensagens de notificação de eventos por meio da mensagem 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
);
Obter/definir mensagem Descrição
EM_GETINKMODE
 Obtém o modo de escrita à tinta do controle InkEdit .
Parâmetros:
Esta mensagem não tem parâmetros; wParam e lParam devem ser 0.
Valores retornados:
Essa mensagem retorna um dos valores definidos na enumeração InkMode , que especifica se a coleção de tinta está desabilitada, se a tinta é coletada ou se a tinta e os gestos são coletados.
EM_SETINKMODE
 Define o modo de escrita à tinta do controle InkEdit .
Parâmetros:
Wparam Especifica um dos valores da enumeração InkMode , que especifica se a coleção de tinta está desabilitada, se a tinta é coletada ou se a tinta e os gestos são coletados.
Lparam Esse parâmetro não é usado; deve ser 0.
Valores de retorno:
Esta mensagem retornará 0 se tiver êxito ou diferente de zero se ocorrer um erro.
Comentários:
Isso só deverá ser usado se o EM_GETSTATUS retornar IES_Idle.
EM_GETINKINSERTMODE
 Obtém o modo de inserção de tinta do controle InkEdit .
Parâmetros:
Esta mensagem não tem parâmetros; wParam e lParam devem ser 0.
Valores retornados:
Esta mensagem retorna um dos valores da enumeração InkInsertMode , que especifica se a tinta é inserida no controle como texto ou tinta.
EM_SETINKINSERTMODE
 Define o modo de inserção de tinta do controle InkEdit . O envio dessa mensagem não terá efeito se for usado com qualquer sistema operacional instalado além do Microsoft Windows XP Tablet PC Edition.
Parâmetros:
Wparam Especifica um dos valores da enumeração InkInsertMode , que especifica se a tinta é inserida no controle como texto ou tinta.
Lparam Esse parâmetro não é usado; deve ser 0.
Valores retornados:
Esta mensagem retornará 0 se tiver êxito ou diferente de zero se ocorrer um erro.
EM_GETDRAWATTR
 Obtém os atributos de desenho atuais do controle InkEdit .
Parâmetros:
Wparam Esse parâmetro não é usado; deve ser 0.
Lparam Especifica um ponteiro (IInkDrawingAttributes **pDrawAttr) para receber o objeto InkDrawingAttributes atual.
Valores retornados:
Esta mensagem retornará 0 se tiver êxito ou diferente de zero se ocorrer um erro.
EM_SETDRAWATTR
 Define os atributos de desenho a serem usados para coleção de tinta futura.
Parâmetros:
Wparam Esse parâmetro não é usado; deve ser 0.
Lparam Especifica um ponteiro (IInkDrawingAttributes *pDrawAttr) para um objeto InkDrawingAttributes .
Valores retornados:
Esta mensagem retornará 0 se tiver êxito ou diferente de zero se ocorrer um erro.
EM_GETRECOTIMEOUT
 Obtém o tempo limite de reconhecimento, em milissegundos, para o controle InkEdit .
Parâmetros:
Esta mensagem não tem parâmetros; wParam e lParam devem ser 0.
Valores retornados:
Essa mensagem retorna o tempo limite de reconhecimento, em milissegundos.
EM_SETRECOTIMEOUT
 Define o tempo limite de reconhecimento, em milissegundos, para o controle InkEdit .
Parâmetros:
Wparam Especifica o tempo limite de reconhecimento, em milissegundos.
Lparam Esse parâmetro não é usado; deve ser 0.
Valores retornados:
Esta mensagem retornará 0 se tiver êxito ou diferente de zero se ocorrer um erro.
EM_GETGESTURESTATUS
 Obtém o gesto status para o controle InkEdit.
Parâmetros:
Wparam Especifica o tipo de gesto, conforme definido na enumeração InkApplicationGesture .
Lparam Esse parâmetro não é usado; deve ser 0.
Valores retornados:
Essa mensagem retornará TRUE se o controle InkEdit assinar o gesto ou FALSE se o controle InkEdit não assinar o gesto.
EM_SETGESTURESTATUS
 Define o gesto status para o controle InkEdit.
Parâmetros:
Wparam Especifica o tipo de gesto, conforme definido na enumeração InkApplicationGesture .
Lparam Especifica TRUE se a assinatura do gesto estiver habilitada ou FALSE se a escuta do gesto não estiver habilitada.
Valores retornados:
Esta mensagem retornará 0 se tiver êxito ou diferente de zero se ocorrer um erro.
Comentários:
Isso só deverá ser usado se o EM_GETSTATUS retornar IES_Idle.
EM_GETRECOGNIZER
 Obtém o reconhecedor que o controle InkEdit usa.
Parâmetros:
Wparam Esse parâmetro não é usado; deve ser 0.
Lparam Especifica um ponteiro para um IInkRecognizer* para receber o objeto IInkRecognizer usado pelo controle InkEdit .
Valores retornados:
Esta mensagem retornará 0 se tiver êxito ou diferente de zero se ocorrer um erro.
EM_SETRECOGNIZER
 Define o reconhecedor que o controle InkEdit usa. Se um Factoid for usado para o controle InkEdit, ele deverá ser reaplicado depois de enviar esta mensagem.
Parâmetros:
Wparam Esse parâmetro não é usado; deve ser 0.
Lparam Especifica um ponteiro para um IInkRecognizer* para definir o objeto IInkRecognizer que o controle InkEdit usa para uso posterior.
Valores retornados:
Esta mensagem retornará 0 se tiver êxito ou diferente de zero se ocorrer um erro.
Comentários:
Isso só deve ser usado se o EM_GETSTATUS retornar IES_Idle.
EM_GETFACTOID
 Obtém o Factoid a ser usado para reconhecimento.
Parâmetros:
Wparam Esse parâmetro não é usado; deve ser 0.
Lparam Especifica um ponteiro para um BSTR para receber a cadeia de caracteres factoid.
Valores retornados:
Essa mensagem retornará 0 se tiver êxito ou diferente de zero se ocorrer um erro.
EM_SETFACTOID
 Define o Factoid a ser usado para reconhecimento.
Parâmetros:
Wparam Esse parâmetro não é usado; deve ser 0.
Lparam Especifica o BSTR que contém a cadeia de caracteres factoid.
Valores retornados:
Essa mensagem retornará 0 se tiver êxito ou diferente de zero se ocorrer um erro.
Comentários:
Isso só deve ser usado se o EM_GETSTATUS retornar IES_Idle.
EM_GETSELINK
 Obtém a tinta dentro da seleção. A tinta deve ser reconhecida antes de ser acessada por meio desta mensagem. Se ele não for reconhecido primeiro, EM_GETSELINK sempre retornará zero objetos InkDisp .
Parâmetros:
Wparam Esse parâmetro não é usado; deve ser 0.
Lparam Especifica um ponteiro para um VARIANT para receber uma matriz segura para receber objetos InkDisp na seleção atual.
Valores retornados:
Essa mensagem retornará 0 se tiver êxito ou diferente de zero se ocorrer um erro.
EM_SETSELINK
 Define a tinta dentro da seleção. O envio dessa mensagem não terá efeito se for usado com qualquer sistema operacional instalado além do Windows XP Tablet PC Edition.
Parâmetros:
Wparam Esse parâmetro não é usado; deve ser 0.
Lparam Especifica um ponteiro para um VARIANT com uma matriz segura de objetos InkDisp para substituir a seleção atual.
Valores retornados:
Essa mensagem retornará 0 se tiver êxito ou diferente de zero se ocorrer um erro.
EM_GETSELINKDISPLAYMODE
 Retorna a aparência atual da tinta no intervalo selecionado usando um dos valores da enumeração InkDisplayMode .
Parâmetros:
Esta mensagem não tem parâmetros; wParam e lParam devem ser 0.
Valores retornados:
Essa mensagem retorna um dos valores da enumeração InkDisplayMode (IDM_Text ou IDM_Ink), que especifica como uma seleção aparece no controle.
EM_SETSELINKDISPLAYMODE
 Define a aparência da tinta no intervalo selecionado usando um dos valores da enumeração InkDisplayMode .
Parâmetros:
Wparam Esse parâmetro não é usado; deve ser 0.
Lparam Especifica como a tinta aparece no intervalo selecionado, conforme definido na enumeração InkDisplayMode .
Valores retornados:
Essa mensagem retornará 0 se tiver êxito ou diferente de zero se ocorrer um erro. O envio dessa mensagem não terá efeito se for usado com qualquer sistema operacional instalado além do Windows XP Tablet PC Edition.
EM_GETSTATUS
 Obtém o status do controle InkEdit.
Parâmetros:
Esta mensagem não tem parâmetros; wParam e lParam devem ser 0.
Valores retornados:
Essa mensagem retorna um dos valores da enumeração InkEditStatus , que especifica se o controle está ocioso, coletando tinta ou reconhecendo tinta.
EM_RECOGNIZE
 Força o reconhecimento.
Parâmetros:
Esta mensagem não tem parâmetros; wParam e lParam devem ser 0.
Valores retornados:
Essa mensagem retornará 0 se tiver êxito ou diferente de zero se ocorrer um erro.
EM_GETMOUSEICON
 Obtém o ícone do mouse.
Parâmetros:
Wparam Esse parâmetro não é usado; deve ser 0.
Lparam Especifica um ponteiro HICON* preenchido com o HICON do MouseIcon atual. Esse HICON pode ser um HICON ou um valor NULL .
Valores retornados:
Essa mensagem retornará 0 se tiver êxito ou diferente de zero se ocorrer um erro.
EM_SETMOUSEICON
 Define o ícone do mouse.
Parâmetros:
Wparam Especifica um valor BOOLEAN definido como TRUE se o controle InkEdit deve possuir o identificador HICON ou FALSE se o controle InkEdit não deve possuir o identificador HICON. Se o controle InkEdit for o proprietário do HICON, ele cuidará e destruirá o HICON adequadamente. Caso contrário, o chamador é proprietário do HICON e é responsável por excluí-lo.
Lparam Especifica o novo valor HICON. Use NULL para limpar o valor. O valor padrão é NULL.
Valores retornados:
Essa mensagem retornará 0 se tiver êxito ou diferente de zero se ocorrer um erro.
EM_GETMOUSEPOINTER
 Obtém o ponteiro do mouse.
Parâmetros:
Wparam Esse parâmetro não é usado; deve ser 0.
Lparam Contém um ponteiro InkMousePointer* preenchido com o valor atual do MousePointer . Isso se comporta da mesma forma que a propriedade InkCollector::get_MousePointer .
Valores de retorno:
Essa mensagem retornará 0 se tiver êxito ou diferente de zero se ocorrer um erro.
EM_SETMOUSEPOINTER
 Define o ponteiro do mouse.
Parâmetros:
Wparam Esse parâmetro não é usado; deve ser 0.
Lparam Contém o novo valor mousePointer , que é definido na enumeração InkMousePointer . Isso se comporta da mesma forma que a propriedade InkCollector::p ut_MousePointer .
Valores retornados:
Essa mensagem retornará 0 se tiver êxito ou diferente de zero se ocorrer um erro.
EM_GETUSEMOUSEFORINPUT
 Obtém o estado de se a entrada do mouse é tratada como entrada de caneta.
Parâmetros:
Esta mensagem não tem parâmetros; wParam e lParam devem ser 0.
Valores retornados:
Esta mensagem retornará 0 se FALSE ou 1 se TRUE.
EM_SETUSEMOUSEFORINPUT
 Define o estado de se a entrada do mouse é tratada como entrada de caneta.
Parâmetros:
Wparam Especifica um valor booliano que determina se a entrada do mouse deve ser tratada como entrada de caneta.
Lparam Esse parâmetro não é usado; deve ser 0.
Valores retornados:
Essa mensagem retornará 0 se tiver êxito ou diferente de zero se ocorrer um erro.
Comentários:
Isso só deve ser usado se o EM_GETSTATUS retornar IES_Idle.
Mensagem de notificação de evento Descrição
IECN_STROKE
 Notifica a janela pai do controle InkEdit de que um IInkStrokeDisp foi criado. Isso é enviado em uma mensagem WM_NOTIFY com os parâmetros a seguir.
Parâmetros:
Wparam Especifica o identificador do controle que enviou a mensagem.
Lparam Especifica um ponteiro para a estrutura IEC_STROKEINFO .
Valores retornados:
O cliente retorna 0 para aceitar o traço e 1 para cancelar o traço.
IECN_GESTURE
 Notifica a janela pai do controle InkEdit de que um gesto foi reconhecido. Isso é enviado em uma mensagem WM_NOTIFY com os parâmetros a seguir.
Parâmetros:
Wparam Especifica o identificador do controle que enviou a mensagem.
Lparam Especifica um ponteiro para a estrutura IEC_GESTUREINFO .
Valores retornados:
O cliente retorna 0 para aceitar o gesto e 1 para cancelar o gesto.
IECN_RECOGNITIONRESULT
 Notifica a janela pai do controle InkEdit de que o reconhecimento ocorreu. Isso é enviado em uma mensagem WM_NOTIFY com os parâmetros a seguir.
Parâmetros:
Wparam Especifica o identificador do controle que enviou a mensagem.
Lparam Especifica um ponteiro para a estrutura IEC_RECOGNITIONRESULTINFO .
Valores retornados:
O cliente retornará 0 se processar a mensagem.

Aplica-se A

Estrutura IEC_GESTUREINFO (somente Win32)

Estrutura IEC_STROKEINFO (somente Win32)

Estrutura IEC_RECOGNITIONRESULTINFO (somente Win32)

Propriedade MousePointer

Enumeração InkEditStatus

Enumeração InkInsertMode

Enumeração InkMode

IInkCursor Interface

Classe InkDrawingAttributes

IInkRecognitionResult Interface

IInkRecognizer Interface

Classe InkDisp

IInkGesture Interface