DlgDirSelectComboBoxExA 関数 (winuser.h)
DlgDirListComboBox 関数を使用して入力されたコンボ ボックスから現在の選択範囲を取得します。 選択は、ドライブ文字、ファイル、またはディレクトリ名として解釈されます。
構文
BOOL DlgDirSelectComboBoxExA(
[in] HWND hwndDlg,
[out] LPSTR lpString,
[in] int cchOut,
[in] int idComboBox
);
パラメーター
[in] hwndDlg
型: HWND
コンボ ボックスを含むダイアログ ボックスのハンドル。
[out] lpString
型: LPTSTR
選択したパスを受け取るバッファーへのポインター。
[in] cchOut
型: int
lpString パラメーターが指すバッファーの長さ (文字数)。
[in] idComboBox
型: int
ダイアログ ボックス内のコンボ ボックス コントロールの整数識別子。
戻り値
型: BOOL
現在の選択範囲がディレクトリ名の場合、戻り値は 0 以外です。
現在の選択範囲がディレクトリ名でない場合、戻り値は 0 になります。 拡張エラー情報を取得するには、GetLastError
備考
現在の選択範囲でディレクトリ名またはドライブ文字が指定されている場合、DlgDirSelectComboBoxEx 関数は、囲まれた角かっこ (およびドライブ文字のハイフン) を削除して、名前または文字を新しいパスまたはファイル名に挿入する準備が整います。 選択されていない場合、lpString
DlgDirSelectComboBoxEx 関数は、コンボ ボックスから複数のファイル名を返すことを許可しません。
文字列がバッファーの長さ以上の場合、バッファーには、終端の null 文字を含む切り捨てられた文字列が含まれます。
DlgDirSelectComboBoxEx
この関数は、3 種類のコンボ ボックス (CBS_SIMPLE、CBS_DROPDOWN、CBS_DROPDOWNLIST) と共に使用できます。
セキュリティ警告: この関数を不適切に使用すると、アプリケーションに問題が発生する可能性があります。 たとえば、nCount パラメーターは、ANSI バージョンと Unicode バージョンの両方に対して適切に設定する必要があります。 これを行わないと、バッファー オーバーフローが発生する可能性があります。 続行する前に、「セキュリティに関する考慮事項: Microsoft Windows コントロールの」を確認する必要があります。
Windows 95 以降の: DlgDirSelectComboBoxExW は、Microsoft Layer for Unicode (MSLU) でサポートされています。 これを使用するには、「Windows Me/98/95 Systemsの Unicode 用 Microsoft Layer
手記
winuser.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして DlgDirSelectComboBoxEx を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows Server 2003 [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | winuser.h (Windows.h を含む) |
ライブラリ | User32.lib |
DLL | User32.dll |
関連項目
DlgDirListComboBox を
リファレンス