QLabel Class

成员函数文档

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

构造一个空标签。

parent 和 widget 标志f, 参数传递给QFrame 构造函数。

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

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

构造一个显示文本text 的标签。

parent 和 widget 标志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 。

当用户按下该标签指示的快捷键时，键盘焦点就会转移到标签的好友部件上。

好友机制仅适用于包含以"&"为前缀的字符的文本的 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 的文本表示。之前的内容将被清除。如果 double 的字符串表示与当前标签内容相同，则不执行任何操作。

好友快捷方式（如果有）将被禁用。

另请参阅 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.