QLabel类

成员函数文档

[显式] QLabel::QLabel(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

构建一个空标签。

parent和窗口标志f参数传递给QFrame构造函数。

另请参阅：setAlignment（设置对齐）, setFrameStyle（设置框架样式）和setIndent（设置缩进）。

[明确] QLabel::QLabel(const QString &text, QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

创建一个标签以显示文本 text。

parent和窗口标志f参数传递给QFrame构造函数。

另请参阅setText，setAlignment，setFrameStyle 以及 setIndent。

[虚拟 noexcept] QLabel::~QLabel()

销毁标签。

QWidget *QLabel::buddy() const

返回此标签的伴侣，如果没有设置则返回 nullptr。

另请参阅setBuddy。

[覆盖虚拟受保护的] void QLabel::changeEvent(QEvent *ev)

重实现了： QFrame::changeEvent(QEvent *ev).

[槽] void QLabel::clear()

清除任何标签内容。

[覆盖虚拟受保护的] void QLabel::contextMenuEvent(QContextMenuEvent *ev)

重实现了：QWidget::contextMenuEvent(QContextMenuEvent *event).

[覆盖虚拟受保护的] bool QLabel::event(QEvent *e)

重实现了： QFrame::event(QEvent *e).

[覆盖虚拟受保护的] void QLabel::focusInEvent(QFocusEvent *ev)

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

[覆盖虚拟受保护的] bool QLabel::focusNextPrevChild(bool next)

重实现了：QWidget::focusNextPrevChild(bool next).

[覆盖虚拟受保护的] void QLabel::focusOutEvent(QFocusEvent *ev)

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

[覆盖虚拟] int QLabel::heightForWidth(int w) const

重实现了：QWidget::heightForWidth(int w) const.

[覆盖虚拟受保护的] void QLabel::keyPressEvent(QKeyEvent *ev)

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

[信号] void QLabel::linkActivated(const QString &link)

当用户点击链接时，会发出此信号。通过锚点引用的 URL 通过 link 传递。

另请参阅 linkHovered()。

[信号] void QLabel::linkHovered(const QString &link)

当用户悬停在链接上时，将发出此信号。通过锚点引用的URL作为link传入。

另请参阅 linkActivated()。

[重写虚函数] QSize QLabel::minimumSizeHint() const

重新实现了属性访问函数: QWidget::minimumSizeHint。

[重写虚保护函数] void QLabel::mouseMoveEvent(QMouseEvent *ev)

重写: QWidget::mouseMoveEvent(QMouseEvent *event)。

[重写虚保护函数] void QLabel::mousePressEvent(QMouseEvent *ev)

重写: QWidget::mousePressEvent(QMouseEvent *event)。

[重写虚保护函数] void QLabel::mouseReleaseEvent(QMouseEvent *ev)

重写: QWidget::mouseReleaseEvent(QMouseEvent *event)。

QMovie *QLabel::movie() const

返回标签电影的指针，如果没有设置电影，则返回nullptr。

另请参阅 setMovie()。

[重写虚保护函数] void QLabel::paintEvent(QPaintEvent *)

重写: QFrame::paintEvent(QPaintEvent *)。

[自 6.0 开始] QPicture QLabel::picture() const

返回标签的图片。

此函数在 Qt 6.0 中引入。

[自 6.1 开始] QTextDocument::ResourceProvider QLabel::resourceProvider() const

返回此标签富文本的资源提供者。

此函数在 Qt 6.1 中引入。

另请参阅 setResourceProvider()。

int QLabel::selectionStart() const

selectionStart() 返回标签中第一个已选字符的索引，如果没有选择文本，则返回 -1。

注意：在标签上设置的textInteractionFlags需要包括TextSelectableByMouse或TextSelectableByKeyboard。

另请参阅selectedText。

void QLabel::setBuddy(QWidget *buddy)

设置此标签的伙伴为 buddy。

当用户按下此标签指示的快捷键时，键盘焦点将转移到标签的伙伴小部件。

伙伴机制仅适用于包含文本的 QLabels，其中某个字符前面带有 & 符号。此字符设置为快捷键。有关详细信息，请参阅 QKeySequence::mnemonic() 文档（要显示实际的 & 符号，请使用 '&&')。

在对话框中，您可能需要创建两个数据输入小部件和每个小部件的标签，并设置几何布局，以便每个标签都位于其数据输入小部件（即其“伙伴”）的左侧，例如。

QLineEdit *nameEdit  = new QLineEdit(this);
QLabel    *nameLabel = new QLabel("&Name:", this);
nameLabel->setBuddy(nameEdit);
QLineEdit *phoneEdit  = new QLineEdit(this);
QLabel    *phoneLabel = new QLabel("&Phone:", this);
phoneLabel->setBuddy(phoneEdit);
// (layout setup not shown)

使用上述代码，当用户按下Alt+N时，焦点会跳转到名称字段，当用户按下Alt+P时，会跳转到电话字段。

要取消设置先前设置的伙伴，请将此函数中的buddy设置为nullptr。

另请参阅buddy()，setText()，QShortcut和setAlignment。

[slot] void QLabel::setMovie(QMovie *movie)

将标签内容设置为movie。任何之前的内容都会被清除。标签不会获取电影的所有权。

如果有的话，禁用伙伴快捷键。

另请参阅movie()和setBuddy()。

[slot] void QLabel::setNum(int num)

将标签内容设置为包含整数num文本表示的纯文本。任何之前的内容都会被清除。如果整数的字符串表示与标签的当前内容相同，则不执行任何操作。

如果有的话，禁用伙伴快捷键。

另请参阅setText()，QString::setNum()和setBuddy。

[slot] void QLabel::setNum(double num)

这是一个重载函数。

将标签内容设置为包含双精度值num文本表示的纯文本。任何之前的内容都会被清除。如果双精度的字符串表示与标签的当前内容相同，则不执行任何操作。

如果有的话，禁用伙伴快捷键。

另请参阅setText()，QString::setNum()和setBuddy。

[slot] void QLabel::setPicture(const QPicture &picture)

将标签内容设置为picture。任何之前的内容都会被清除。

如果有的话，禁用伙伴快捷键。

另请参阅picture()和setBuddy。

[since 6.1] void QLabel::setResourceProvider(const QTextDocument::ResourceProvider &provider)

为此标签的富文本设置资源提供者provider。

此函数在 Qt 6.1 中引入。

另请参阅resourceProvider。

void QLabel::setSelection(int start, int length)

从位置start开始选择，长度为length个字符的文本。

注意：在标签上设置的textInteractionFlags需要包括TextSelectableByMouse或TextSelectableByKeyboard。

另请参阅selectedText。

[override virtual] QSize QLabel::sizeHint() const

重新实现了：QFrame::sizeHint() const。