Класс QLabel

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

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

Свойства

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

Реализованные публичные функции

Публичные слоты

Сигналы

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

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

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

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

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

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

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

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

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)

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

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

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

См. также 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 ресурсов для форматированного текста этой метки.

Примечание: Метка не принимает 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.