Funzione DlgDirSelectComboBoxExW (winuser.h)
Recupera la selezione corrente da una casella combinata compilata usando la funzione DlgDirListComboBox . La selezione viene interpretata come lettera di unità, un file o un nome di directory.
Sintassi
BOOL DlgDirSelectComboBoxExW(
[in] HWND hwndDlg,
[out] LPWSTR lpString,
[in] int cchOut,
[in] int idComboBox
);
Parametri
[in] hwndDlg
Tipo: HWND
Handle della finestra di dialogo contenente la casella combinata.
[out] lpString
Tipo: LPTSTR
Puntatore al buffer che riceve il percorso selezionato.
[in] cchOut
Tipo: int
Lunghezza, in caratteri, del buffer a cui punta il parametro lpString .
[in] idComboBox
Tipo: int
Identificatore intero del controllo casella combinata nella finestra di dialogo.
Valore restituito
Tipo: BOOL
Se la selezione corrente è un nome di directory, il valore restituito è diverso da zero.
Se la selezione corrente non è un nome di directory, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Se la selezione corrente specifica un nome di directory o una lettera di unità, la funzione DlgDirSelectComboBoxEx rimuove le parentesi quadre racchiuse (e trattini per le lettere unità) in modo che il nome o la lettera sia pronto per essere inserito in un nuovo percorso o nome file. Se non è presente alcuna selezione, il contenuto del buffer a cui punta lpString non cambia.
La funzione DlgDirSelectComboBoxEx non consente la restituzione di più nomi di file da una casella combinata.
Se la stringa è lunga o più lunga del buffer, il buffer contiene la stringa troncata con un carattere Null terminante.
DlgDirSelectComboBoxEx invia CB_GETCURSEL e CB_GETLBTEXT messaggi alla casella combinata.
È possibile usare questa funzione con tutti e tre i tipi di caselle combinate (CBS_SIMPLE, CBS_DROPDOWN e CBS_DROPDOWNLIST).
Avviso di sicurezza: L'uso improprio di questa funzione può causare problemi per l'applicazione. Ad esempio, il parametro nCount deve essere impostato correttamente per le versioni ANSI e Unicode. Non è possibile eseguire questa operazione in modo da causare un overflow del buffer. È consigliabile esaminare le considerazioni sulla sicurezza: Controlli Microsoft Windows prima di continuare.
Windows 95 o versione successiva: DlgDirSelectComboBoxExW è supportato da Microsoft Layer for Unicode (MSLU). Per usarlo, è necessario aggiungere determinati file all'applicazione, come descritto in Microsoft Layer for Unicode in Windows Me/98/95 Systems.
Nota
L'intestazione winuser.h definisce DlgDirSelectComboBoxEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winuser.h (include Windows.h) |
| Libreria | User32.lib |
| DLL | User32.dll |
Vedi anche
Riferimento