Класс QLabel

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

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

Свойства

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

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

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

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

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

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

Сигналы

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

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

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

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

• 1 общедоступная переменная, унаследованная от QObject
• 5 статические общедоступные члены, унаследованные от QWidget
• 10 статических общедоступных членов, унаследованных от QObject
• 4 защищенных функций, унаследованных от QFrame
• 35 защищенных функций, унаследованных от QWidget
• 9 защищенных функций, унаследованных от QObject
• 1 защищенная функция, унаследованная от QPaintDevice
• 1 защищённый слот, унаследованный от QWidget
• 2 защищённых переменных, унаследованных от QObject
• 1 защищённого типа, унаследованного от QPaintDevice

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

Виджет 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(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.

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

Механизм компаньона доступен только для меток, содержащих текст, в котором один символ предваряется амперсандом, '&'. Этот символ задаёт сочетание клавиш. Подробнее см. документацию 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().