パラメータ
hwndEdit
[入力] 対象のシステムエディットコントロールのハンドル。
通常、これはエディットボックスまたは、拡張コンボボックスに組み込まれたエディットボックスのハンドルである。
dwFlags
[入力] SHAutoComplete関数の動作を指定するフラグ。
値
|
意味
|
SHACF_AUTOAPPEND_FORCE_OFF |
標準の設定を無視し、自動補完機能を強制的にオフにする。 |
SHACF_AUTOAPPEND_FORCE_ON
|
レジストリ値を無視し、自動補完機能を強制的にオンにする。
補完された文字列は追加された部分が選択状態でエディットボックスの中に表示される。
|
SHACF_AUTOSUGGEST_FORCE_OFF |
レジストリ標準の値を無視し、自動補助機能をオフにする。 |
SHACF_AUTOSUGGEST_FORCE_ON
|
レジストリ値を無視し、自動補助機能をオンにする。
選択できる文字列はエディットボックスの下のドロップダウンリスト内に表示される。
SHACF_DEFAULT SHACF_FILESYSTEM と SHACF_URLALLの組み合わせ。
|
SHACF_FILESYSTEM |
デスクトップやコントロールパネルのような仮想フォルダを含むファイル一覧を含む。 |
SHACF_FILESYS_ONLY |
ファイルのみを含む。仮想フォルダは含まない。
SHACF_URLALL SHACF_URLHISTORY とSHACF_URLMRUの組み合わせ。 |
SHACF_URLHISTORY |
ユーザの履歴内のURLを含む。 |
SHACF_URLMRU |
最近使ったURLリスト内のURLを含む。 |
戻り値
関数が成功すると、S_OKが戻る。その他の場合、標準OLEエラー値が返る。
解説
SHAutoComplete
はどのようなシステムエディットボックス(拡張コンボボックスのようなエディットボックスを持っているエディットや、コントロー
ルを含む)についても作動する。
拡張コンボボックスに組み込まれたエディットボックスのハンドルを取得するには CBEM_GETEDITCONTROL
メッセージを送ればよい。
アプリケーションは、この関数を呼び出す前にCoInitialize関数、またはOleInitialize関数のどちらかを呼び出さなくてはならない。
CoUninitialize 関数または、OleUninitialize 関数は、そのエディットボックスの
WM_DESTROY メッセージの処理が終わるまで呼び出し
てはならない。 |