QLabel Class

成员函数文档

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

创建一个空标签。

parent 和控件标志f 作为参数传递给QFrame 构造函数。

另请参阅 setAlignment()、setFrameStyle() 和setIndent()。

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

创建一个显示文本“text ”的标签。

参数 `parent ` 和控件标志 `f` 将传递给 `QFrame ` 构造函数。

另请参阅 setText()、setAlignment()、setFrameStyle() 和setIndent()。

[virtual noexcept] QLabel::~QLabel()

删除该标签。

QWidget *QLabel::buddy() const

返回该标签的“伙伴”，如果当前未设置“伙伴”，则返回 nullptr。

另请参阅 setBuddy()。

[override virtual protected] void QLabel::changeEvent(QEvent *ev)

重写了：QFrame::changeEvent(QEvent *ev)。

[slot] void QLabel::clear()

清除任何标签内容。

[override virtual protected] void QLabel::contextMenuEvent(QContextMenuEvent *ev)

重写了：QWidget::contextMenuEvent(QContextMenuEvent *event)。

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

重写了：QFrame::event(QEvent *e)。

[override virtual protected] void QLabel::focusInEvent(QFocusEvent *ev)

重写了：QWidget::focusInEvent(QFocusEvent *event)。

[override virtual protected] bool QLabel::focusNextPrevChild(bool next)

重新实现了：QWidget::focusNextPrevChild （bool next）。

[override virtual protected] void QLabel::focusOutEvent(QFocusEvent *ev)

重写了：QWidget::focusOutEvent(QFocusEvent *event)。

[override virtual] int QLabel::heightForWidth(int w) const

重新实现了：QWidget::heightForWidth （int w）const。

[override virtual protected] void QLabel::keyPressEvent(QKeyEvent *ev)

重写了：QWidget::keyPressEvent(QKeyEvent *event)。

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

当用户点击链接时，会触发此信号。锚点所指向的 URL 会作为参数传递给 `link`。

另请参阅 linkHovered()。

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

当用户将鼠标悬停在链接上时，会触发此信号。锚点所指向的 URL 会通过 `link` 传递进来。

另请参阅 linkActivated()。

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

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

[override virtual protected] void QLabel::mouseMoveEvent(QMouseEvent *ev)

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

[override virtual protected] void QLabel::mousePressEvent(QMouseEvent *ev)

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

[override virtual protected] void QLabel::mouseReleaseEvent(QMouseEvent *ev)

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

QMovie *QLabel::movie() const

返回指向该标签电影的指针；如果未设置电影，则返回 nullptr。

另请参阅 setMovie()。

[override virtual protected] void QLabel::paintEvent(QPaintEvent *)

重写了：QFrame::paintEvent （QPaintEvent *）。

[since 6.0] QPicture QLabel::picture() const

返回标签的图片。

该函数在 Qt 6.0 中引入。

另请参阅 setPicture()。

[since 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 。

当用户按下该标签所指示的快捷键时，键盘焦点将转移到该标签的关联控件上。

“伙伴”机制仅适用于文本中包含一个以“&”符号开头的字符的 QLabel。该字符将被设为快捷键。详情请参阅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 的字符串表示形式的纯文本。此前所有内容将被清空。如果该整数的字符串表示形式与标签的当前内容相同，则不执行任何操作。

若有“伙伴”快捷键，则将其禁用。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        label, qOverload(&QLabel::setNum));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        label, [receiver = label](int num) { receiver->setNum(num); });

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

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

将标签内容设置为包含双精度数值num 的字符串表示形式的纯文本。此前所有内容将被清空。如果该双精度数值的字符串表示形式与标签的当前内容相同，则不执行任何操作。

如果存在“伙伴”快捷键，则将其禁用。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        label, qOverload(&QLabel::setNum));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        label, [receiver = label](double num) { receiver->setNum(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。