QKeySequenceEdit 类

QKeySequenceEdit 小部件允许输入 QKeySequence . 更多...

头：	#include <QKeySequenceEdit>
CMake:	find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake:	QT += widgets
继承：	QWidget

• 所有成员列表，包括继承成员

特性

• clearButtonEnabled : bool
• finishingKeyCombinations : QList<QKeyCombination>
• keySequence : QKeySequence
• maximumSequenceLength : qsizetype

公共函数

	QKeySequenceEdit (QWidget * parent = nullptr)
	QKeySequenceEdit (const QKeySequence & keySequence , QWidget * parent = nullptr)
virtual	~QKeySequenceEdit ()
QList<QKeyCombination>	finishingKeyCombinations () const
bool	isClearButtonEnabled () const
QKeySequence	keySequence () const
qsizetype	maximumSequenceLength () const
void	setClearButtonEnabled (bool enable )
void	setFinishingKeyCombinations (const QList<QKeyCombination> & finishingKeyCombinations )

公共槽

void	clear ()
void	setKeySequence (const QKeySequence & keySequence )
void	setMaximumSequenceLength (qsizetype count )

信号

void	editingFinished ()
void	keySequenceChanged (const QKeySequence & keySequence )

重实现保护函数

virtual bool	event (QEvent * e ) override
virtual void	focusOutEvent (QFocusEvent * e ) override
virtual void	keyPressEvent (QKeyEvent * e ) override
virtual void	keyReleaseEvent (QKeyEvent * e ) override
virtual void	timerEvent (QTimerEvent * e ) override

详细描述

This widget lets the user choose a QKeySequence , which is usually used as a shortcut. The recording is initiated when the widget receives the focus and ends one second after the user releases the last key.

另请参阅 QKeySequenceEdit::keySequence .

特性文档编制

[since 6.4] clearButtonEnabled : bool

This property holds whether the key sequence edit displays a clear button when it is not empty.

If enabled, the key sequence edit displays a trailing clear 按钮 (当它包含一些文本时)，否则，行编辑不展示清零按钮 (默认)。

该特性在 Qt 6。4 引入。

访问函数：

bool	isClearButtonEnabled () const
void	setClearButtonEnabled (bool enable )

[since 6.5] finishingKeyCombinations : QList < QKeyCombination >

This property holds the list of key combinations that finish editing the key sequences.

Any combination in the list will finish the editing of key sequences. All other key combinations can be recorded as part of a key sequence. By default, Qt::Key_Tab and Qt::Key_Backtab will finish recording the key sequence.

This property was introduced in Qt 6.5.

访问函数：

QList<QKeyCombination>	finishingKeyCombinations () const
void	setFinishingKeyCombinations (const QList<QKeyCombination> & finishingKeyCombinations )

keySequence : QKeySequence

This property contains the currently chosen key sequence.

The shortcut can be changed by the user or via setter function.

注意： 若 QKeySequence is longer than the maximumSequenceLength property, the key sequence is truncated.

访问函数：

QKeySequence	keySequence () const
void	setKeySequence (const QKeySequence & keySequence )

通知程序信号：

void	keySequenceChanged (const QKeySequence & keySequence )

[since 6.5] maximumSequenceLength : qsizetype

This property holds the maximum sequence length.

The maximum number of key sequences a user can enter. The value needs to be between 1 and 4, with 4 being the default.

This property was introduced in Qt 6.5.

访问函数：

qsizetype	maximumSequenceLength () const
void	setMaximumSequenceLength (qsizetype count )

成员函数文档编制

[explicit] QKeySequenceEdit:: QKeySequenceEdit ( QWidget * parent = nullptr)

Constructs a QKeySequenceEdit widget with the given parent .

[explicit] QKeySequenceEdit:: QKeySequenceEdit (const QKeySequence & keySequence , QWidget * parent = nullptr)

Constructs a QKeySequenceEdit widget with the given keySequence and parent .

[virtual noexcept] QKeySequenceEdit:: ~QKeySequenceEdit ()

销毁 QKeySequenceEdit 对象。

[slot] void QKeySequenceEdit:: clear ()

Clears the current key sequence.

[signal] void QKeySequenceEdit:: editingFinished ()

This signal is emitted when the user finishes entering the shortcut.

注意： there is a one second delay before releasing the last key and emitting this signal.

[override virtual protected] bool QKeySequenceEdit:: event ( QEvent * e )

重实现： QWidget::event (QEvent *event).

[override virtual protected] void QKeySequenceEdit:: focusOutEvent ( QFocusEvent * e )

重实现： QWidget::focusOutEvent (QFocusEvent *event).

[override virtual protected] void QKeySequenceEdit:: keyPressEvent ( QKeyEvent * e )

重实现： QWidget::keyPressEvent (QKeyEvent *event).

[override virtual protected] void QKeySequenceEdit:: keyReleaseEvent ( QKeyEvent * e )

重实现： QWidget::keyReleaseEvent (QKeyEvent *event).

[override virtual protected] void QKeySequenceEdit:: timerEvent ( QTimerEvent * e )

重实现： QObject::timerEvent (QTimerEvent *event).

内容

• 特性

• 公共函数

• 公共槽

• 信号

• 重实现保护函数

• 详细描述