_FILEOPENDIALOGOPTIONS 枚举 (shobjidl_core.h)

定义可用于“打开”或“保存”对话框的选项集。

语法

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
} ;

常量

 
FOS_OVERWRITEPROMPT
值: 0x2
保存文件时,在覆盖同名的现有文件之前进行提示。 这是“保存”对话框的默认值。
FOS_STRICTFILETYPES
值: 0x4
在“保存”对话框中,仅允许用户选择具有通过 IFileDialog::SetFileTypes 指定的文件扩展名之一的文件。
FOS_NOCHANGEDIR
值: 0x8
不要更改当前工作目录。
FOS_PICKFOLDERS
值: 0x20
显示一个“打开”对话框,该对话框提供文件夹(而不是文件)选项。
FOS_FORCEFILESYSTEM
值: 0x40
确保返回的项是文件系统项 (SFGAO_FILESYSTEM) 。 请注意,这不适用于 IFileDialog::GetCurrentSelection 返回的项。
FOS_ALLNONSTORAGEITEMS
值: 0x80
允许用户选择 Shell 命名空间中的任何项,而不仅仅是具有 SFGAO_STREAMSFAGO_FILESYSTEM 属性的项。 此标志不能与FOS_FORCEFILESYSTEM组合使用。
FOS_NOVALIDATE
值: 0x100
对于阻止应用程序打开所选文件的情况(例如共享冲突或拒绝访问错误),请不要检查。
FOS_ALLOWMULTISELECT
值: 0x200
使用户能够在打开的对话框中选择多个项目。 请注意,设置此标志时,必须使用 IFileOpenDialog 接口来检索这些项目。
FOS_PATHMUSTEXIST
值: 0x800
返回的项目必须位于现有文件夹中。 这是默认值。
FOS_FILEMUSTEXIST
值: 0x1000
返回的项必须存在。 这是“打开”对话框的默认值。
FOS_CREATEPROMPT
值: 0x2000
如果打开的对话框中返回的项不存在,则提示创建。 请注意,这实际上不会创建项。
FOS_SHAREAWARE
值: 0x4000
如果应用程序打开文件时发生共享冲突,请通过 OnShareViolation 回调应用程序以获取指导。 此标志由 FOS_NOVALIDATE 重写。
FOS_NOREADONLYRETURN
值: 0x8000
不返回只读项。 这是“保存”对话框的默认值。
FOS_NOTESTFILECREATE
值: 0x10000
不要测试是否成功创建“保存”对话框中指定的项。 如果未设置此标志,则调用应用程序必须处理创建项时发现的错误,例如拒绝访问。
FOS_HIDEMRUPLACES
值: 0x20000
隐藏用户最近打开或保存项目的位置列表。 从 Windows 7 开始不支持此值。
FOS_HIDEPINNEDPLACES
值: 0x40000
隐藏视图导航窗格中默认显示的项。 此标志通常与 IFileDialog::AddPlace 方法结合使用,以隐藏标准位置并将其替换为自定义位置。

Windows 7 及更高版本。 隐藏导航窗格中显示的所有标准命名空间位置 (,例如收藏夹、库、计算机和网络) 。

Windows Vista。 隐藏导航窗格中“ 收藏夹链接” 树的内容。 请注意,类别本身仍显示,但显示为空。
FOS_NODEREFERENCELINKS
值: 0x100000
不应将快捷方式视为其目标项。 这允许应用程序打开 .lnk 文件,而不是该文件的快捷方式。
FOS_OKBUTTONNEEDSINTERACTION
值: 0x200000
将禁用“确定”按钮,直到用户导航视图或编辑文件名 ((如果适用) )。 注意:禁用“确定”按钮不会阻止按 Enter 键提交对话框。
FOS_DONTADDTORECENT
值: 0x2000000
请勿将打开或保存的项目添加到 SHAddToRecentDocs) (最近打开或保存的文档列表。
FOS_FORCESHOWHIDDEN
值: 0x10000000
包括隐藏项和系统项。
FOS_DEFAULTNOMINIMODE
值: 0x20000000
向“ 另存为 ”对话框指示它应在展开模式下打开。 展开模式是通过单击“ 另存为 ”对话框左下角的按钮设置和取消设置的模式,该按钮在单击时可在“ 浏览文件夹” 和“ 隐藏文件夹” 之间切换。 从 Windows 7 开始不支持此值。
FOS_FORCEPREVIEWPANEON
值: 0x40000000
向“ 打开 ”对话框指示应始终显示预览窗格。
FOS_SUPPORTSTREAMABLEITEMS
值: 0x80000000
指示调用方正在以流 (BHID_Stream) 打开 文件,因此无需下载该文件。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 shobjidl_core.h (包括 Shobjidl.h)

请参阅

IFileDialog::GetOptions

IFileDialog::SetOptions

IFileSaveDialog::GetOptions

IFileSaveDialog::SetOptions