Класс QStyleOptionTab
Класс QStyleOptionTab используется для описания параметров рисования панели вкладок. Подробнее...
| Заголовок: | #include <QStyleOptionTab> |
| CMake: | find_package(Qt6 COMPONENTS Widgets REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Наследует: | QStyleOption |
Открытые типы
| Перечисление | CornerWidget { НетУголковыхЭлементов, ЛевыйУголковыйЭлемент, ПравыйУголковыйЭлемент } |
| Флаги | CornerWidgets |
| Перечисление | SelectedPosition { НеПрилегает, СледующийВыделен, ПредыдущийВыделен } |
| Перечисление | StyleOptionType { Тип } |
| Перечисление | StyleOptionVersion { Версия } |
| Перечисление | TabFeature { Нет, ЕстьРамка } |
| Флаги | TabFeatures |
| Перечисление | TabPosition { Начало, Середина, Конец, ТолькоОднаВкладка } |
Открытые функции
| QStyleOptionTab(const QStyleOptionTab &other) | |
| QStyleOptionTab() |
Открытые переменные
| QStyleOptionTab::CornerWidgets | cornerWidgets |
| bool | documentMode |
| QIcon | icon |
| QSize | iconSize |
| QSize | leftButtonSize |
| QStyleOptionTab::TabPosition | position |
| QSize | rightButtonSize |
| int | row |
| QStyleOptionTab::SelectedPosition | selectedPosition |
| QTabBar::Shape | shape |
| int | tabIndex |
| QString | text |
Подробное описание
Класс QStyleOptionTab используется для рисования нескольких встроенных виджетов Qt, включая QTabBar и панели для QTabWidget.
Экземпляр класса QStyleOptionTab имеет тип SO_Tab и версию 3. Тип используется внутренне классом QStyleOption, его подклассами и функцией qstyleoption_cast() для определения типа стиля. В общем случае вам об этом не нужно беспокоиться, если только вы не хотите создать свой подкласс QStyleOption и свои стили. Версия используется подклассами QStyleOption для реализации расширений без нарушения совместимости. Если вы используете функцию qstyleoption_cast(), вам обычно не нужно проверять её.
Из соображений производительности существует немного функций-членов, и доступ к переменным-членам осуществляется напрямую (т. е. с помощью оператора . или ->). Это делает структуры простыми в использовании и подчеркивает, что это просто параметры, используемые функциями стиля.
Пример демонстрирующий как использовать параметры стиля, можно найти в примере Styles.
См. также QStyleOption.
Документация по типам-членам
перечисление QStyleOptionTab::CornerWidgetфлаги QStyleOptionTab::CornerWidgets
Эти флаги указывают на уголковые виджеты во вкладке.
| Константа | Значение | Описание |
|---|---|---|
QStyleOptionTab::NoCornerWidgets |
0x00 |
Уголковых виджетов нет |
QStyleOptionTab::LeftCornerWidget |
0x01 |
Левый уголковый виджет |
QStyleOptionTab::RightCornerWidget |
0x02 |
Правый уголковый виджет |
Тип CornerWidgets является псевдонимом для QFlags<CornerWidget>. Он хранит логическое ИЛИ сочетание значений CornerWidget.
См. также cornerWidgets.
перечисление QStyleOptionTab::SelectedPosition
Это перечисление описывает положение выделенной вкладки. Некоторые стили должны рисовать вкладку по-разному в зависимости от того, прилегает ли она к выделенной вкладке или нет.
| Константа | Значение | Описание |
|---|---|---|
QStyleOptionTab::NotAdjacent |
0 |
Вкладка не прилегает к выделенной вкладке (или является выделенной вкладкой). |
QStyleOptionTab::NextIsSelected |
1 |
Следующая вкладка (обычно справа) выделена. |
QStyleOptionTab::PreviousIsSelected |
2 |
Предыдущая вкладка (обычно слева) выделена. |
См. также selectedPosition.
перечисление QStyleOptionTab::StyleOptionType
Это перечисление используется для хранения информации о типе параметра стиля и определено для каждого подкласса QStyleOption.
| Константа | Значение | Описание |
|---|---|---|
QStyleOptionTab::Type |
SO_Tab |
Тип предоставляемого параметра стиля (SO_Tab для этого класса). |
Тип используется внутренне классом QStyleOption, его подклассами и функцией qstyleoption_cast() для определения типа параметра стиля. В общем случае вам об этом не нужно беспокоиться, если только вы не хотите создать свой подкласс QStyleOption и свои стили.
См. также StyleOptionVersion.
перечисление QStyleOptionTab::StyleOptionVersion
Это перечисление используется для хранения информации о версии параметра стиля и определено для каждого подкласса QStyleOption.
| Константа | Значение | Описание |
|---|---|---|
QStyleOptionTab::Version |
1 |
3 |
Версия используется подклассами QStyleOption для реализации расширений без нарушения совместимости. Если вы используете qstyleoption_cast(), вам обычно не нужно проверять её.
См. также StyleOptionType.
перечисление QStyleOptionTab::TabFeatureфлаги QStyleOptionTab::TabFeatures
Описание различных особенностей, которые может иметь кнопка вкладки.
| Постоянная | Значение | Описание |
|---|---|---|
QStyleOptionTab::None |
0x00 |
Обычная кнопка вкладки. |
QStyleOptionTab::HasFrame |
0x01 |
Кнопка вкладки расположена на вкладке. |
Тип TabFeatures — это псевдоним для QFlags<TabFeature>. Он хранит логическое ИЛИ сочетание значений TabFeature.
См. также QStyleOptionToolBar::features.
enum QStyleOptionTab::TabPosition
Этот перечисление описывает расположение вкладки.
| Постоянная | Значение | Описание |
|---|---|---|
QStyleOptionTab::Beginning |
0 |
Вкладка является первой вкладкой в строке вкладок. |
QStyleOptionTab::Middle |
1 |
Вкладка не является ни первой, ни последней вкладкой в строке вкладок. |
QStyleOptionTab::End |
2 |
Вкладка является последней вкладкой в строке вкладок. |
QStyleOptionTab::OnlyOneTab |
3 |
Вкладка является одновременно первой и последней вкладкой в строке вкладок. |
См. также position.
Документация по членам-функциям
QStyleOptionTab::QStyleOptionTab(const QStyleOptionTab &other)
Создает копию стиля other.
QStyleOptionTab::QStyleOptionTab()
Создает объект QStyleOptionTab, инициализируя переменные-члены их значениями по умолчанию.
Документация по переменным-членам
QStyleOptionTab::CornerWidgets QStyleOptionTab::cornerWidgets
Эта переменная хранит логическое ИЛИ сочетание значений CornerWidget, указывающих на виджеты углов панели вкладок.
Значение по умолчанию — NoCornerWidgets.
См. также CornerWidget.
bool QStyleOptionTab::documentMode
Эта переменная хранит значение, указывающее, находится ли панель вкладок в режиме документа.
Значение по умолчанию — false.
QIcon QStyleOptionTab::icon
Эта переменная хранит значок вкладки.
Значение по умолчанию — пустой значок, т. е. значок без пиксельной карты и имени файла.
QSize QStyleOptionTab::iconSize
Эта переменная хранит размер значков.
Значение по умолчанию — QSize(-1, -1), т. е. недопустимый размер; используйте QStyle::pixelMetric(), чтобы найти размер значка по умолчанию для панелей вкладок.
См. также QTabBar::iconSize().
QSize QStyleOptionTab::leftButtonSize
Эта переменная хранит размер левого виджета на вкладке.
Значение по умолчанию — QSize(-1, -1), т. е. недопустимый размер.
QStyleOptionTab::TabPosition QStyleOptionTab::position
Эта переменная хранит расположение вкладки в панели вкладок.
Значение по умолчанию — Beginning, т. е. вкладка является первой вкладкой в панели вкладок.
QSize QStyleOptionTab::rightButtonSize
Эта переменная хранит размер правого виджета на вкладке.
Значение по умолчанию — QSize(-1, -1), т. е. недопустимый размер.
int QStyleOptionTab::row
Эта переменная хранит строку, в которой находится вкладка.
Значение по умолчанию — 0, указывающее на передний ряд. В настоящее время это свойство может быть только 0.
QStyleOptionTab::SelectedPosition QStyleOptionTab::selectedPosition
Эта переменная хранит расположение выделенной вкладки относительно данной вкладки.
Значение по умолчанию — NotAdjacent, т. е. вкладка не прилегает к выделенной вкладке и не является выделенной вкладкой.
QTabBar::Shape QStyleOptionTab::shape
Эта переменная хранит форму вкладки, используемую для рисования вкладки; по умолчанию QTabBar::RoundedNorth.
См. также QTabBar::Shape.
int QStyleOptionTab::tabIndex
Эта переменная хранит индекс представляемой вкладки.
Значение по умолчанию — -1, т. е. вкладка, не находящаяся на панели вкладок.
QString QStyleOptionTab::text
Эта переменная хранит текст вкладки.
Значение по умолчанию — пустая строка.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.1/qstyleoptiontab.html