Funzione GetFileNameFromBrowse (shlobj.h)

[Questa funzione è disponibile tramite Windows XP Service Pack 2 (SP2) e Windows Server 2003. Potrebbe essere modificato o non disponibile nelle versioni successive di Windows.]

Crea una finestra di dialogo Apri in modo che l'utente possa specificare l'unità, la directory e il nome di un file da aprire.

Sintassi

BOOL GetFileNameFromBrowse(
  [in, optional] HWND   hwnd,
  [in, out]      PWSTR  pszFilePath,
                 UINT   cchFilePath,
  [in, optional] PCWSTR pszWorkingDir,
  [in]           PCWSTR pszDefExt,
  [in, optional] PCWSTR pszFilters,
  [in, optional] PCWSTR pszTitle
);

Parametri

[in, optional] hwnd

Tipo: HWND

Handle per la finestra proprietaria della finestra di dialogo. Questo membro può essere qualsiasi handle di finestra valido oppure può essere NULL se la finestra di dialogo non ha proprietario.

[in, out] pszFilePath

Tipo: PWSTR

Stringa Unicode con terminazione Null contenente un nome file utilizzato per inizializzare il controllo di modifica nome file. Questa stringa corrisponde al membro lpstrFile della struttura OPENFILENAME e viene usata esattamente allo stesso modo.

cchFilePath

Tipo: UINT

Numero di caratteri in pszFilePath, incluso il carattere null di terminazione.

[in, optional] pszWorkingDir

Tipo: PCWSTR

Percorso completo del file della directory iniziale. Questa stringa corrisponde al membro lpstrInitialDir della struttura OPENFILENAME e viene usato esattamente allo stesso modo.

[in] pszDefExt

Tipo: PCWSTR

Stringa Unicode con terminazione Null che contiene l'estensione del nome file predefinita. Questa estensione viene aggiunta a pszFilePath se l'utente non specifica un'estensione. La stringa non deve contenere caratteri '.'. Se questa stringa è NULL e l'utente non riesce a digitare un'estensione, non viene aggiunta alcuna estensione.

[in, optional] pszFilters

Tipo: PCWSTR

Stringa Unicode con terminazione Null che definisce il filtro. Questa stringa corrisponde al membro lpstrFilter della struttura OPENFILENAME e viene usata esattamente nello stesso modo.

[in, optional] pszTitle

Tipo: PCWSTR

Stringa Unicode con terminazione Null posizionata nella barra del titolo della finestra di dialogo. Se questo valore è NULL, il sistema usa il titolo predefinito.

Valore restituito

Tipo: BOOL

Se l'utente specifica un nome file e fa clic su OK, il valore restituito è TRUE. Buffer che pszFilePath punta a contiene il percorso completo e il nome file specificati dall'utente. Se l'utente annulla o chiude la finestra di dialogo Apri o si verifica un errore, il valore restituito è FALSE.

Requisiti

Vedi anche

Getopenfilename