このページでは

QStyleOptionTab Class

QStyleOptionTab クラスは、タブバーを描画するためのパラメータを定義するために使用されます。詳細...

ヘッダー: #include <QStyleOptionTab>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
継承元: QStyleOption

パブリック型

enum CornerWidget { NoCornerWidgets, LeftCornerWidget, RightCornerWidget }
flags CornerWidgets
enum SelectedPosition { NotAdjacent, NextIsSelected, PreviousIsSelected }
enum StyleOptionType { Type }
enum StyleOptionVersion { Version }
enum TabFeature { None, HasFrame, MinimumSizeHint }
flags TabFeatures
enum TabPosition { Beginning, Middle, End, OnlyOneTab, Moving }

パブリック関数

QStyleOptionTab()
QStyleOptionTab(const QStyleOptionTab &other)
QStyleOptionTab &operator=(const 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 クラスは、QTabBar やQTabWidget のパネルなど、いくつかの組み込み Qt Widgets の描画に使用されます。

QStyleOptionTab クラスのインスタンスには、type 、SO_Tab 、およびversion 3 があります。この型は、QStyleOption 、そのサブクラス、およびqstyleoption_cast() によって、スタイルオプションの型を判別するために内部的に使用されます。 一般的に、独自のQStyleOption のサブクラスや独自のスタイルを作成したい場合を除き、これについて気にする必要はありません。versionは、QStyleOption のサブクラスにおいて、互換性を損なうことなく拡張機能を実装するために使用されます。qstyleoption_cast()を使用する場合、通常はこれを確認する必要はありません。

パフォーマンス上の理由から、メンバ関数は少なく、メンバ変数へのアクセスは直接行われます(つまり、. や-> 演算子を使用します)。これにより、構造体の使用が簡単になり、これらが単にスタイル関数によって使用されるパラメータにすぎないことが強調されます。

QStyleOptionも参照してください 。

メンバ型のドキュメント

enum QStyleOptionTab::CornerWidget
flags QStyleOptionTab::CornerWidgets

これらのフラグは、タブ内のコーナーウィジェットを示しています。

定数値説明
QStyleOptionTab::NoCornerWidgets0x00コーナーウィジェットはありません
QStyleOptionTab::LeftCornerWidget0x01左隅のウィジェット
QStyleOptionTab::RightCornerWidget0x02右隅のウィジェット

CornerWidgets 型は、QFlags<CornerWidget> の typedef です。CornerWidget 値の論理和(OR)を格納します。

cornerWidgetsも参照してください 。

enum QStyleOptionTab::SelectedPosition

この列挙型は、選択されているタブの位置を表します。一部のスタイルでは、タブが選択されているタブに隣接しているかどうかによって、タブの描画方法を変更する必要があります。

定数値説明
QStyleOptionTab::NotAdjacent0タブが選択されたタブに隣接していない(または、そのタブ自体が選択されたタブである)。
QStyleOptionTab::NextIsSelected1次のタブ(通常は右側のタブ)が選択されています。
QStyleOptionTab::PreviousIsSelected2前のタブ(通常は左側のタブ)が選択されています。

関連項目: selectedPosition 。

enum QStyleOptionTab::StyleOptionType

この列挙型は、スタイルオプションのタイプに関する情報を保持するために使用され、QStyleOption の各サブクラスに対して定義されています。

定数定数値説明
QStyleOptionTab::TypeSO_Tab指定されたスタイルオプションのタイプ(このクラスでは `SO_Tab `)。

この型は、QStyleOption 、そのサブクラス、およびqstyleoption_cast() によって、スタイルオプションの型を判別するために内部的に使用されます。一般的に、独自のQStyleOption サブクラスや独自のスタイルを作成する場合を除き、この点について気にする必要はありません。

StyleOptionVersionも参照してください 。

enum QStyleOptionTab::StyleOptionVersion

この列挙型は、スタイルオプションのバージョンに関する情報を保持するために使用され、QStyleOption の各サブクラスに対して定義されています。

定数定数値説明
QStyleOptionTab::Version13

このバージョンは、互換性を損なうことなく拡張機能を実装するために、QStyleOption のサブクラスで使用されます。qstyleoption_cast() を使用する場合、通常、これをチェックする必要はありません。

StyleOptionTypeも参照してください 。

enum QStyleOptionTab::TabFeature
flags QStyleOptionTab::TabFeatures

タブボタンが持つさまざまな機能について説明します。

定数値説明
QStyleOptionTab::None0x00通常のタブボタンです。
QStyleOptionTab::HasFrame0x01タブボタンはタブフレーム上に配置されます
QStyleOptionTab::MinimumSizeHint (since Qt 6.9)0x02タブボタンの最小サイズヒントが測定されています。これは、通常のサイズヒントとは対照的です。

TabFeatures 型は、QFlags<TabFeature> の typedef です。これは、TabFeature 値の論理和(OR)を格納します。

QStyleOptionToolBar::featuresも参照してください 。

enum QStyleOptionTab::TabPosition

この列挙型は、タブの位置を表します。

定数値説明
QStyleOptionTab::Beginning0このタブは、タブバーの最初のタブです。
QStyleOptionTab::Middle1このタブは、タブバーの最初でも最後でもないタブです。
QStyleOptionTab::End2このタブは、タブバーの最後のタブです。
QStyleOptionTab::OnlyOneTab3このタブは、タブバーの最初と最後のタブの両方です。
QStyleOptionTab::Moving (since Qt 6.6)4このタブは、マウスのドラッグまたはアニメーションによって移動しています。

関連項目: position 。

メンバ関数のドキュメント

QStyleOptionTab::QStyleOptionTab()

QStyleOptionTab オブジェクトを構築し、メンバー変数をデフォルト値で初期化します。

QStyleOptionTab::QStyleOptionTab(const QStyleOptionTab &other)

other スタイルオプションのコピーを作成します。

[noexcept default] QStyleOptionTab &QStyleOptionTab::operator=(const QStyleOptionTab &)

other をこのQStyleOptionTab インスタンスにコピー代入します。

メンバ変数のドキュメント

QStyleOptionTab::CornerWidgets QStyleOptionTab::cornerWidgets

この変数には、タブバーのコーナーウィジェットを示す「CornerWidget 」値の論理和(OR)が格納されます。

デフォルト値は `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

この変数には、タブのテキストが格納されます

デフォルト値は空の文字列です。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.