sw::FileDialog类 参考

“打开文件”对话框与“另存为”对话框的基类 更多...

#include <FileDialog.h>

类 sw::FileDialog 继承关系图:

Public 成员函数
	FileDialog ()
	初始化FileDialog
void	SetFilter (const FileFilter &filter)
	设置筛选器
virtual void	Close () override
	FileDialog默认不支持该函数，调用该函数不会执行任何操作
virtual void	Show () override
	FileDialog默认不支持该函数，调用该函数不会执行任何操作
virtual int	ShowDialog (Window *owner=nullptr) override=0
	显示对话框，并指定所有者窗口
virtual int	ShowDialog (Window &owner)=0
	显示对话框，并指定所有者窗口
Public 成员函数 继承自 sw::IDialog
virtual	~IDialog ()=default
	默认虚析构函数

Public 属性
const Property< int >	BufferSize
	储存文件名的缓冲区大小，值不能小于MAX_PATH
const Property< FileDialogFlags >	Flags
	对话框标志
const Property< std::wstring >	Title
	对话框标题，设为空字符串可显示默认标题
const Property< std::wstring >	InitialDir
	初始目录
const ReadOnlyProperty< FileFilter * >	Filter
	筛选器
const Property< int >	FilterIndex
	当前筛选器的索引，索引值从0开始
const ReadOnlyProperty< std::wstring >	FileName
	选中文件的路径
const Property< bool >	MultiSelect
	是否允许多选
const ReadOnlyProperty< sw::List< std::wstring > >	FileNames
	所有选中的文件路径

Protected 成员函数
OPENFILENAMEW *	GetOFN ()
	获取OPENFILENAMEW指针
wchar_t *	GetBuffer ()
	获取指向缓冲区的指针
void	ClearBuffer ()
	清空缓冲区，显示对话框前必须调用此函数
virtual void	ProcessFileName (std::wstring &fileName)
	处理文件路径，获取文件路径时会先调用这个函数对返回值进行处理

详细描述

“打开文件”对话框与“另存为”对话框的基类

成员函数说明

Close()

virtual void sw::FileDialog::Close ( )

overridevirtual

FileDialog默认不支持该函数，调用该函数不会执行任何操作

实现了 sw::IDialog.

ProcessFileName()

virtual void sw::FileDialog::ProcessFileName ( std::wstring &  fileName )

protectedvirtual

处理文件路径，获取文件路径时会先调用这个函数对返回值进行处理

参数

fileName

获取到的文件路径，可通过修改该值改变FileName和FileNames属性获取到的内容

被 sw::SaveFileDialog 重载.

SetFilter()

void sw::FileDialog::SetFilter

(

const FileFilter &

filter

)

设置筛选器

参数

filter

筛选器

Show()

virtual void sw::FileDialog::Show ( )

overridevirtual

FileDialog默认不支持该函数，调用该函数不会执行任何操作

实现了 sw::IDialog.

ShowDialog() [1/2]

virtual int sw::FileDialog::ShowDialog ( Window &  owner )

pure virtual

显示对话框，并指定所有者窗口

返回

若用户选择了文件则返回true，否则返回false

在 sw::OpenFileDialog , 以及 sw::SaveFileDialog 内被实现.

ShowDialog() [2/2]

virtual int sw::FileDialog::ShowDialog ( Window *  owner = nullptr )

overridepure virtual

显示对话框，并指定所有者窗口

返回

若用户选择了文件则返回true，否则返回false

实现了 sw::IDialog.

在 sw::OpenFileDialog , 以及 sw::SaveFileDialog 内被实现.

---

该类的文档由以下文件生成:

• FileDialog.h