Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

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

Syntax 

HRESULT UserOptionsDlg( 
  HWND 
hwndParent
);

Parameters

hwndParent

[in] Handle to the window that should be the parent of the dialog box window created by the IM.

Return Value

Return S_OK to indicate success. Return the appropriate HRESULTvalue to indicate failure.

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 IInputMethodinterface for the following reasons:

  • It is called by the software-based input panel control panel dialog box after instantiating a new instance of the IM; it is not called on the software-based input panel thread.

  • It is called without other initialization methods, such as RegisterCallback2or Select, being called first.

  • The current IM instance is unloaded immediately after calling UserOptionsDlg.

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

Requirements

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

See Also