DlgDirSelectComboBoxExA-Funktion (winuser.h)
Ruft die aktuelle Auswahl aus einem Kombinationsfeld ab, das mithilfe der Funktion DlgDirListComboBox gefüllt wird . Die Auswahl wird als Laufwerkbuchstabe, Datei oder Verzeichnisname interpretiert.
Syntax
BOOL DlgDirSelectComboBoxExA(
[in] HWND hwndDlg,
[out] LPSTR lpString,
[in] int cchOut,
[in] int idComboBox
);
Parameter
[in] hwndDlg
Typ: HWND
Ein Handle für das Dialogfeld, das das Kombinationsfeld enthält.
[out] lpString
Typ: LPTSTR
Ein Zeiger auf den Puffer, der den ausgewählten Pfad empfängt.
[in] cchOut
Typ: int
Die Länge des Puffers in Zeichen, auf den der lpString-Parameter verweist.
[in] idComboBox
Typ: int
Der ganzzahlige Bezeichner des Kombinationsfeld-Steuerelements im Dialogfeld.
Rückgabewert
Typ: BOOL
Wenn die aktuelle Auswahl ein Verzeichnisname ist, ist der Rückgabewert nonzero.
Wenn die aktuelle Auswahl kein Verzeichnisname ist, ist der Rückgabewert 0. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Wenn die aktuelle Auswahl einen Verzeichnisnamen oder laufwerksbuchstaben angibt, entfernt die DlgDirSelectComboBoxEx-Funktion die eingeschlossenen eckigen Klammern (und Bindestriche für Laufwerkbuchstaben), sodass der Name oder der Buchstabe in einen neuen Pfad oder Dateinamen eingefügt werden kann. Wenn keine Auswahl vorhanden ist, ändert sich der Inhalt des Puffers, auf den lpString verweist, nicht.
Die DlgDirSelectComboBoxEx-Funktion lässt nicht zu, dass mehr als ein Dateiname aus einem Kombinationsfeld zurückgegeben wird.
Wenn die Zeichenfolge so lang oder länger als der Puffer ist, enthält der Puffer die abgeschnittene Zeichenfolge mit einem endenden NULL-Zeichen.
DlgDirSelectComboBoxEx sendet CB_GETCURSEL und CB_GETLBTEXT Nachrichten an das Kombinationsfeld.
Sie können diese Funktion mit allen drei Typen von Kombinationsfeldern (CBS_SIMPLE, CBS_DROPDOWN und CBS_DROPDOWNLIST) verwenden.
Sicherheitswarnung: Eine unsachgemäße Verwendung dieser Funktion kann Probleme für Ihre Anwendung verursachen. Für instance sollte der nCount-Parameter sowohl für ANSI- als auch für Unicode-Versionen ordnungsgemäß festgelegt werden. Wenn dies nicht geschieht, kann dies zu einem Pufferüberlauf führen. Sie sollten Sicherheitsüberlegungen: Microsoft Windows-Steuerelemente lesen, bevor Sie fortfahren.
Windows 95 oder höher: DlgDirSelectComboBoxExW wird von Microsoft Layer for Unicode (MSLU) unterstützt. Um dies zu verwenden, müssen Sie Ihrer Anwendung bestimmte Dateien hinzufügen, wie in Microsoft Layer for Unicode auf Windows Me/98/95-Systemen beschrieben.
Hinweis
Der winuser.h-Header definiert DlgDirSelectComboBoxEx als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winuser.h (einschließlich Windows.h) |
| Bibliothek | User32.lib |
| DLL | User32.dll |
Weitere Informationen
Referenz