Compartilhar via


IInputMethod::UserOptionsDlg

Windows Mobile SupportedWindows Embedded CE Supported

9/9/2008

Este método é implementado quando o usuário solicita que uma entrada método (IM)-opções específicas caixa diálogo ser apresentadas.

Syntax

HRESULT UserOptionsDlg( 
  HWND hwndParent
);

Parameters

  • hwndParent
    [no] Identificador para a janela que deve ser o pai da janela caixa de diálogo criada pelo IM.

Return Value

Return S_OK para indicar êxito. Return o apropriado HRESULT valor para indicar falha.

Remarks

Por esse método, o usuário diretamente pode definir configurações dentro de mensagens INSTANTÂNEAS. Esse método difere significativamente no contexto dos outros métodos na IInputMethod interface para a seguinte razões:

  • É chamado, a entrada software-Based caixa diálogo painel de controle painel depois de criar uma instância uma nova instância do IM; Não é chamado na entrada software-Based segmento painel.
  • É chamado sem outros métodos inicialização, como RegisterCallback Ou Selecione, que está sendo chamado primeiro.
  • O atual de mensagens INSTANTÂNEAS instância é descarregada imediatamente após chamado UserOptionsDlg.

O Opções do usuário caixa de diálogo define Registro ou outras informações configuração persistente para as mensagens INSTANTÂNEAS. Este informações são usadas pelo IM quando ela estiver marcada para a entrada software-Based painel.

Requirements

Header sip.h
Library uuid.lib
Windows Embedded CE Windows CE 2.01 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

IInputMethod::RegisterCallback
IInputMethod::Select