Класс QFrame

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

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

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

Свойства

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

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

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

• 211 публичных функций унаследовано от QWidget
• 31 публичная функция унаследована от 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 также можно использовать напрямую для создания простых замещающих рамок без какого-либо содержимого.

Стиль рамки определяется формой рамки и стилем тени, которые визуально отделяют рамку от окружающих виджетов. Эти свойства можно задать вместе с помощью функции 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().