Класс QFrame

Класс 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.

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

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

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

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

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

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

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

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

Перечисление 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 = Qt::WindowFlags())

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

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

[virtual] QFrame::~QFrame()

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

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

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

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

Переопределяет: QWidget::event(QEvent *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(QPaintEvent *event).

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.