DLineEdit一个聚合 QLineEdit 的输入框. 更多...

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

[图例]

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 成员函数
	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 成员函数
	DLineEdit (DLineEditPrivate &q, QWidget *parent)

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

bool	event (QEvent *event) override

属性
bool	alert
	警告模式属性. 更多...

友元
class	DStyleOptionLineEdit

详细描述

DLineEdit一个聚合 QLineEdit 的输入框.

\inmodule dtkwidget

\list

DLineEdit提供了向输入框左右两端插入控件的函数
DLineEdit提供了带警告颜色的输入框
DLineEdit提供了带文本警告消息的输入框 \endlist

成员函数说明

◆ copyEnabled()

bool Dtk::Widget::DLineEdit::copyEnabled ( ) const

DLineEdit::copyEnabled

返回: true文本可拷贝　false不可拷贝

◆ cutEnabled()

bool Dtk::Widget::DLineEdit::cutEnabled ( ) const

DLineEdit::cutEnabled

返回: true文本可剪切　false不可剪切

◆ echoMode()

QLineEdit::EchoMode Dtk::Widget::DLineEdit::echoMode ( ) const

返回输入框的回显模式.

返回: 返回回显的模式

◆ eventFilter()

bool Dtk::Widget::DLineEdit::eventFilter	(	QObject *	watched,
		QEvent *	event
	)

overrideprotected

事件过滤器

watched 被监听的子控件指针， event 待过滤的事件 event 实例.

该过滤器不做任何过滤动作，但会监控输入框的焦点状态，并发送信号 focusChanged()。

返回: 成功过滤返回 true，否则返回 false .

◆ isClearButtonEnabled()

bool Dtk::Widget::DLineEdit::isClearButtonEnabled ( ) const

返回清除按钮是否可见.

返回: true 清除按钮可见 false 清除按钮不可见

◆ lineEdit()

QLineEdit * Dtk::Widget::DLineEdit::lineEdit ( ) const

返回 QLineEdit 对象.

若 DLineEdit 不满足输入框的使用需求，请用此函数抛出的对象

返回

◆ setAlertMessageAlignment()

void Dtk::Widget::DLineEdit::setAlertMessageAlignment ( Qt::Alignment alignment )

指定对齐方式.

现只支持(下)左，(下)右，(下水平)居中，默认左对齐.

注解: 参数为其他时，默认左对齐 alignment 消息对齐方式

◆ setClearButtonEnabled()

void Dtk::Widget::DLineEdit::setClearButtonEnabled ( bool enable )

设置清除按钮是否可见.

enable true 按钮可见 false 按钮不可见

◆ setContextMenuPolicy()

void Dtk::Widget::DLineEdit::setContextMenuPolicy ( Qt::ContextMenuPolicy policy )

设置行编辑控件的文本菜单策略.

policy 显示右键菜单的方式转发实际变量 QLineEdit 的 ContextMenuEvent 消息

参见: QLineEdit::setContextMenuPolicy

◆ setEchoMode()

void Dtk::Widget::DLineEdit::setEchoMode ( QLineEdit::EchoMode mode )

设置回显的模式.

mode 回显的模式

◆ setLeftWidgets()

void Dtk::Widget::DLineEdit::setLeftWidgets ( const QList< QWidget * > & list )

向输入框左侧添加控件.

将 QList 里的控件插入到输入框的左侧

注解: 多次调用，只有最后一次调用生效 list 存储控件的列表

◆ setLeftWidgetsVisible()

void Dtk::Widget::DLineEdit::setLeftWidgetsVisible ( bool visible )

是否隐藏输入框左侧控件.

visible 是否隐藏

◆ setRightWidgets()

void Dtk::Widget::DLineEdit::setRightWidgets ( const QList< QWidget * > & list )

向输入框右侧添加控件.

将 QList 里的控件插入到输入框的右侧

注解: 多次调用，只有最后一次调用生效 list 存储控件的列表

◆ setRightWidgetsVisible()

void Dtk::Widget::DLineEdit::setRightWidgetsVisible ( bool visible )

是否隐藏输入框右侧控件.

visible 是否隐藏

◆ setSpeechToTextEnabled()

void Dtk::Widget::DLineEdit::setSpeechToTextEnabled ( bool enable )

设置是否显示语音听写菜单项.

enable true显示 flase不显示

◆ setText()

void Dtk::Widget::DLineEdit::setText ( const QString & text )

设置显示的文本.

text 显示的文本

◆ setTextToSpeechEnabled()

void Dtk::Widget::DLineEdit::setTextToSpeechEnabled ( bool enable )

设置是否显示语音朗读菜单项.

enable true显示 flase不显示

◆ setTextToTranslateEnabled()

void Dtk::Widget::DLineEdit::setTextToTranslateEnabled ( bool enable )

设置是否显示文本翻译菜单项

enable true显示 flase不显示

◆ showAlertMessage()

void Dtk::Widget::DLineEdit::showAlertMessage	(	const QString &	text,
		QWidget *	follower,
		int	duration = `3000`
	)

显示警告消息.

显示指定的文本消息，超过指定时间后警告消息消失.

注解: 时间参数为-1时，警告消息将一直存在 text 警告的文本 duration 显示的时间长度，单位毫秒 follower tooltip跟随

◆ speechToTextIsEnabled()

bool Dtk::Widget::DLineEdit::speechToTextIsEnabled ( ) const

返回是否显示语音听写菜单项.

返回: true 显示语音听写菜单项 false不显示

◆ text()

QString Dtk::Widget::DLineEdit::text ( )

返回当前显示的文本.

返回: 返回显示的文本

◆ textToSpeechIsEnabled()

bool Dtk::Widget::DLineEdit::textToSpeechIsEnabled ( ) const

返回是否显示语音朗读菜单项.

返回: true 显示语音朗读菜单项 false不显示

◆ textToTranslateIsEnabled()

bool Dtk::Widget::DLineEdit::textToTranslateIsEnabled ( ) const

返回是否显示文本翻译菜单项.

返回: true 显示文本翻译菜单项 false 不显示

属性说明

◆ alert

Dtk::Widget::DLineEdit::alert

readwrite

警告模式属性.

用于开启或者判断是否处于警告模式.

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

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

信号

Public 成员函数

Protected 成员函数

属性

友元

详细描述

成员函数说明

◆ copyEnabled()

◆ cutEnabled()

◆ echoMode()

◆ eventFilter()

◆ isClearButtonEnabled()

◆ lineEdit()

◆ setAlertMessageAlignment()

◆ setClearButtonEnabled()

◆ setContextMenuPolicy()

◆ setEchoMode()

◆ setLeftWidgets()

◆ setLeftWidgetsVisible()

◆ setRightWidgets()

◆ setRightWidgetsVisible()

◆ setSpeechToTextEnabled()

◆ setText()

◆ setTextToSpeechEnabled()

◆ setTextToTranslateEnabled()

◆ showAlertMessage()

◆ speechToTextIsEnabled()

◆ text()

◆ textToSpeechIsEnabled()

◆ textToTranslateIsEnabled()

属性说明

◆ alert