Класс QLabel

Виджет QLabel обеспечивает отображение текста или изображения. Подробнее...

• Список всех членов, включая наследуемые
• Устаревшие члены

Свойства

Открытые функции

Переопределённые открытые функции

Открытые слоты

Сигналы

Переопределённые защищённые функции

Подробное описание

QLabel используется для отображения текста или изображения. Функциональность взаимодействия пользователя не предоставляется. Визуальный вид метки может быть настроен различными способами, и она может использоваться для указания фокусного символа mnemonic для другого виджета.

QLabel может содержать любой из следующих типов контента:

Предупреждение: При передаче QString в конструктор или вызове setText(), убедитесь, что очищаете свой ввод, так как QLabel пытается угадать, отображать ли текст как простой текст или форматированный текст, подмножество разметки HTML 4. Вы можете явно вызвать setTextFormat(), например, в случае, если ожидается, что текст будет в простом формате, но вы не можете контролировать источник текста (например, при отображении данных, загруженных из веб-сайта).

При изменении содержимого с помощью любого из этих функций любое предыдущее содержимое очищается.

По умолчанию метки отображают выровненный по левому краю, вертикально центрированный текст и изображения, где все символы табуляции в отображаемом тексте автоматически расширяются. Однако внешний вид QLabel может быть изменен и настроен различными способами.

Позиционирование содержимого внутри области виджета QLabel можно настроить с помощью setAlignment() и setIndent(). Содержимое текста также может переносить строки по границам слов с помощью setWordWrap(). Например, этот код настраивает углубленную панель с текстом из двух строк в правом нижнем углу (обе строки выровнены по правому краю метки):

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

Свойства и функции, которые QLabel наследует от QFrame, также могут использоваться для указания рамки виджета, которая используется для любой данной метки.

QLabel часто используется в качестве метки для интерактивного виджета. Для этого QLabel предоставляет полезный механизм для добавления символа mnemonic (см. QKeySequence), который установит фокус клавиатуры на другой виджет (называемый «товарищем» QLabel). Например:

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

В этом примере фокус клавиатуры передается товарищу метки (полю QLineEdit) при нажатии Alt+P. Если товарищ был кнопкой (наследующей от QAbstractButton), активация mnemonic имитировала бы нажатие кнопки.

См. также QLineEdit, QTextEdit, QPixmap, QMovie и Руководство по проектированию графического интерфейса пользователя: Метка.

const QPixmap *pixmapPtr = label->pixmap();
QPixmap pixmapVal = label->pixmap(Qt::ReturnByValue);

QPixmap pixmapVal = label->pixmap();

Документация по членам функций

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

Создаёт метку, которая отображает текст text.

Аргументы parent и флаги виджета f передаются конструктору QFrame.

См. также setText(), setAlignment(), setFrameStyle() и setIndent().

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

Создаёт пустую метку.

Аргументы parent и флаги виджета f передаются конструктору QFrame.

См. также setAlignment(), setFrameStyle() и setIndent().

[slot] void QLabel::clear()

Очищает содержимое метки.

[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().

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

Устанавливает содержимое метки в movie. Любое предыдущее содержимое очищается. Метка НЕ перенимает владения над движком.

Сокращение отметки, если оно есть, отключается.

См. также movie() и setBuddy().

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

Это перегруженная функция.

Устанавливает содержимое метки на обычный текст, содержащий текстовое представление double num. Любое предыдущее содержимое очищается. Ничего не делает, если строковое представление double совпадает с текущим содержимым метки.

Сокращение отметки, если оно есть, отключается.

См. также setText(), QString::setNum() и setBuddy().

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

Устанавливает содержимое метки на обычный текст, содержащий текстовое представление целого числа num. Любое предыдущее содержимое очищается. Ничего не делает, если строковое представление целого числа совпадает с текущим содержимым метки.

Сокращение отметки, если оно есть, отключается.

См. также setText(), QString::setNum() и setBuddy().

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

Устанавливает содержимое метки в picture. Любое предыдущее содержимое очищается.

Сокращение отметки, если оно есть, отключается.

См. также picture() и setBuddy().

[virtual] QLabel::~QLabel()

Уничтожает метку.

QWidget *QLabel::buddy() const

Возвращает помощника этой метки или nullptr, если помощник не установлен.

См. также setBuddy().

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

Переопределяет: QFrame::changeEvent(QEvent *ev).

[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).

[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 *).

QPicture QLabel::picture(Qt::ReturnByValueConstant) const

Возвращает изображение метки.

Ранее Qt предоставлял версию picture() , которая возвращала изображение по указателю. Эта версия теперь устарела. Для сохранения совместимости со старым кодом можно явно различать функцию по указателю и функцию по значению:

const QPicture *picPtr = label->picture();
QPicture picVal = label->picture(Qt::ReturnByValue);

Если вы отключите устаревшую версию с помощью макроса QT_DISABLE_DEPRECATED_BEFORE, то можете опустить Qt::ReturnByValue , как показано ниже:

QPicture picVal = label->picture();

Эта функция была добавлена в Qt 5.15.

QPixmap QLabel::pixmap(Qt::ReturnByValueConstant) const

Примечание: Функция-получатель для свойства pixmap.

Эта функция была добавлена в Qt 5.15.

int QLabel::selectionStart() const

selectionStart() возвращает индекс первой выбранной буквы в метке или -1, если текст не выбран.

Примечание: Установленные для метки textInteractionFlags должны включать либо TextSelectableByMouse, либо TextSelectableByKeyboard.

Эта функция была введена в Qt 4.7.

См. также 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().

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

Выбирает текст с позиции start и длиной length символов.

Примечание: Установленные для метки textInteractionFlags должны включать либо TextSelectableByMouse, либо TextSelectableByKeyboard.

Эта функция была введена в Qt 4.7.

См. также selectedText().

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

Реализует: QFrame::sizeHint() const.