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 値として格納されます。 autocomplete オブジェクトは、最初に HKEY_CURRENT_USER の下のパスを検索します。 失敗した場合は、 HKEY_LOCAL_MACHINEが試行されます。 書式指定文字列の詳細については、 pwszQuickComplete の定義を参照してください。

[in, optional] pwszQuickComplete

種類: LPCWSTR

ユーザーがテキストを入力し、Ctrl キーを押しながら Enter キーを押した場合に使用する形式を指定する、null で終わるオプションの Unicode 文字列へのポインター。 クイック補完を無効にするには、このパラメーターを NULL に設定します。 それ以外の場合、autocomplete オブジェクトは pwszQuickCompleteを StringCchPrintf 書式指定文字列として扱い、編集ボックス内のテキストを関連付けられた引数として扱って、新しい文字列を生成します。 たとえば、 pwszQuickComplete を "http://www.%s.com/"" に設定します。 ユーザーが編集ボックスに「MyURL」と入力し、Ctrl + Enter キーを押すと、編集ボックスのテキストは "http://www.MyURL.com/"" に更新されます。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	shldisp.h
[DLL]	Shell32.dll (バージョン 5.0 以降)

こちらもご覧ください

IAutoComplete