Класс QFrame

Класс QFrame — базовый класс виджетов, которые могут иметь рамку. Подробнее...

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

Типы публичного интерфейса

Свойства

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

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

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

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

Защищённые функции

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

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

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

• 19 открытых слотов, унаследованных от QWidget
• 1 открытый слот, унаследованный от QObject
• 3 сигналов, унаследованных от QWidget
• 2 сигнала, унаследованных от QObject
• 5 статических открытых членов, унаследованных от QWidget
• 11 статических открытых членов, унаследованных от QObject
• 1 защищённый слот, унаследованный от QWidget

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

Класс QFrame — базовый класс виджетов, которые могут иметь рамку.

QMenu использует его для "поднятия" меню над окружающим экраном. QProgressBar имеет вид "вдавленной" рамки. QLabel имеет плоскую рамку. Рамки виджетов подобного типа могут быть изменены.

QLabel label(...);
label.setFrameStyle(QFrame::Panel | QFrame::Raised);
label.setLineWidth(2);

QProgressBar pbar(...);
label.setFrameStyle(QFrame::NoFrame);

Класс QFrame также может быть использован напрямую для создания простых фреймов-заполнителей без содержимого.

Стиль рамки определяется формой рамки (frame shape) и стилем тени (shadow style), используемыми для визуального отделения рамки от окружающих виджетов. Эти свойства могут быть установлены вместе с помощью функции setFrameStyle() и считываются с помощью функции frameStyle().

Формы рамок — NoFrame, Box, Panel, StyledPanel, HLine и VLine; стили теней — Plain, Raised и Sunken.

Виджет рамки имеет три атрибута, описывающие толщину границы: lineWidth, midLineWidth и frameWidth.

• Ширина линии — ширина границы рамки. Её можно изменить для настройки внешнего вида рамки.
• Ширина средней линии задаёт ширину дополнительной линии посередине рамки, использующей третий цвет для получения специального 3D-эффекта. Обратите внимание, что средняя линия рисуется только для рамок Box, HLine и VLine, которые подняты или опущены.
• Ширина рамки определяется стилем рамки, и функция frameWidth() используется для получения значения, определённого для используемого стиля.

Отступ между рамкой и содержимым рамки можно настроить с помощью функции QWidget::setContentsMargins().

В этой таблице показаны некоторые комбинации стилей и ширины линии:

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

Перечисление QFrame::Shadow

Это перечисление определяет типы теней, используемые для придания 3D-эффекта рамкам.

Тень взаимодействует с QFrame::Shape, lineWidth() и midLineWidth(). См. изображение фреймов в документации основного класса.

См. также QFrame::Shape, lineWidth() и midLineWidth().

enum QFrame::Shape

Этот перечисление определяет доступные формы фрейма.

Когда он не вызывает QStyle, Shape взаимодействует с QFrame::Shadow, lineWidth() и midLineWidth() для создания общего результата. См. изображение фреймов в документации основного класса.

См. также QFrame::Shadow, QFrame::style() и QStyle::drawPrimitive().

enum QFrame::StyleMask

Это перечисление определяет две константы, которые могут использоваться для извлечения двух компонентов frameStyle():

Обычно вам не нужно использовать их, так как frameShadow() и frameShape() уже извлекают части Shadow и Shape из frameStyle().

См. также frameStyle() и setFrameStyle().

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

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

Конструирует виджет фрейма со стилем фрейма NoFrame и шириной рамки 1 пиксел.

Аргументы parent и f передаются конструктору QWidget.

QFrame::~QFrame()

Уничтожает фрейм.

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

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

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

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

int QFrame::frameStyle() const

Возвращает стиль фрейма.

Значение по умолчанию — QFrame::Plain.

См. также setFrameStyle(), frameShape() и frameShadow().

[protected] void QFrame::initStyleOption(QStyleOptionFrame *option) const

Инициализирует option значениями из этого QFrame. Этот метод полезен для подклассов, когда им нужен QStyleOptionFrame, но они не хотят сами заполнять всю информацию.

Эта функция была представлена в Qt 5.5.

См. также QStyleOption::initFrom().

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

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

void QFrame::setFrameStyle(int style)

Устанавливает стиль рамки в style.

style — это битовое ИЛИ между формой рамки и стилем тени рамки. См. изображение рамок в документации основного класса.

Формы рамок задаются в QFrame::Shape, а стили теней — в QFrame::Shadow.

Если задана ширина средней линии больше 0, для рамок типа Raised или Sunken Box, HLine и VLine рисуется дополнительная линия. Для рисования средних линий используется средний цвет текущей цветовой группы.

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

[virtual] QSize QFrame::sizeHint() const

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