Класс QLabel

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

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

Свойства

• 6 свойств, унаследованных от QFrame
• 59 свойств, унаследованных от QWidget
• 1 свойство, унаследованное от QObject

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

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

• 14 открытых функций, унаследованных от QFrame
• 214 открытых функций, унаследованных от QWidget
• 31 открытых функций, унаследованных от QObject
• 14 открытых функций, унаследованных от QPaintDevice

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

• 19 открытых слотов, унаследованных от QWidget
• 1 открытый слот, унаследованный от QObject

Сигналы

• 3 сигнала, унаследованных от QWidget
• 2 сигнала, унаследованных от QObject

Статические открытые члены

• 5 статических открытых членов, унаследованных от QWidget
• 9 статических открытых членов, унаследованных от QObject

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

• 4 защищённых функций, унаследованных от QFrame
• 35 защищённых функций, унаследованных от QWidget
• 9 защищённых функций, унаследованных от QObject
• 1 защищённая функция, унаследованная от QPaintDevice

Дополнительные унаследованные члены

• 4 защищённых функций, унаследованных от QFrame
• 35 защищённых функций, унаследованных от QWidget
• 9 защищённых функций, унаследованных от QObject
• 1 защищённая функция, унаследованная от QPaintDevice
• 1 защищённый слот, унаследованный от QWidget

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

Виджет 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 и Руководство по проектированию GUI: Метка.

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

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

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

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

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

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

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

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

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

[virtual] QLabel::~QLabel()

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

QWidget *QLabel::buddy() const

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

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

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

Переопределено из QFrame::changeEvent().

[slot] void QLabel::clear()

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

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

Переопределено из QWidget::contextMenuEvent().

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

Переопределено из QFrame::event().

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

Переопределено из QWidget::focusInEvent().

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

Переопределено из QWidget::focusNextPrevChild().

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

Переопределено из QWidget::focusOutEvent().

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

Переопределено из QWidget::heightForWidth().

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

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

Переопределено из QWidget::minimumSizeHint().

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

Переопределено из QWidget::mouseMoveEvent().

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

Переопределено из QWidget::mousePressEvent().

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

Переопределено из QWidget::mouseReleaseEvent().

QMovie *QLabel::movie() const

Возвращает указатель на анимацию метки или nullptr, если анимация не установлена.

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

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

Переопределено из QFrame::paintEvent().

const QPicture *QLabel::picture() const

Возвращает изображение метки или nullptr, если у метки нет изображения.

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

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

[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. Любое предыдущее содержимое очищается. Ничего не делает, если строковое представление двойного числа совпадает с текущим содержимым метки.

Сочетание клавиш компаньона, если таковое имеется, отключается.

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

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

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

Если есть сокращение для друга, оно отключается.

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

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

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

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

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

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

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

Переопределено из QFrame::sizeHint().