DlgDirSelectComboBoxExA-Funktion (winuser.h)
Ruft die aktuelle Auswahl aus einem Kombinationsfeld ab, das mithilfe der funktion DlgDirListComboBox gefüllt wird. Die Auswahl wird als Laufwerkbuchstaben, 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 es sich bei der aktuellen Auswahl um einen Verzeichnisnamen handelt, ist der Rückgabewert ungleich Null.
Wenn es sich bei der aktuellen Auswahl nicht um einen Verzeichnisnamen handelt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Wenn die aktuelle Auswahl einen Verzeichnisnamen oder einen Laufwerkbuchstaben angibt, entfernt die funktion DlgDirSelectComboBoxEx die umschließenden eckigen Klammern (und Bindestriche für Laufwerkbuchstaben), damit der Name oder 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.
Die DlgDirSelectComboBoxEx--Funktion lässt nicht zu, dass mehrere Dateinamen aus einem Kombinationsfeld zurückgegeben werden.
Wenn die Zeichenfolge so lang oder länger als der Puffer ist, enthält der Puffer die abgeschnittene Zeichenfolge mit einem endenden Nullzeichen.
DlgDirSelectComboBoxEx sendet CB_GETCURSEL und CB_GETLBTEXT Nachrichten an das Kombinationsfeld.
Sie können diese Funktion mit allen drei Kombinationsfeldern (CBS_SIMPLE, CBS_DROPDOWNund CBS_DROPDOWNLIST) verwenden.
Sicherheitswarnung: Falsche Verwendung dieser Funktion kann zu Problemen für Ihre Anwendung führen. Beispielsweise sollte der nCount Parameter für ANSI- und Unicode-Versionen ordnungsgemäß festgelegt werden. Dies kann zu einem Pufferüberlauf führen. Sie sollten Sicherheitsüberlegungen überprüfen: Microsoft Windows Controls, 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 unter Windows Me/98/95 Systemsbeschrieben.
Anmerkung
Der winuser.h-Header definiert DlgDirSelectComboBoxEx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, 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 |
|---|---|
| mindestens unterstützte Client- | Windows Vista [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | winuser.h (enthalten Windows.h) |
| Library | User32.lib |
| DLL- | User32.dll |
Siehe auch
Referenz-