Compartilhar via

Mensagens InkEdit (somente Win32)

  • Artigo

O controle InkEdit é uma super classe do controleRichEdit. Cada mensagem RichEdit é transmitida, 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 evento.

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 evento 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:
wParamEspecifica um dos valores da enumeraçãoInkMode, que especifica se a coleção de tinta está desabilitada, se a tinta é coletada ou se a tinta e os gestos são coletados.
lParamEsse parâmetro não é usado; deve ser 0.
Valores retornados:
Essa mensagem retornará 0 se houver êxito ou não zero se ocorrer um erro.
Observações:
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 como 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 que não seja o Microsoft Windows XP Tablet PC Edition.
Parâmetros:
wParamEspecifica um dos valores da enumeraçãoInkInsertMode, que especifica se a tinta é inserida no controle como texto ou como tinta.
lParamEsse parâmetro não é usado; deve ser 0.
Valores retornados:
Essa mensagem retornará 0 se houver êxito ou não zero se ocorrer um erro.
EM_GETDRAWATTR
 Obtém os atributos de desenho atuais do controle InkEdit.
Parâmetros:
wParamEsse parâmetro não é usado; deve ser 0.
lParamespecifica um ponteiro (IInkDrawingAttributes **pDrawAttr) para receber o objetoInkDrawingAttributesatual.
Valores retornados:
Essa mensagem retornará 0 se houver êxito ou não zero se ocorrer um erro.
EM_SETDRAWATTR
 Define os atributos de desenho a serem usados para futura coleção de tintas.
Parâmetros:
wParamEsse parâmetro não é usado; deve ser 0.
lParamespecifica um ponteiro (IInkDrawingAttributes *pDrawAttr) para um objeto InkDrawingAttributes.
Valores retornados:
Essa mensagem retornará 0 se houver êxito ou não 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:
wParamEspecifica o tempo limite de reconhecimento, em milissegundos.
lParamEsse parâmetro não é usado; deve ser 0.
Valores retornados:
Essa mensagem retornará 0 se houver êxito ou não zero se ocorrer um erro.
EM_GETGESTURESTATUS
 Obtém o status do gesto para o controle InkEdit.
Parâmetros:
wParamEspecifica o tipo de gesto, conforme definido na enumeraçãoInkApplicationGesture.
lParamEsse parâmetro não é usado; deve ser 0.
Valores retornados:
Esta 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 status do gesto para o controle InkEdit.
Parâmetros:
wParamEspecifica o tipo de gesto, conforme definido na enumeraçãoInkApplicationGesture.
lParamEspecifica VERDADEIRO se a assinatura do gesto estiver habilitada ou FALSE se a escuta do gesto não estiver habilitada.
Valores retornados:
Essa mensagem retornará 0 se houver êxito ou não zero se ocorrer um erro.
Observações:
Isso só deverá ser usado se o EM_GETSTATUS retornar IES_Idle.
EM_GETRECOGNIZER
 Obtém o reconhecedor usado pelo controle InkEdit.
Parâmetros:
wParamEsse parâmetro não é usado; deve ser 0.
lParamEspecifica um ponteiro para um IInkRecognizer* para receber o objetoIInkRecognizerusado pelo controle InkEdit.
Valores retornados:
Essa mensagem retornará 0 se houver êxito ou não zero se ocorrer um erro.
EM_SETRECOGNIZER
 Define o reconhecedor usado pelo controle InkEdit. Se um Factoid for usado para o controle InkEdit, ele deverá ser reaplicado depois de enviar esta mensagem.
Parâmetros:
wParamEsse parâmetro não é usado; deve ser 0.
lParamEspecifica um ponteiro para um IInkRecognizer* para definir o objetoIInkRecognizerque o controle InkEdit usa para uso posterior.
Valores retornados:
Essa mensagem retornará 0 se houver êxito ou não zero se ocorrer um erro.
Observações:
Isso só deverá ser usado se o EM_GETSTATUS retornar IES_Idle.
EM_GETFACTOID
 Obtém o Factoid a ser usado para reconhecimento.
Parâmetros:
wParamEsse parâmetro não é usado; deve ser 0.
lParamEspecifica um ponteiro para um BSTR para receber a cadeia de caracteres factoid.
Valores retornados:
Essa mensagem retornará 0 se houver êxito ou não zero se ocorrer um erro.
EM_SETFACTOID
 Define o Factoid a ser usado para reconhecimento.
Parâmetros:
wParamEsse parâmetro não é usado; deve ser 0.
lParamEspecifica o BSTR que contém a cadeia de caracteres factoid.
Valores retornados:
Essa mensagem retornará 0 se houver êxito ou não zero se ocorrer um erro.
Observações:
Isso só deverá 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 não for reconhecido primeiro, EM_GETSELINK sempre retornará zero objetos InkDisp.
Parâmetros:
wParamEsse parâmetro não é usado; deve ser 0.
lParamEspecifica um ponteiro para um VARIANT para receber uma matriz segura para receber objetos InkDisp dentro da seleção atual.
Valores retornados:
Essa mensagem retornará 0 se houver êxito ou não 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 que não seja o Windows XP Tablet PC Edition.
Parâmetros:
wParamEsse parâmetro não é usado; deve ser 0.
lParamEspecifica um ponteiro para um VARIANT com uma matriz segura de objetosInkDisp para substituir a seleção atual.
Valores retornados:
Essa mensagem retornará 0 se houver êxito ou não 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:
Esta 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:
wParamEsse parâmetro não é usado; deve ser 0.
lParamEspecifica como a tinta aparece no intervalo selecionado, conforme definido na enumeração InkDisplayMode.
Valores retornados:
Essa mensagem retornará 0 se houver êxito ou não zero se ocorrer um erro. O envio dessa mensagem não terá efeito se for usado com qualquer sistema operacional instalado que não seja o 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:
Esta 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 houver êxito ou não zero se ocorrer um erro.
EM_GETMOUSEICON
 Obtém o ícone do mouse.
Parâmetros:
wParamEsse parâmetro não é usado; deve ser 0.
lParamEspecifica um ponteiro HICON* que é preenchido com oHICON do MouseIconatual. Esse HICON pode ser um VALOR DE DE NULL ou HICON.
Valores retornados:
Essa mensagem retornará 0 se houver êxito ou não zero se ocorrer um erro.
EM_SETMOUSEICON
 Define o ícone do mouse.
Parâmetros:
wParamEspecifica um valor BOOLEAN definido como VERDADEIRO se o controle InkEdit deve ser proprietário do identificador HICON ou FALSE se o controle InkEdit não tiver o identificador HICON. Se o controle InkEdit for 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.
lParamEspecifica o novo valor HICON. Use NULL para limpar o valor. O valor padrão é NULL.
Valores retornados:
Essa mensagem retornará 0 se houver êxito ou não zero se ocorrer um erro.
EM_GETMOUSEPOINTER
 Obtém o ponteiro do mouse.
Parâmetros:
wParamEsse parâmetro não é usado; deve ser 0.
lParam contém um ponteiro InkMousePointer* preenchido com o valordo MousePointeratual. Isso se comporta da mesma forma que a propriedade InkCollector::get_MousePointer.
Valores retornados:
Essa mensagem retornará 0 se houver êxito ou não zero se ocorrer um erro.
EM_SETMOUSEPOINTER
 Define o ponteiro do mouse.
Parâmetros:
wParamEsse parâmetro não é usado; deve ser 0.
lParamContém o novo valor dedo 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 houver êxito ou não 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:
wParamEspecifica um valor booliano que determina se a entrada do mouse deve ser tratada como entrada de caneta.
lParamEsse parâmetro não é usado; deve ser 0.
Valores retornados:
Essa mensagem retornará 0 se houver êxito ou não zero se ocorrer um erro.
Observações:
Isso só deverá 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 umIInkStrokeDispfoi criado. Isso é enviado em uma mensagem WM_NOTIFY com os parâmetros a seguir.
Parâmetros:
wParamEspecifica o identificador do controle que enviou a mensagem.
lParamEspecifica um ponteiro para a estrutura de 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 InkEdit que um gesto foi reconhecido. Isso é enviado em uma mensagem WM_NOTIFY com os parâmetros a seguir.
Parâmetros:
wParamEspecifica o identificador do controle que enviou a mensagem.
lParamEspecifica um ponteiro para a estrutura de 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 InkEdit que o reconhecimento ocorreu. Isso é enviado em uma mensagem WM_NOTIFY com os parâmetros a seguir.
Parâmetros:
wParamEspecifica o identificador do controle que enviou a mensagem.
lParamEspecifica um ponteiro para a estrutura de 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

de Enumeração InkMode

de interface IInkCursor

classe InkDrawingAttributes

interface IInkRecognitionResult

interface IInkRecognizer

da classeInkDisp

interface IInkGesture