Класс QLabel

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

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

Свойства

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

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

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

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

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

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

Сигналы

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

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

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

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

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

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

Виджет 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), активация мнемоники эмулировала бы щелчок по кнопке.

	Метка, отображаемая в стиле виджета Macintosh.
	Метка, отображаемая в стиле виджета Fusion.
	Метка, отображаемая в стиле виджета Windows Vista.

См. также QLineEdit, QTextEdit, QPixmap, QMovie и Справочник по разработке графического интерфейса: Метка.

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

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

Конструирует пустую метку.

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

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

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

Конструирует метку, отображающую текст text.

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

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

QLabel::~QLabel()

Удаляет метку.

QWidget *QLabel::buddy() const

Возвращает виджет-компаньона этой метки или 0, если компаньон не задан.

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

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

Переопределяет QWidget::changeEvent().

[slot] void QLabel::clear()

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

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

Переопределяет QWidget::contextMenuEvent().

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

Переопределяет QObject::event().

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

Переопределяет QWidget::focusInEvent().

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

Переопределяет QWidget::focusNextPrevChild().

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

Переопределяет QWidget::focusOutEvent().

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

Переопределяет QWidget::heightForWidth().

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

[virtual] QSize QLabel::minimumSizeHint() const

Переопределяет QWidget::minimumSizeHint().

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

Переопределяет QWidget::mouseMoveEvent().

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

Переопределяет QWidget::mousePressEvent().

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

Переопределяет QWidget::mouseReleaseEvent().

QMovie *QLabel::movie() const

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

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

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

Переопределяет QWidget::paintEvent().

const QPicture *QLabel::picture() const

Возвращает изображение метки или 0, если изображение не задано.

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

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

[virtual] QSize QLabel::sizeHint() const

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