GetOpenFileName

GetOpenFileName funkcia vytvára spoločné dialógovom Otvoriť ktoré umožňuje používateľovi zadať jednotky, adresára a názov súboru alebo množiny súborov, ak chcete otvoriť.

BOOL GetOpenFileName ( LPOPENFILENAME  lpofn / / address konštrukcie s Inicializácia / / údajov);
 

Parametre

lpofn
Smerník na štruktúru OPENFILENAME obsahujúci informácie použité pri inicializácii dialógového okna. Keď GetOpenFileName vráti, táto štruktúra obsahuje informácie o výber súborov používateľa.

Note:

Ak používateľ Určuje názov súboru a klikne na tlačidlo OK , vrátená hodnota je nenulové. Medzipamäť poukázal členskými lpstrFile OPENFILENAME štruktúra obsahuje úplnú cestu a názov súboru stanovenú používateľom.

Ak používateľ zruší alebo zavrie dialógové okno Otvoriť alebo vyskytne chyba, vrátená hodnota je nula. Na získanie informácií o rozšírenej chybe, volajte CommDlgExtendedError funkcie môžu vrátiť jeden z nasledovných hodnôt:

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

Poznámky

Počnúc Windows 95 alebo Windows NT verzia 4.0 predvoleného dialógového okna Otvoriť poskytuje funkcie používateľského rozhrania, ktoré sú podobné Windows Exploreru. OFNHookProc príslušná procedúra môže poskytnúť Explorer-štýl Otvoriť dialógového okna. Aby príslušná procedúra nastaviť príznak OFN_EXPLORER a OFN_ENABLEHOOK v členských štátoch vlajok OPENFILENAME štruktúry a zadať adresu príslušná procedúra v členských lpfnHook.

Systém Windows 95 alebo Windows NT naďalej podporovať old-štýl dialógové okno Otvoriť pre aplikácie, ktoré chcete ponechať používateľské rozhranie zlučiteľný s Windows 3.1 alebo Windows NT 3.51 používateľského rozhrania. Zobraziť dialógové okno Otvoriť old-štýl, aby príslušná procedúra OFNHookProcOldStyle a zabezpečiť nie je nastavený príznak OFN_EXPLORER.

Zobrazí dialógové okno, ktoré umožňuje používateľom vybrať adresár namiesto súboru, volajte na číslo SHBrowseForFolder funkcia.

Windows CE: Nie všetci členovia OPENFILENAME štruktúry sú definované v systému Windows CE. Informácie o definované členov, nájdete v téme odkaz pre štruktúru OPENFILENAME.

Stručné informácie

nbsp; Systém Windows &NT: vyžaduje verzia 3.1 alebo novšia.
Windows:Vyžaduje systém Windows 95 alebo novším.
Windows CE:Vyžaduje verziu 1.0 alebo novšiu verziu.
Hlavičky:Deklarovaný v commdlg.h.
Importovať knižnica:Použiť comdlg32.lib.
Unicode:Implementovaný ako Unicode, ANSI verzia v systéme Windows NT.

Pozri tiež

Spoločné Prehľad dialógového okna Knižnica, spoločné dialógové okno funkcie, CommDlgExtendedError, GetSaveFileName, OFNHookProc , OFNHookProcOldStyle, OPENFILENAME, SHBrowseForFolder

Index