IAutoComplete::Init 方法 (shldisp.h)
初始化自動完成物件。
語法
HRESULT Init(
[in] HWND hwndEdit,
[in] IUnknown *punkACL,
[in, optional] LPCWSTR pwszRegKeyPath,
[in, optional] LPCWSTR pwszQuickComplete
);
參數
[in] hwndEdit
類型: HWND
將啟用自動完成之系統編輯控制件之視窗的句柄。
[in] punkACL
類型: IUnknown*
字串清單物件之 IUnknown 介面的指標,可產生已完成字串的候選專案。 對象必須公開 IEnumString 介面。
[in, optional] pwszRegKeyPath
類型: LPCWSTR
選擇性、以 Null 結尾的 Unicode 字串指標,提供登錄路徑,包括值名稱,其中格式字串會儲存為 REG_SZ 值。 自動完成物件會先尋找 HKEY_CURRENT_USER底下的路徑。 如果失敗,它會嘗試 HKEY_LOCAL_MACHINE。 如需格式字串的討論,請參閱 pwszQuickComplete 的定義。
[in, optional] pwszQuickComplete
類型: LPCWSTR
選擇性 Null 終止 Unicode 字串的指標,指定使用者輸入文字並按 CTRL+ENTER 時要使用的格式。 將此參數設定為 NULL ,以停用快速完成。 否則,autocomplete 物件會將 pwszQuickComplete 視為 StringCchPrintf 格式字串,並將編輯方塊中的文字視為其相關聯的自變數,以產生新的字元串。 例如,將 pwszQuickComplete 設定為 “http://www.%s.com/"。 當使用者在編輯方塊中輸入 「MyURL」,然後按 CTRL+ENTER 時,編輯方塊中的文字會更新為 “http://www.MyURL.com/"”。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版、Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | shldisp.h |
Dll | Shell32.dll (5.0 版或更新版本) |