Funzione DlgDirSelectComboBoxExA (winuser.h)

Articolo
08/27/2023

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 DlgDirSelectComboBoxExA(
  [in]  HWND  hwndDlg,
  [out] LPSTR 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

CB_GETCURSEL

CB_GETLBTEXT

DlgDirListComboBox

Riferimento

Condividi tramite