このページでは

QStyleOptionHeader Class

QStyleOptionHeader クラスは、ヘッダーを描画するためのパラメータを記述するために使用されます。詳細...

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

QStyleOptionHeaderV2

パブリック型

enum SectionPosition { Beginning, Middle, End, OnlyOneSection }
enum SelectedPosition { NotAdjacent, NextIsSelected, PreviousIsSelected, NextAndPreviousAreSelected }
enum SortIndicator { None, SortUp, SortDown }
enum StyleOptionType { Type }
enum StyleOptionVersion { Version }

パブリック関数

QStyleOptionHeader()
QStyleOptionHeader(const QStyleOptionHeader &other)
QStyleOptionHeader &operator=(const QStyleOptionHeader &)

パブリック変数

QIcon icon
Qt::Alignment iconAlignment
Qt::Orientation orientation
QStyleOptionHeader::SectionPosition position
int section
QStyleOptionHeader::SelectedPosition selectedPosition
QStyleOptionHeader::SortIndicator sortIndicator
QString text
Qt::Alignment textAlignment

詳細な説明

QStyleOptionHeader には、QStyle 関数がアイテムビューのヘッダーペイン、ヘッダーのソート用矢印、およびヘッダーラベルを描画するために必要なすべての情報が含まれています。

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

QStyleOptionも参照してください 。

メンバ型のドキュメント

enum QStyleOptionHeader::SectionPosition

この列挙型は、そのセクションが他のセクションに対してどの位置にあるかを示します。

定数値説明
QStyleOptionHeader::Beginning0ヘッダーの先頭
QStyleOptionHeader::Middle1ヘッダーの中央
QStyleOptionHeader::End2ヘッダーの末尾
QStyleOptionHeader::OnlyOneSection3ヘッダーセクションは1つだけ

positionも参照してください 。

enum QStyleOptionHeader::SelectedPosition

この列挙型は、選択されたセクションに対する当該セクションの位置を知ることができます。

定数値説明
QStyleOptionHeader::NotAdjacent0選択されたセクションに隣接していない
QStyleOptionHeader::NextIsSelected1次のセクションが選択されている
QStyleOptionHeader::PreviousIsSelected2前のセクションが選択されています
QStyleOptionHeader::NextAndPreviousAreSelected3次のセクションと前のセクションの両方が選択されています

関連項目: selectedPosition 。

enum QStyleOptionHeader::SortIndicator

ソートインジケーターを描画する方向を示します

定数値説明
QStyleOptionHeader::None0ソートインジケータは不要
QStyleOptionHeader::SortUp1上向きのインジケータを描画する
QStyleOptionHeader::SortDown2下降インジケータを描画する

関連項目: sortIndicator 。

enum QStyleOptionHeader::StyleOptionType

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

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

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

StyleOptionVersionも参照してください 。

enum QStyleOptionHeader::StyleOptionVersion

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

定数定数値説明
QStyleOptionHeader::Version11

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

StyleOptionTypeも参照してください 。

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

QStyleOptionHeader::QStyleOptionHeader()

QStyleOptionHeader を作成し、メンバー変数をデフォルト値で初期化します。

QStyleOptionHeader::QStyleOptionHeader(const QStyleOptionHeader &other)

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

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

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

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

QIcon QStyleOptionHeader::icon

この変数には、ヘッダーのアイコンが格納されます

デフォルト値は空のアイコン、つまりピクマップもファイル名も指定されていないアイコンです。

Qt::Alignment QStyleOptionHeader::iconAlignment

この変数には、ヘッダーのアイコンの配置フラグが格納されます

デフォルト値は `Qt::AlignLeft` です。

Qt::Orientation QStyleOptionHeader::orientation

この変数には、ヘッダーの向き(横向きまたは縦向き)が格納されます。

デフォルトの向きはQt::Horizontal

QStyleOptionHeader::SectionPosition QStyleOptionHeader::position

この変数は、他のセクションに対する当該セクションの位置を保持します

デフォルト値はQStyleOptionHeader::Beginning です。

int QStyleOptionHeader::section

この変数には、ヘッダーのどのセクションが描画されているかが格納されます

デフォルト値は 0 です。

QStyleOptionHeader::SelectedPosition QStyleOptionHeader::selectedPosition

この変数には、選択されたセクションに対する当該セクションの位置が格納されます

デフォルト値はQStyleOptionHeader::NotAdjacent

QStyleOptionHeader::SortIndicator QStyleOptionHeader::sortIndicator

この変数には、ソートインジケーターを描画する方向が格納されます

デフォルト値はQStyleOptionHeader::None です。

QString QStyleOptionHeader::text

この変数にはヘッダーのテキストが格納されます

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

Qt::Alignment QStyleOptionHeader::textAlignment

この変数には、ヘッダーのテキストに対する配置フラグが格納されます

デフォルト値はQt::AlignLeft です。

© 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.