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);
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 |
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.
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.
Spoločné Prehľad dialógového okna Knižnica, spoločné dialógové okno funkcie, CommDlgExtendedError, GetSaveFileName, OFNHookProc , OFNHookProcOldStyle, OPENFILENAME, SHBrowseForFolder