DSearchEdit 类提供了专门用来进行搜索的输入框控件. 更多...

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

信号
void	voiceInputFinished ()

void	searchAborted ()

void	voiceChanged ()

信号继承自 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 ()
	按下Return键或Enter键会发出此信号

void	editingFinished ()
	当按下Return或Enter键或文本字段失去焦点时会发出此信号

void	selectionChanged ()
	每当选择更改时会发出此信号

Public 成员函数
	DSearchEdit (QWidget *parent=nullptr)
	DSearchEdit 类的构造函数.

void	setPlaceHolder (QString placeHolder)
	set gray placeholder text

QString	placeHolder () const
	返回占位符文本

void	clear ()

void	clearEdit ()
	清除内容，退出编辑状态

bool	isVoiceInput () const

void	setPlaceholderText (const QString &text)

QString	placeholderText () const

Public 成员函数继承自 Dtk::Widget::DLineEdit
	DLineEdit (QWidget *parent=nullptr)
	DLineEdit的构造函数

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)
	向输入框左侧添加控件将 QList 里的控件插入到输入框的左侧

void	setRightWidgets (const QList< QWidget * > &list)
	向输入框右侧添加控件将 QList 里的控件插入到输入框的右侧

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
	返回文本是否可拷贝

void	setCopyEnabled (bool enable)
	设置文本是否可拷贝

bool	cutEnabled () const
	返回文本是否可裁切

void	setCutEnabled (bool enable)
	设置输入文本是否可裁切

属性
bool	voiceInput

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

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

bool	eventFilter (QObject watched, QEvent event) override
	事件过滤器该过滤器不做任何过滤动作，但会监控输入框的焦点状态，并发送信号 focusChanged()。

bool	event (QEvent *event) override

详细描述

DSearchEdit 类提供了专门用来进行搜索的输入框控件.

DSearchEdit类继承自 DLineEdit类, 相比于一般的输入框控件, DSearchEdit 提供了搜索按钮指示，用户使用起来会更加自然。如图示：

构造及析构函数说明

◆ DSearchEdit()

DSearchEdit::DSearchEdit ( QWidget * parent = nullptr )

explicit

DSearchEdit 类的构造函数.

参数

[in] parent 父控件。

成员函数说明

◆ placeHolder()

QString DSearchEdit::placeHolder ( ) const

返回占位符文本

返回: 占位符文本内容

◆ setPlaceHolder()

void DSearchEdit::setPlaceHolder ( QString placeHolder )

set gray placeholder text

设置灰色的占位符文本