共用方式為


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 版或更新版本)

另請參閱

IAutoComplete