Funzione DlgDirSelectComboBoxExW (winuser.h)

Articolo
11/20/2024

Recupera la selezione corrente da una casella combinata riempita utilizzando 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 per la 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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

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 di 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 di terminazione.

DlgDirSelectComboBoxEx invia messaggi CB_GETCURSEL e CB_GETLBTEXT alla casella combinata.

È possibile usare questa funzione con tutti e tre i tipi di caselle combinate (CBS_SIMPLE, CBS_DROPDOWNe CBS_DROPDOWNLIST).

avviso di sicurezza: uso improprio di questa funzione può causare problemi per l'applicazione. Ad esempio, il parametro nCount deve essere impostato correttamente per entrambe le versioni ANSI e Unicode. In caso contrario, potrebbe verificarsi un overflow del buffer. Prima di continuare, esaminare Considerazioni sulla sicurezza: Controlli di Microsoft Windows.

windows 95 o versioni successive: DlgDirSelectComboBoxExW è supportato dal livello Microsoft per Unicode (MSLU). A tale scopo, è necessario aggiungere determinati file all'applicazione, come descritto in Livello Microsoft per Unicode nei sistemi Windows Me/98/95.

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winuser.h (include Windows.h)
libreria	User32.lib
dll	User32.dll

Vedere anche

CB_GETCURSEL

CB_GETLBTEXT

DlgDirListComboBox

riferimento

Condividi tramite