Класс QFrame

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

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

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

Свойства

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

перечисление 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().

[virtual protected, since 5.5] 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.