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 } |
| flags | TabFeatures |
| enum | TabPosition { Beginning, Middle, End, OnlyOneTab, Moving } |
パブリック関数
| QStyleOptionTab() | |
| QStyleOptionTab(const QStyleOptionTab &other) |
パブリック変数
| 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 組み込みウィジェットの描画に使用されます。
QStyleOptionTab クラスのインスタンスはtype SO_Tab とversion 3 を持っています。この型は、QStyleOption 、そのサブクラス、およびqstyleoption_cast() によって内部的に使用され、スタイル・オプションの型を決定します。一般的には、独自のQStyleOption サブクラスと独自のスタイルを作成するのでなければ、これを気にする必要はありません。このバージョンは、QStyleOption サブクラスが互換性を壊すことなく拡張機能を実装するために使用します。qstyleoption_cast() を使用する場合、通常はチェックする必要はありません。
パフォーマンス上の理由から、メンバ関数はほとんどなく、メンバ変数へのアクセスは直接（つまり、. または-> 演算子を使用）です。これにより、構造体を簡単に使用することができ、これらは単にスタイル関数で使用されるパラメータであることが強調されます。
QStyleOptionも参照してください 。
メンバ型のドキュメント
enum QStyleOptionTab::CornerWidget
flags QStyleOptionTab::CornerWidgets
これらのフラグは、タブのコーナーウィジェットを示します。
| 定数 | 値 | 説明 |
|---|---|---|
QStyleOptionTab::NoCornerWidgets | 0x00 | コーナーウィジェットがない |
QStyleOptionTab::LeftCornerWidget | 0x01 | 左コーナーウィジェット |
QStyleOptionTab::RightCornerWidget | 0x02 | 右コーナーウィジェット |
CornerWidgets型はQFlags<CornerWidget>のtypedefです。コーナーウィジェットの値の 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 | タブボタンはタブフレーム上に配置される。 |
TabFeatures 型はQFlags<TabFeature> の typedef です。TabFeaturesの値の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 スタイルオプションのコピーを構築する。
メンバ変数ドキュメント
QStyleOptionTab::CornerWidgets QStyleOptionTab::cornerWidgets
この変数は、タブバーのコーナーウィジェットを示すCornerWidget の値の OR の組み合わせを保持する。
デフォルト値はNoCornerWidgets です。
CornerWidgetも参照してください 。
bool QStyleOptionTab::documentMode
この変数はタブバーがドキュメントモードであるかどうかを保持する。
デフォルト値はfalseです；
QIcon QStyleOptionTab::icon
この変数はタブのアイコンを保持する。
デフォルト値は空のアイコンで、pixmapもファイル名も持たないアイコンです。
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
この変数はタブのテキストを保持する。
デフォルト値は空文字列です。
© 2025 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.
