Funzione GetFileNameFromBrowse (shlobj_core.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 nella finestra che possiede la finestra di dialogo. Questo membro può essere qualsiasi handle di finestra valido oppure può essere NULL se la finestra di dialogo non ha alcun proprietario.

[in, out] pszFilePath

Tipo: PWSTR

Stringa Unicode con terminazione null contenente un nome file usato per inizializzare il controllo Modifica nome file. Questa stringa corrisponde al membro lpstrFile della struttura OPENFILE E viene usato esattamente nello 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 nello stesso modo.

[in] pszDefExt

Tipo: PCWSTR

Stringa Unicode con terminazione null contenente 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 digita 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 usato 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

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlobj_core.h (include Shlobj.h)
Libreria	Shell32.lib
DLL	Shell32.dll (versione 5.0 o successiva)

Vedi anche

Getopenfilename