GetOpenFileName

Funkcja GetOpenFileName tworzy otworzyć wspólne okno dialogowe, które pozwala użytkownikowi określenie dysku, katalogu i nazwę pliku lub zestawu plików, aby otworzyć.

(BOOL GetOpenFileName LPOPENFILENAME  lpofn / / adresu struktury z inicjowania / / danych);
 

Parametry

lpofn
Wskaźnik do struktury OPENFILENAME , który zawiera informacje używane do inicjowania okna dialogowego. Po GetOpenFileName , ta struktura zawiera informacje o wybór pliku użytkownika.

Zwraca wartości

Jeśli użytkownik określa nazwę pliku i klika przycisk OK , wartość zwracany jest różna od zera. Bufor wskazywanego przez członka lpstrFile struktury OPENFILENAME zawiera pełną ścieżkę i nazwę pliku określonego przez użytkownika.

Jeśli użytkownik anuluje lub zamyka otwarte okno dialogowe lub wystąpi błąd, wartość zwracany jest równa zero. Aby uzyskać informacje o błąd rozszerzony, wywołać funkcję CommDlgExtendedError , która może zwracać jeden z następujących wartości:

CDERR_FINDRESFAILURE CDERR_NOHINSTANCE
CDERR_INITIALIZATION CDERR_NOHOOK
CDERR_LOCKRESFAILURE CDERR_NOTEMPLATE
CDERR_LOADRESFAILURE CDERR_STRUCTSIZE
CDERR_LOADSTRFAILURE FNERR_BUFFERTOOSMALL
CDERR_MEMALLOCFAILURE FNERR_INVALIDFILENAME
CDERR_MEMLOCKFAILURE FNERR_SUBCLASSFAILURE

Uwagi

Począwszy od Windows 95 i Windows NT w wersji 4.0, Otwórz okno dialogowe domyślne zapewnia funkcje interfejsu użytkownika, które są podobne do okna programu Eksplorator. Procedura haka OFNHookProc może przewidywać stylu Eksploratora otwarte okno dialogowe. Aby włączyć procedura haka, ustawić flagi OFN_EXPLORER i OFN_ENABLEHOOK w Państwa flag struktury OPENFILENAME i określić adres procedura haka członka lpfnHook.

System Windows 95 i Windows NT dalej wspierać starym stylu otwarte okno dialogowe dla aplikacji, które chcą utrzymać interfejs użytkownika zgodny z systemu Windows 3.1 lub interfejs użytkownika systemu Windows NT 3.51. Aby wyświetlić starym stylu otwarte okno dialogowe, Włącz procedura haka OFNHookProcOldStyle i zapewnienia, że nie jest ustawiona flaga OFN_EXPLORER.

Aby wyświetlić okno dialogowe, które pozwala użytkownikowi wybrać katalog zamiast pliku, wywołanie SHBrowseForFolder funkcji.

Systemu Windows CE: Nie wszystkie elementy konstrukcji OPENFILENAME są zdefiniowane w systemu Windows CE. Dla informacji na temat określonych członków zobacz temat odniesienia do struktury OPENFILENAME.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w commdlg.h.
Importowanie biblioteki:Należy użyć comdlg32.lib.
Unicode:Implementowane jako wersje Unicode i ANSI w systemie Windows NT.

Zobacz też

Wspólny omówienie biblioteki okna dialogowego, wspólne okno dialogowe Funkcje, CommDlgExtendedError, GetSaveFileName, OFNHookProc , OFNHookProcOldStyle, OPENFILENAME, SHBrowseForFolder

Index