带有选择文件按钮的文本编辑框. 更多...

类 Dtk::Widget::DFileChooserEdit 继承关系图:

[图例]

Dtk::Widget::DFileChooserEdit 的协作图:

[图例]

Public 类型
enum	DialogDisplayPosition { FollowParentWindow , CurrentMonitorCenter }

信号
void	fileChoosed (const QString &fileName)
	这个信号在文件被选择且点击了对话框的确认按钮之后被调用 fileName 被选中的文件名，包含其绝对路径

void	dialogOpened ()
	这个信号在对话框即将显示时被调用更多...

void	dialogClosed (int code)
	这信号在对话框关闭时被调用，无论对话框是被点击了确认还是取消，都会调用本信号 code 对话框的返回码，返回码表示了对话框是因为点击了取消还是确认而关闭的更多...

信号继承自 Dtk::Widget::DLineEdit
void	alertChanged (bool alert) const

void	focusChanged (bool onFocus) const

void	textChanged (const QString &)

void	textEdited (const QString &)

void	cursorPositionChanged (int, int)

void	returnPressed ()

void	editingFinished ()

void	selectionChanged ()

Public 成员函数
	DFileChooserEdit (QWidget *parent=nullptr)
	获取 DFileChooserEdit 的一个实例 parent 作为实例的父控件

void	setFileMode (QFileDialog::FileMode mode)
	设置文件选择模式 mode 要使用的模式更多...

QFileDialog::FileMode	fileMode () const
	获取对话框选择文件模式更多...

void	setNameFilters (const QStringList &filters)
	设置文件名过滤器 filters 要使用的文件名过滤器组成的列表更多...

QStringList	nameFilters () const
	文件名过滤器更多...

void	setDirectoryUrl (const QUrl &directory)

QUrl	directoryUrl ()

void	setDialogDisplayPosition (DialogDisplayPosition dialogDisplayPosition)
	设置对话框显示位置. 更多...

DFileChooserEdit::DialogDisplayPosition	dialogDisplayPosition () const
	这个属性保存文件选择对话框将会出现的位置更多...

void	setFileDialog (QFileDialog *fileDialog)

QFileDialog *	fileDialog () const

void	initDialog ()

Public 成员函数继承自 Dtk::Widget::DLineEdit
	DLineEdit (QWidget *parent=nullptr)
	DLineEdit的构造函数 parent 参数被发送到 QWidget 构造函数。

QLineEdit *	lineEdit () const
	返回 QLineEdit 对象. 更多...

void	setPlaceholderText (const QString &)

void	setAlert (bool isAlert)

bool	isAlert () const

void	showAlertMessage (const QString &text, int duration=3000)

void	showAlertMessage (const QString &text, QWidget *follower, int duration=3000)
	显示警告消息. 更多...

void	setAlertMessageAlignment (Qt::Alignment alignment)
	指定对齐方式. 更多...

Qt::Alignment	alertMessageAlignment () const

void	hideAlertMessage ()
	隐藏警告消息框.

void	setLeftWidgets (const QList< QWidget * > &list)
	向输入框左侧添加控件. 更多...

void	setRightWidgets (const QList< QWidget * > &list)
	向输入框右侧添加控件. 更多...

void	setLeftWidgetsVisible (bool visible)
	是否隐藏输入框左侧控件. 更多...

void	setRightWidgetsVisible (bool visible)
	是否隐藏输入框右侧控件. 更多...

void	setClearButtonEnabled (bool enable)
	设置清除按钮是否可见. 更多...

bool	isClearButtonEnabled () const
	返回清除按钮是否可见. 更多...

void	setText (const QString &text)
	设置显示的文本. 更多...

QString	text ()
	返回当前显示的文本. 更多...

void	clear ()
	清空编辑的内容.

QLineEdit::EchoMode	echoMode () const
	返回输入框的回显模式. 更多...

void	setEchoMode (QLineEdit::EchoMode mode)
	设置回显的模式. 更多...

void	setContextMenuPolicy (Qt::ContextMenuPolicy policy)
	设置行编辑控件的文本菜单策略. 更多...

bool	speechToTextIsEnabled () const
	返回是否显示语音听写菜单项. 更多...

void	setSpeechToTextEnabled (bool enable)
	设置是否显示语音听写菜单项. 更多...

bool	textToSpeechIsEnabled () const
	返回是否显示语音朗读菜单项. 更多...

void	setTextToSpeechEnabled (bool enable)
	设置是否显示语音朗读菜单项. 更多...

bool	textToTranslateIsEnabled () const
	返回是否显示文本翻译菜单项. 更多...

void	setTextToTranslateEnabled (bool enable)
	设置是否显示文本翻译菜单项更多...

bool	copyEnabled () const
	DLineEdit::copyEnabled 更多...

void	setCopyEnabled (bool enable)
	DLineEdit::setCopyEnabled 设置输入文本是否可拷贝 enabled　true输入文本可拷贝　false不可拷贝

bool	cutEnabled () const
	DLineEdit::cutEnabled 更多...

void	setCutEnabled (bool enable)
	DLineEdit::setCutEnabled 设置输入文本是否可拷贝 enabled　true输入文本可剪切　false不可剪切

额外继承的成员函数
Protected 成员函数继承自 Dtk::Widget::DLineEdit
	DLineEdit (DLineEditPrivate &q, QWidget *parent)

bool	eventFilter (QObject watched, QEvent event) override
	事件过滤器更多...

bool	event (QEvent *event) override

属性继承自 Dtk::Widget::DLineEdit
bool	alert
	警告模式属性. 更多...

详细描述

带有选择文件按钮的文本编辑框.

\inmodule dtkwidget

本控件基本与 DLineEdit 相同，但同时在编辑框的右侧提供了一个按钮，点击按钮将会出现一个选择文件的对话框，当在对话框中选择完毕点击确定之后，选择的结果将会出现在文本编辑框中。另外还提供了设置对话框出现的位置，选择文件的类型，或设置文件名过滤器的方法以定制控件的功能。

参见: DLineEdit QFileDialog

成员函数说明

◆ dialogClosed

void Dtk::Widget::DFileChooserEdit::dialogClosed ( int code )

signal

这信号在对话框关闭时被调用，无论对话框是被点击了确认还是取消，都会调用本信号 code 对话框的返回码，返回码表示了对话框是因为点击了取消还是确认而关闭的

参见: QDialog::DialogCode

◆ dialogDisplayPosition()

DFileChooserEdit::DialogDisplayPosition Dtk::Widget::DFileChooserEdit::dialogDisplayPosition ( ) const

这个属性保存文件选择对话框将会出现的位置

可选值为枚举 DFileChooserEdit::DialogDisplayPosition 中的值

Getter: DFileChooserEdit::dialogDisplayPosition , Setter: DFileChooserEdit::setDialogDisplayPosition

参见: DFileChooserEdit::DialogDisplayPosition

◆ dialogOpened

void Dtk::Widget::DFileChooserEdit::dialogOpened ( )

signal

这个信号在对话框即将显示时被调用

注解: 注意，此时对话框并没有显示

◆ fileMode()

QFileDialog::FileMode Dtk::Widget::DFileChooserEdit::fileMode ( ) const

获取对话框选择文件模式

有多种类型的选择模式，也就是说对话框可以有多种显示或行为，例如选择单个文件，选择多个文件亦或选择一个目录等，详细可以查阅：QFileDialog::FileMode

返回: 返回但前的选择模式

参见: QFileDialog::FileMode

注解: 目前本控件只支持选择单个文件，即便调用 DFileChooserEdit::setFileMode 设置了选择模式，当有多个文件在对话框中被选中时，取其第一个作为选择结果

◆ nameFilters()

QStringList Dtk::Widget::DFileChooserEdit::nameFilters ( ) const

文件名过滤器

默认此选项为空，即所有文件都可以被选择，当文件名过滤器被设置后，则只有文件名与过滤器匹配的文件可以被选择，例如：设置了"*.txt"，则表示只有后缀名为"txt"的文件可以被选择，或者同时设置了多个过滤器：QStringList() << "text file (*.txt)" << "picture file (*.png); 则会在文件选择对话框的下方出现设置的多个过滤选项，只是需要注意，一次只能使用一个过滤选项，也就是说不能同时即允许选择txt文件又允许选择png文件

返回: 返回当前的文件名过滤器组成的列表

参见: DFileChooserEdit::setNameFilters

◆ setDialogDisplayPosition()

void Dtk::Widget::DFileChooserEdit::setDialogDisplayPosition ( DFileChooserEdit::DialogDisplayPosition dialogDisplayPosition )

设置对话框显示位置.

dialogDisplayPosition 对话框的显示位置.

参见: DFileChooserEdit::dialogDisplayPosition

◆ setFileMode()

void Dtk::Widget::DFileChooserEdit::setFileMode ( QFileDialog::FileMode mode )

设置文件选择模式 mode 要使用的模式

参见: DFileChooserEdit::fileMode

◆ setNameFilters()

void Dtk::Widget::DFileChooserEdit::setNameFilters ( const QStringList & filters )

设置文件名过滤器 filters 要使用的文件名过滤器组成的列表

参见: DFileChooserEdit::nameFilters

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

include/dtkwidget/widgets/dfilechooseredit.h
src/widgets/dfilechooseredit.cpp

Public 类型

信号

Public 成员函数

额外继承的成员函数