成员函数文档
[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 。
注意: 标签不拥有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.