IInputMethod::UserOptionsDlg

This method is implemented when the user requests that an input method (IM)-specific options dialog box be presented.

HRESULT UserOptionsDlg( 
[in] HWND hwndParent);

Parameters

  • hwndParent
    Handle to the window that should be the parent of the dialog box window created by the IM.

Return Values

An appropriate HRESULT value is returned.

Remarks

Through this method, the user can directly configure settings within the IM. This method differs significantly in context from the other methods in the IInputMethod interface for the following reasons:

  • It is called by the input panel control panel dialog box after instantiating a new instance of the IM; it is not called on the input panel thread.
  • It is called without other initialization methods, such as RegisterCallback or Select, being called first.
  • The current IM instance is unloaded immediately after calling UserOptionsDlg.

The User Options dialog box sets registry or other persistent configuration information for the IM. This information is used by the IM when it is selected into the input panel.

Requirements

Runs On Versions Defined in Include Link to
Windows CE OS 2.01 and later Sip.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

IInputMethod::RegisterCallback, IInputMethod::Select

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.