CB_DIR メッセージ

コンボ ボックスに表示されるリストに名前を追加します。 メッセージは、指定された文字列とファイル属性のセットに一致するディレクトリとファイルの名前を追加します。 CB_DIR は、マップされたドライブ文字をリストに追加することもできます。

パラメーター

wParam

コンボ ボックスに追加するファイルまたはディレクトリの属性。 このパラメーターには、次の 1 つ以上の値を指定できます。

意味
DDL_ARCHIVE
アーカイブされたファイルが含まれます。
DDL_DIRECTORY
角かっこ ([ ]) で囲まれたサブディレクトリが含まれます。
DDL_DRIVES
マップされているすべてのドライブが一覧に追加されます。 ドライブは [-x-] の形式で表示されます。 x はドライブ文字です。
DDL_EXCLUSIVE
指定した属性を持つファイルのみが含まれます。 既定では、DDL_READWRITEが指定されていない場合でも、読み取り/書き込みファイルが一覧表示されます。
DDL_HIDDEN
非表示のファイルが含まれます。
DDL_READONLY
読み取り専用ファイルが含まれます。
DDL_READWRITE
追加の属性を持たない読み取り/書き込みファイルが含まれます。 既定値です。
DDL_SYSTEM
システム ファイルが含まれます。

lParam

絶対パス、相対パス、またはファイル名を指定する null で終わる文字列への LPCTSTR ポインター。 絶対パスはドライブ文字で始めることができます (例: d:)または UNC 名 (\\machinenamesharename\ など)。 文字列に wParam パラメーターで指定された属性を持つファイル名またはディレクトリが指定されている場合、ファイル名またはディレクトリが一覧に追加されます。 ファイル名またはディレクトリ名にワイルドカード文字 (? または *) が含まれている場合、ワイルドカード式に一致し、 wParam パラメーターで指定された属性を持つすべてのファイルまたはディレクトリが、コンボ ボックスに表示されるリストに追加されます。

戻り値

メッセージが成功した場合、戻り値はリストに追加された姓の 0 から始まるインデックスです。

エラーが発生した場合、戻り値はCB_ERR。 新しい文字列を格納するのに十分な領域がない場合、戻り値はCB_ERRSPACE。

注釈

wParam に DDL_DIRECTORY フラグが含まれており、lParam が C:\TEMP\* など、第 1 レベルのディレクトリのすべてのサブディレクトリを指定する場合、リスト ボックスにはルート ディレクトリの ".." エントリが常に含まれます。 これは、ルート ディレクトリに非表示属性またはシステム属性があり、DDL_HIDDENフラグとDDL_SYSTEM フラグが指定されていない場合でも当てはまります。 NTFS ボリュームのルート ディレクトリには、非表示属性とシステム属性があります。

長いファイル名がある場合は、一覧に長いファイル名が表示されます。

要件

要件
サポートされている最小のクライアント
Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
Windows Server 2003 [デスクトップ アプリのみ]
Header
Winuser.h (Windows.h を含む)

関連項目

参照

CB_ADDSTRING

CB_INSERTSTRING

DlgDirListComboBox