QLabel Class

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 。

注意: 标签不拥有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.

相关推荐

天行VPN翻墙全攻略
今日之时365天第二季

天行VPN翻墙全攻略

📅 08-02 👁️ 8422
nike毒蜂顶级和次级有什么区别?耐克毒蜂顶级次级对比
今日之时365天第二季

nike毒蜂顶级和次级有什么区别?耐克毒蜂顶级次级对比

📅 07-06 👁️ 4146
蒸锅十大品牌排行榜
今日之时365天第二季

蒸锅十大品牌排行榜

📅 07-08 👁️ 3372
小鸟爆破安卓免费版下载-小鸟爆破安卓免费版下载安装手机版v2.1.8
离婚到底意味着什么?
今日之时365天第二季

离婚到底意味着什么?

📅 08-21 👁️ 9999
箭头书签
今日之时365天第二季

箭头书签

📅 08-13 👁️ 9408