Класс QFrame

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

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

Типы public

Свойства

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

Публичные функции

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

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

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

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

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

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

• 19 public slots унаследовано от QWidget
• 1 public slot унаследовано от QObject
• 3 сигналов унаследовано от QWidget
• 2 сигналов унаследовано от QObject
• 1 public переменной унаследовано от QObject
• 5 статических публичных членов унаследовано от QWidget
• 10 статических публичных членов унаследовано от QObject
• 1 защищённый слот унаследовано от QWidget
• 2 защищённых переменных унаследовано от QObject
• 1 защищённый тип унаследовано от QPaintDevice

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

Класс 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 = nullptr, Qt::WindowFlags f = ...)

Создаёт виджет рамки со стилем рамки NoFrame и шириной рамки 1 пиксел.

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

[virtual] QFrame::~QFrame()

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

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

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

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

Переопределено из QWidget::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().

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

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

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