IAutoComplete::Init method
Initializes the autocomplete object.
Syntax
HRESULT Init( [in] HWND hwndEdit, [in] IUnknown *punkACL, [in, optional] LPCWSTR pwszRegKeyPath, [in, optional] LPCWSTR pwszQuickComplete );
Parameters
- hwndEdit [in]
-
Type: HWND
A handle to the window for the system edit control for which autocompletion will be enabled.
- punkACL [in]
-
Type: IUnknown*
A pointer to the IUnknown interface of the string list object that generates candidates for the completed string. The object must expose an IEnumString interface.
- pwszRegKeyPath [in, optional]
-
Type: LPCWSTR
A pointer to an optional, null-terminated Unicode string that gives the registry path, including the value name, where the format string is stored as a REG_SZ value. The autocomplete object first looks for the path under HKEY_CURRENT_USER. If it fails, it tries HKEY_LOCAL_MACHINE. For a discussion of the format string, see the definition of pwszQuickComplete.
- pwszQuickComplete [in, optional]
-
Type: LPCWSTR
A pointer to an optional null-terminated Unicode string that specifies the format to be used if the user enters text and presses CTRL+ENTER. Set this parameter to NULL to disable quick completion. Otherwise, the autocomplete object treats pwszQuickComplete as a StringCchPrintf format string and the text in the edit box as its associated argument, to produce a new string. For example, set pwszQuickComplete to "http://www.%s.com/". When a user enters "MyURL" into the edit box and presses CTRL+ENTER, the text in the edit box is updated to "http://www.MyURL.com/".
Return value
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Requirements
|
Minimum supported client |
Windows 2000 Professional, Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps only] |
|
Header |
|
|
DLL |
|
See also