QLabel Class

  QLabel *label = new QLabel(this);
  label->setFrameStyle(QFrame::Panel | QFrame::Sunken);
  label->setText("first line\nsecond line");
  label->setAlignment(Qt::AlignBottom | Qt::AlignRight);

  QLineEdit *phoneEdit = new QLineEdit(this);
  QLabel *phoneLabel = new QLabel("&Phone:", this);
  phoneLabel->setBuddy(phoneEdit);

成员函数

QLabel::QLabel(QWidget *parent = Q_NULLPTR, Qt::WindowFlags f = Qt::WindowFlags())

空标签构造函数, 所有参数传递给基类QFrame.

参数 parent 父对象

参数 f 窗口标志

参见 setAlignment(), setFrameStyle(), and setIndent().

QLabel::QLabel(const QString &text, QWidget *parent = Q_NULLPTR, Qt::WindowFlags f = Qt::WindowFlags())

带有文本的构造函数, 所有参数传递给基类QFrame.

参数 text 显示文本.

参数 parent 父对象.

参数 parent 窗口标志.

参见 setText(), setAlignment(), setFrameStyle(), and setIndent().

QLabel::~QLabel()

析构函数.

QWidget *QLabel::buddy() const

返回标签的伙伴, 没有设置返回0.

参见 setBuddy().

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

重新实现 QWidget::changeEvent().

[slot] void QLabel::clear()

清除标签任意内容.

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

重新实现 QWidget::contextMenuEvent().

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

重新实现 QObject::event().

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

重新实现 QWidget::focusInEvent().

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

重新实现 QWidget::focusNextPrevChild().

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

重新实现 QWidget::focusOutEvent().

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

重新实现 QWidget::heightForWidth().

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

重新实现 QWidget::keyPressEvent().

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

用户点击链接时发送信号. URL使用参数 link 传入.

这个函数从 Qt 4.2 开始支持.

参见 linkHovered().

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

用户鼠标悬停在链接上发送信号. URL使用参数 link 传入.

这个函数从 Qt 4.2 开始支持.

参见 linkActivated().

[virtual] QSize QLabel::minimumSizeHint() const

重新实现 QWidget::minimumSizeHint().

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

重新实现 QWidget::mouseMoveEvent().

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

重新实现 QWidget::mousePressEvent().

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

重新实现 QWidget::mouseReleaseEvent().

QMovie *QLabel::movie() const

返回标签动图, 没有设置返回0.

参见 setMovie().

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

重新实现 QWidget::paintEvent().

const QPicture *QLabel::picture() const

返回标签图片, 没有设置返回0.

参见 setPicture().

int QLabel::selectionStart() const

返回选中的字符串的首个字符的索引, 没有选中的字符串返回-1.

注意: 标签的 textInteractionFlags 标志需要包含 TextSelectableByMouse 或 TextSelectableByKeyboard.

这个函数从 Qt 4.7 开始支持.

参见 selectedText().

void QLabel::setBuddy(QWidget *buddy)

设置标签的伙伴 buddy.

当用户按下标签指示的快捷键时，键盘焦点将转移到标签的伙伴widget.

伙伴机制仅适用于标签包含带有前缀'&'的文本. '&'后面的字符是快捷键. 详见 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"时，焦点跳转到Name输入框; 用户按"Alt+P"时, 焦点跳转到Phone输入框.

如果你想取消伙伴设置, 调用该函数时, buddy 设为 0.

参见 buddy(), setText(), QShortcut, and setAlignment().

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

设置标签内容为动图 movie, 并清除原有内容. 标签不是动图的所有者.

若有伙伴快捷键, 自动禁用.

参见 movie() 和 setBuddy().

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

设置标签的内容为整型 num字符串, 并清除原有内容. 若整形字符串与原有内容相同不执行任何操作.

若有伙伴快捷键, 自动禁用.

参见 setText(), QString::setNum(), and setBuddy().

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

重载函数.

设置标签的内容为浮点型 num字符串, 并清除原有内容. 若浮点型字符串与原有内容相同不执行任何操作.

若有伙伴快捷键, 自动禁用.

参见 setText(), QString::setNum(), and setBuddy().

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

设置标签的内容为图片 picture, 并清除原有内容.

若有伙伴快捷键, 自动禁用.

参见 picture() and setBuddy().

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

设置选中字符串.

参数 start 起始位置.

参数 length 字符串长度.

注意: 标签的 textInteractionFlags 标志需要包含 TextSelectableByMouse 或 TextSelectableByKeyboard.

这个函数从 Qt 4.7 开始支持.

参见 selectedText().

[virtual] QSize QLabel::sizeHint() const

重新实现 QWidget::sizeHint().