QStyleOptionViewItem Class

QStyleOptionViewItemクラスは、ビューウィジェットで項目を描画するために使用されるパラメータを記述するために使用されます。詳細...

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

パブリックな型

enum Position { Left, Right, Top, Bottom }
enum StyleOptionType { Type }
enum StyleOptionVersion { Version }
enum ViewItemFeature { None, WrapText, Alternate, HasCheckIndicator, HasDisplay, HasDecoration }
flags ViewItemFeatures
enum ViewItemPosition { Invalid, Beginning, Middle, End, OnlyOne }

パブリック関数

QStyleOptionViewItem()
QStyleOptionViewItem(const QStyleOptionViewItem &other)

パブリック変数

QBrush backgroundBrush
Qt::CheckState checkState
Qt::Alignment decorationAlignment
QStyleOptionViewItem::Position decorationPosition
QSize decorationSize
Qt::Alignment displayAlignment
QStyleOptionViewItem::ViewItemFeatures features
QFont font
QIcon icon
QModelIndex index
QLocale locale
bool showDecorationSelected
QString text
Qt::TextElideMode textElideMode
QStyleOptionViewItem::ViewItemPosition viewItemPosition
const QWidget *widget

詳細な説明

QStyleOptionViewItemは、QStyle 関数がQtのモデル/ビュークラスのアイテムを描画するために必要なすべての情報を含んでいます。

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

QStyleOption およびModel/View Programmingも参照してください

メンバ型のドキュメント

enum QStyleOptionViewItem::Position

この列挙型は、アイテムの装飾の位置を記述する。

定数説明
QStyleOptionViewItem::Left0テキストの左
QStyleOptionViewItem::Right1テキストの右
QStyleOptionViewItem::Top2テキストの上
QStyleOptionViewItem::Bottom3テキストの下。

decorationPositionも参照

enum QStyleOptionViewItem::StyleOptionType

この列挙型は、スタイル・オプションのタイプに関する情報を保持するために使われ、QStyleOption のサブクラスごとに定義される。

定数説明
QStyleOptionViewItem::TypeSO_ViewItem提供されるスタイル・オプションの型 ( このクラスではSO_ViewItem )。

この型は、QStyleOption 、そのサブクラス、およびqstyleoption_cast() によって内部的に使用され、スタイル・オプションの型を決定します。一般に、独自のQStyleOption サブクラスと独自のスタイルを作成するのでなければ、これを気にする必要はありません。

StyleOptionVersionも参照してください

enum QStyleOptionViewItem::StyleOptionVersion

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

定数説明
QStyleOptionViewItem::Version14

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

StyleOptionTypeも参照してください

enum QStyleOptionViewItem::ViewItemFeature
flags QStyleOptionViewItem::ViewItemFeatures

この列挙型は、項目が持つことができる機能の異なるタイプを記述します。

定数説明
QStyleOptionViewItem::None0x00通常の項目を示します。
QStyleOptionViewItem::WrapText0x01折り返しテキストを持つ項目を示す。
QStyleOptionViewItem::Alternate0x02アイテムの背景が alternateBase を使用してレンダリングされていることを示す。
QStyleOptionViewItem::HasCheckIndicator0x04項目がチェック状態インジケータを持つことを示す。
QStyleOptionViewItem::HasDisplay0x08アイテムが表示ロールを持つことを示す。
QStyleOptionViewItem::HasDecoration0x10項目が装飾の役割を持つことを示す。

ViewItemFeatures 型は、QFlags<ViewItemFeature> の typedef です。これは、ViewItemFeature 値の OR の組み合わせを格納します。

enum QStyleOptionViewItem::ViewItemPosition

この列挙型は、行における項目の配置を表すのに使われる。例えば、最初と最後には丸みを帯びたエッジを置き、その間には直線的なエッジを置くなど、アイテムの配置によって異なる描画を行うために使用することができます。

定数説明
QStyleOptionViewItem::Invalid0ViewItemPosition は不明であり、無視されるべきである。
QStyleOptionViewItem::Beginning1項目は行の先頭に表示されます。
QStyleOptionViewItem::Middle2項目は行の中央に表示される。
QStyleOptionViewItem::End3項目が行の末尾に表示される。
QStyleOptionViewItem::OnlyOne4項目は行の唯一のものであり、したがって行の最初と最後の両方にある。

メンバ関数ドキュメント

QStyleOptionViewItem::QStyleOptionViewItem()

QStyleOptionViewItemを構築し、メンバ変数をデフォルト値に初期化します。

QStyleOptionViewItem::QStyleOptionViewItem(const QStyleOptionViewItem &other)

other スタイルオプションのコピーを構築する。

メンバ変数ドキュメント

QBrush QStyleOptionViewItem::backgroundBrush

QBrush ビューアイテムの背景をペイントするために使用する。

Qt::CheckState QStyleOptionViewItem::checkState

このビュー項目がチェック可能な場合、すなわち ViewItemFeature::HasCheckIndicator が true の場合、項目がチェックされていればcheckState は true、そうでなければ false となる。

Qt::Alignment QStyleOptionViewItem::decorationAlignment

この変数は、アイテムの装飾のアライメントを保持します。

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

QStyleOptionViewItem::Position QStyleOptionViewItem::decorationPosition

この変数は、アイテムの装飾の位置を保持します。

デフォルト値はLeft です。

Positionも参照してください

QSize QStyleOptionViewItem::decorationSize

この変数はアイテムの装飾のサイズを保持する。

デフォルト値はQSize(-1, -1)、つまり無効なサイズです。

decorationAlignment およびdecorationPositionも参照して ください。

Qt::Alignment QStyleOptionViewItem::displayAlignment

この変数は、アイテムの表示値のアライメントを保持する。

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

QStyleOptionViewItem::ViewItemFeatures QStyleOptionViewItem::features

この変数は、このビュー項目を説明する特徴のビット OR を保持します。

ViewItemFeatureも参照してください

QFont QStyleOptionViewItem::font

この変数は、アイテムに使用されるフォントを保持します。

デフォルトでは、アプリケーションのデフォルトフォントが使われます。

QFontも参照してください

QIcon QStyleOptionViewItem::icon

ビューアイテムに描画されるアイコン(もしあれば)。

QModelIndex QStyleOptionViewItem::index

描画されるモデルのインデックス。

QLocale QStyleOptionViewItem::locale

この変数は、テキスト、数字、日付の表示に使用するロケールを保持します。

これにより、アプリケーションのデフォルトロケールとは異なるロケールで日付などを表示することができます。

bool QStyleOptionViewItem::showDecorationSelected

この変数は、選択されたアイテムの装飾をハイライトするかどうかを保持する。

このオプションがtrueの場合、選択されたアイテムの枝と装飾は強調表示され、そのアイテムが選択されていることを示します。そ う でなければ、 ハイ ラ イ ト 表示は必要あ り ません。 デフ ォル ト 値は false です。

QStyle::SH_ItemView_ShowDecorationSelected およびQAbstractItemViewも参照して ください。

QString QStyleOptionViewItem::text

ビュー項目に描画されるテキスト(もしあれば)。

Qt::TextElideMode QStyleOptionViewItem::textElideMode

長すぎて項目に収まらないテキストに省略記号を追加する場所。

デフ ォル ト 値はQt::ElideMiddle で、 すなわち省略記号はテキス ト の中央に現れます。

Qt::TextElideModeQStyle::SH_ItemView_EllipsisLocationも参照して ください。

QStyleOptionViewItem::ViewItemPosition QStyleOptionViewItem::viewItemPosition

このビュー項目の他の項目に対する相対位置を与える。詳細はViewItemPosition enum を参照。

const QWidget *QStyleOptionViewItem::widget

この変数は、アイテムの親ウィジェットを保持します。

このメンバはアイテムの親ウィジェット(itemview)を保持し、QStyledItemDelegate メソッド内でいくつかのプロパティにアクセスできるようにします。

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