Класс QLabel

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

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

Свойства

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

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

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

Сигналы

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

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

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

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

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

По умолчанию метки отображают текст и изображения, выровненные по левому краю, по вертикали по центру, где все табуляции в отображаемом тексте автоматически расширяются. Однако внешний вид 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 предоставляет полезный механизм для добавления мнемоники (см. QKeySequence), которая установит фокус клавиатуры на другой виджет (так называемый "партнёр" QLabel). Например:

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

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

См. также QLineEdit, QTextEdit, QPixmap, QMovie, и GUI Design Handbook: Label.

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

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.

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

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

Этот сигнал излучается, когда пользователь наводит указатель мыши на ссылку. URL, на который указывает якорь, передаётся в link.

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

[since 6.0] QPicture QLabel::picture() const

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

Функция была добавлена в Qt 6.0.

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

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