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::NoCornerWidgets | 0x00 | コーナーウィジェットはありません |
QStyleOptionTab::LeftCornerWidget | 0x01 | 左隅のウィジェット |
QStyleOptionTab::RightCornerWidget | 0x02 | 右隅のウィジェット |
CornerWidgets 型は、QFlags<CornerWidget> の typedef です。CornerWidget 値の論理和(OR)を格納します。
cornerWidgetsも参照してください 。
enum QStyleOptionTab::SelectedPosition
この列挙型は、選択されているタブの位置を表します。一部のスタイルでは、タブが選択されているタブに隣接しているかどうかによって、タブの描画方法を変更する必要があります。
| 定数 | 値 | 説明 |
|---|---|---|
QStyleOptionTab::NotAdjacent | 0 | タブが選択されたタブに隣接していない(または、そのタブ自体が選択されたタブである)。 |
QStyleOptionTab::NextIsSelected | 1 | 次のタブ(通常は右側のタブ)が選択されています。 |
QStyleOptionTab::PreviousIsSelected | 2 | 前のタブ(通常は左側のタブ)が選択されています。 |
関連項目: selectedPosition 。
enum QStyleOptionTab::StyleOptionType
この列挙型は、スタイルオプションのタイプに関する情報を保持するために使用され、QStyleOption の各サブクラスに対して定義されています。
| 定数 | 定数値 | 説明 |
|---|---|---|
QStyleOptionTab::Type | SO_Tab | 指定されたスタイルオプションのタイプ(このクラスでは `SO_Tab `)。 |
この型は、QStyleOption 、そのサブクラス、およびqstyleoption_cast() によって、スタイルオプションの型を判別するために内部的に使用されます。一般的に、独自のQStyleOption サブクラスや独自のスタイルを作成する場合を除き、この点について気にする必要はありません。
StyleOptionVersionも参照してください 。
enum QStyleOptionTab::StyleOptionVersion
この列挙型は、スタイルオプションのバージョンに関する情報を保持するために使用され、QStyleOption の各サブクラスに対して定義されています。
| 定数 | 定数値 | 説明 |
|---|---|---|
QStyleOptionTab::Version | 1 | 3 |
このバージョンは、互換性を損なうことなく拡張機能を実装するために、QStyleOption のサブクラスで使用されます。qstyleoption_cast() を使用する場合、通常、これをチェックする必要はありません。
StyleOptionTypeも参照してください 。
enum QStyleOptionTab::TabFeature
flags QStyleOptionTab::TabFeatures
タブボタンが持つさまざまな機能について説明します。
| 定数 | 値 | 説明 |
|---|---|---|
QStyleOptionTab::None | 0x00 | 通常のタブボタンです。 |
QStyleOptionTab::HasFrame | 0x01 | タブボタンはタブフレーム上に配置されます |
QStyleOptionTab::MinimumSizeHint (since Qt 6.9) | 0x02 | タブボタンの最小サイズヒントが測定されています。これは、通常のサイズヒントとは対照的です。 |
TabFeatures 型は、QFlags<TabFeature> の typedef です。これは、TabFeature 値の論理和(OR)を格納します。
QStyleOptionToolBar::featuresも参照してください 。
enum QStyleOptionTab::TabPosition
この列挙型は、タブの位置を表します。
| 定数 | 値 | 説明 |
|---|---|---|
QStyleOptionTab::Beginning | 0 | このタブは、タブバーの最初のタブです。 |
QStyleOptionTab::Middle | 1 | このタブは、タブバーの最初でも最後でもないタブです。 |
QStyleOptionTab::End | 2 | このタブは、タブバーの最後のタブです。 |
QStyleOptionTab::OnlyOneTab | 3 | このタブは、タブバーの最初と最後のタブの両方です。 |
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.