GetOpenFileName

Die Funktion GetOpenFileName erstellt Öffnen häufig ein Dialogfeld, in dem den Benutzer das Laufwerk, Verzeichnis und den Namen einer Datei oder mehrere Dateien zum Öffnen angeben können.

BOOL GetOpenFileName) LPOPENFILENAME  Lpofn / / Adresse der Struktur mit der Initialisierung / / Daten);
 

Parameter

lpofn
Zeiger auf eine OPENFILENAME -Struktur, die Informationen verwendet, um das Dialogfeld zu initialisieren enthält. GetOpenFileName gibt diese Struktur enthält Informationen über die Auswahl des Benutzers Datei.

Rückgabewerte

Wenn der Benutzer einen Dateinamen angibt und auf die Schaltfläche OK klickt, ist der Rückgabewert ungleich NULL. Der Puffer, auf den der LpstrFile -Member der OPENFILENAME -Struktur enthält den vollständigen Pfad und Dateinamen, die vom Benutzer angegebenen.

Wenn der Benutzer abbricht oder schließt das Dialogfeld Öffnen oder ein Fehler auftritt, ist der Rückgabewert 0 (null). Um erweiterte Fehlerinformationen abzurufen, rufen Sie die CommDlgExtendedError -Funktion, die einen der folgenden Werte zurückgeben, können:

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

Bemerkungen

Ab Windows 95 und Windows NT, Version 4.0 bietet das Standarddialogfeld Öffnen Benutzeroberflächen-Features, die im Windows-Explorer ähnlich sind. Sie können eine OFNHookProc -Hook-Prozedur für eine Explorer-Stil Öffnen Dialogfeld bereitstellen. Um die Hook-Prozedur zu aktivieren, legen Sie die Flags OFN_EXPLORER und OFN_ENABLEHOOK im Flags -Member der OPENFILENAME -Struktur, und geben Sie die Adresse der die Hook-Prozedur in der LpfnHook -member.

Windows 95 und Windows NT weiterhin den alten Stil im Dialogfeld Öffnen der Unterstützung für Anwendungen, die eine Benutzeroberfläche mit Windows 3.1 oder Windows NT 3.51-Benutzeroberfläche konsistent beibehalten werden soll. Um den alten Stil das Dialogfeld Öffnen anzuzeigen, aktivieren Sie eine OFNHookProcOldStyle -Hook-Prozedur und sicherzustellen Sie, dass das OFN_EXPLORER-Flag nicht gesetzt ist.

Um ein Dialogfeld anzuzeigen, die dem Benutzer ermöglicht, ein Verzeichnis anstelle einer Datei wählen, rufen Sie die SHBrowseForFolder -Funktion.

Windows CE: In Windows CE sind nicht alle Member der OPENFILENAME -Struktur definiert. Informationen über die definierten Elemente finden Sie im Referenzthema für die OPENFILENAME -Struktur.

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Version 1.0 oder höher benötigt.
Header:In commdlg.h deklariert.
Importieren Bibliothek:Verwenden Sie comdlg32.lib.
Unicode:Als Unicode und ANSI-Versionen unter Windows NT implementiert.

Siehe auch

Übersicht über Common Dialog Box Library, Standarddialogfeld Funktionen, CommDlgExtendedError, GetSaveFileName, OFNHookProc , OFNHookProcOldStyle, OPENFILENAME, SHBrowseForFolder

Index