_FILEOPENDIALOGOPTIONS-Enumeration (shobjidl_core.h)

  • Artikel

Definiert den Satz von Optionen, die für ein Dialogfeld Öffnen oder Speichern verfügbar sind.

Syntax

typedef enum _FILEOPENDIALOGOPTIONS {
  FOS_OVERWRITEPROMPT = 0x2,
  FOS_STRICTFILETYPES = 0x4,
  FOS_NOCHANGEDIR = 0x8,
  FOS_PICKFOLDERS = 0x20,
  FOS_FORCEFILESYSTEM = 0x40,
  FOS_ALLNONSTORAGEITEMS = 0x80,
  FOS_NOVALIDATE = 0x100,
  FOS_ALLOWMULTISELECT = 0x200,
  FOS_PATHMUSTEXIST = 0x800,
  FOS_FILEMUSTEXIST = 0x1000,
  FOS_CREATEPROMPT = 0x2000,
  FOS_SHAREAWARE = 0x4000,
  FOS_NOREADONLYRETURN = 0x8000,
  FOS_NOTESTFILECREATE = 0x10000,
  FOS_HIDEMRUPLACES = 0x20000,
  FOS_HIDEPINNEDPLACES = 0x40000,
  FOS_NODEREFERENCELINKS = 0x100000,
  FOS_OKBUTTONNEEDSINTERACTION = 0x200000,
  FOS_DONTADDTORECENT = 0x2000000,
  FOS_FORCESHOWHIDDEN = 0x10000000,
  FOS_DEFAULTNOMINIMODE = 0x20000000,
  FOS_FORCEPREVIEWPANEON = 0x40000000,
  FOS_SUPPORTSTREAMABLEITEMS = 0x80000000
} ;

Konstanten

 
FOS_OVERWRITEPROMPT
Wert: 0x2
Wenn Sie eine Datei speichern, fordern Sie vor dem Überschreiben einer vorhandenen Datei mit demselben Namen auf. Dies ist ein Standardwert für das Dialogfeld Speichern.
FOS_STRICTFILETYPES
Wert: 0x4
Erlauben Sie dem Benutzer im Dialogfeld Speichern nur die Auswahl einer Datei mit einer der Dateinamenerweiterungen, die über IFileDialog::SetFileTypes angegeben sind.
FOS_NOCHANGEDIR
Wert: 0x8
Ändern Sie nicht das aktuelle Arbeitsverzeichnis.
FOS_PICKFOLDERS
Wert: 0x20
Zeigen Sie ein Dialogfeld Öffnen an, das eine Auswahl von Ordnern anstelle von Dateien bietet.
FOS_FORCEFILESYSTEM
Wert: 0x40
Stellt sicher, dass zurückgegebene Elemente Dateisystemelemente (SFGAO_FILESYSTEM) sind. Beachten Sie, dass dies nicht für Elemente gilt, die von IFileDialog::GetCurrentSelection zurückgegeben werden.
FOS_ALLNONSTORAGEITEMS
Wert: 0x80
Ermöglicht es dem Benutzer, ein beliebiges Element im Shell-Namespace auszuwählen, nicht nur elemente mit SFGAO_STREAM - oder SFAGO_FILESYSTEM-Attributen . Dieses Flag kann nicht mit FOS_FORCEFILESYSTEM kombiniert werden.
FOS_NOVALIDATE
Wert: 0x100
Suchen Sie nicht nach Situationen, die verhindern würden, dass eine Anwendung die ausgewählte Datei öffnet, z. B. Freigabeverletzungen oder Zugriff verweigerte Fehler.
FOS_ALLOWMULTISELECT
Wert: 0x200
Ermöglicht dem Benutzer, mehrere Elemente im geöffneten Dialogfeld auszuwählen. Beachten Sie, dass beim Festlegen dieses Flags die IFileOpenDialog-Schnittstelle verwendet werden muss, um diese Elemente abzurufen.
FOS_PATHMUSTEXIST
Wert: 0x800
Das zurückgegebene Element muss sich in einem vorhandenen Ordner befinden. Dies ist ein Standardwert.
FOS_FILEMUSTEXIST
Wert: 0x1000
Das zurückgegebene Element muss vorhanden sein. Dies ist ein Standardwert für das Dialogfeld Öffnen.
FOS_CREATEPROMPT
Wert: 0x2000
Fordern Sie zur Erstellung auf, wenn das im geöffneten Dialogfeld zurückgegebene Element nicht vorhanden ist. Beachten Sie, dass das Element dadurch nicht tatsächlich erstellt wird.
FOS_SHAREAWARE
Wert: 0x4000
Im Fall einer Freigabeverletzung beim Öffnen einer Datei durch eine Anwendung rufen Sie die Anwendung über OnShareViolation als Anleitung zurück. Dieses Flag wird von FOS_NOVALIDATE überschrieben.
FOS_NOREADONLYRETURN
Wert: 0x8000
Geben Sie keine schreibgeschützten Elemente zurück. Dies ist ein Standardwert für das Dialogfeld Speichern.
FOS_NOTESTFILECREATE
Wert: 0x10000
Testen Sie nicht, ob die Im Dialogfeld Speichern angegebene Erstellung des Elements erfolgreich war. Wenn dieses Flag nicht festgelegt ist, muss die aufrufende Anwendung Fehler behandeln, z. B. Denial of Access, die beim Erstellen des Elements ermittelt werden.
FOS_HIDEMRUPLACES
Wert: 0x20000
Blenden Sie die Liste der Orte aus, an denen der Benutzer zuletzt Elemente geöffnet oder gespeichert hat. Dieser Wert wird ab Windows 7 nicht mehr unterstützt.
FOS_HIDEPINNEDPLACES
Wert: 0x40000
Blenden Sie standardmäßig im Navigationsbereich der Ansicht angezeigte Elemente aus. Dieses Flag wird häufig in Verbindung mit der IFileDialog::AddPlace-Methode verwendet, um Standardspeicherorte auszublenden und durch benutzerdefinierte Speicherorte zu ersetzen.

Windows 7 und höher. Blenden Sie alle Standardnamespacespeicherorte (z. B. Favoriten, Bibliotheken, Computer und Netzwerk) aus, die im Navigationsbereich angezeigt werden.

Windows Vista. Blenden Sie den Inhalt der Struktur "Favoritenlinks" im Navigationsbereich aus. Beachten Sie, dass die Kategorie selbst weiterhin angezeigt wird, aber als leer angezeigt wird.
FOS_NODEREFERENCELINKS
Wert: 0x100000
Verknüpfungen sollten nicht als Zielelemente behandelt werden. Dadurch kann eine Anwendung eine LNK-Datei öffnen und nicht die Verknüpfung dieser Datei.
FOS_OKBUTTONNEEDSINTERACTION
Wert: 0x200000
Die Schaltfläche OK wird deaktiviert, bis der Benutzer in der Ansicht navigiert oder den Dateinamen bearbeitet (falls zutreffend). Hinweis: Das Deaktivieren der Schaltfläche OK verhindert nicht, dass das Dialogfeld durch die Eingabetaste gesendet wird.
FOS_DONTADDTORECENT
Wert: 0x2000000
Fügen Sie das geöffnete oder gespeicherte Element nicht der Liste der zuletzt verwendeten Dokumente (SHAddToRecentDocs) hinzu.
FOS_FORCESHOWHIDDEN
Wert: 0x10000000
Schließen Sie ausgeblendete Elemente und Systemelemente ein.
FOS_DEFAULTNOMINIMODE
Wert: 0x20000000
Gibt im Dialogfeld Speichern unter an, dass es im erweiterten Modus geöffnet werden soll. Erweiterter Modus ist der Modus, der festgelegt und aufgehoben wird, indem Sie auf die Schaltfläche in der unteren linken Ecke des Dialogfelds Speichern unter klicken, das zwischen Ordner durchsuchen und Ordner ausblenden wechselt, wenn darauf geklickt wird. Dieser Wert wird ab Windows 7 nicht mehr unterstützt.
FOS_FORCEPREVIEWPANEON
Wert: 0x40000000
Gibt im Dialogfeld Öffnen an, dass der Vorschaubereich immer angezeigt werden soll.
FOS_SUPPORTSTREAMABLEITEMS
Wert: 0x80000000
Gibt an, dass der Aufrufer eine Datei als Stream (BHID_Stream) öffnet, sodass diese Datei nicht heruntergeladen werden muss.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile shobjidl_core.h (einschließlich Shobjidl.h)

Weitere Informationen

IFileDialog::GetOptions

IFileDialog::SetOptions

IFileSaveDialog::GetOptions

IFileSaveDialog::SetOptions