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, …, IsDecorationForRootColumn } |
| flags | ViewItemFeatures |
| enum | ViewItemPosition { Invalid, Beginning, Middle, End, OnlyOne } |
パブリック関数
| QStyleOptionViewItem() | |
| QStyleOptionViewItem(const QStyleOptionViewItem &other) | |
| QStyleOptionViewItem & | operator=(const QStyleOptionViewItem &) |
パブリック変数
| 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 」および「モデル／ビュープログラミング」も参照してください 。
メンバ型のドキュメント
enum QStyleOptionViewItem::Position
この列挙型は、アイテムの装飾の位置を表します。
| 定数 | 値 | 説明 |
|---|---|---|
QStyleOptionViewItem::Left | 0 | テキストの左側。 |
QStyleOptionViewItem::Right | 1 | テキストの右側。 |
QStyleOptionViewItem::Top | 2 | テキストの上。 |
QStyleOptionViewItem::Bottom | 3 | テキストの下。 |
「decorationPosition」も参照してください 。
enum QStyleOptionViewItem::StyleOptionType
この列挙型は、スタイルオプションのタイプに関する情報を保持するために使用され、QStyleOption の各サブクラスに対して定義されています。
| 定数 | 定数値 | 説明 |
|---|---|---|
QStyleOptionViewItem::Type | SO_ViewItem | 指定されたスタイルオプションのタイプ（このクラスでは `SO_ViewItem `）。 |
この型は、QStyleOption 、そのサブクラス、およびqstyleoption_cast() によって、スタイルオプションの型を判別するために内部的に使用されます。一般的に、独自のQStyleOption サブクラスや独自のスタイルを作成したい場合を除き、この点について気にする必要はありません。
StyleOptionVersionも参照してください 。
enum QStyleOptionViewItem::StyleOptionVersion
この列挙型は、スタイルオプションのバージョンに関する情報を保持するために使用され、QStyleOption の各サブクラスに対して定義されています。
| 定数 | 定数値 | 説明 |
|---|---|---|
QStyleOptionViewItem::Version | 1 | 4 |
このバージョンは、互換性を損なうことなく拡張機能を実装するために、QStyleOption のサブクラスで使用されます。qstyleoption_cast() を使用する場合、通常、これを確認する必要はありません。
StyleOptionTypeも参照してください 。
enum QStyleOptionViewItem::ViewItemFeature
flags QStyleOptionViewItem::ViewItemFeatures
この列挙型は、アイテムが持つことができるさまざまな種類の特徴を表します。
| 定数 | 値 | 説明 |
|---|---|---|
QStyleOptionViewItem::None | 0x00 | 通常のアイテムを示します。 |
QStyleOptionViewItem::WrapText | 0x01 | テキストが折り返されているアイテムを示します。 |
QStyleOptionViewItem::Alternate | 0x02 | 項目の背景が alternateBase を使用してレンダリングされることを示します。 |
QStyleOptionViewItem::HasCheckIndicator | 0x04 | 項目にチェック状態インジケータがあることを示します。 |
QStyleOptionViewItem::HasDisplay | 0x08 | その項目に表示ロールがあることを示します。 |
QStyleOptionViewItem::HasDecoration | 0x10 | アイテムに装飾ロールがあることを示します。 |
QStyleOptionViewItem::IsDecoratedRootColumn (since Qt 6.9) | 0x20 | アイテムに描画用のツリービューのブランチ部分があることを示します。 |
QStyleOptionViewItem::IsDecorationForRootColumn (since Qt 6.9) | 0x40 | アイテムにツリービューのブランチ部分を描画するための情報が含まれていることを示します。 |
ViewItemFeatures 型は、QFlags<ViewItemFeature> の typedef です。これは、ViewItemFeature 値の OR 組み合わせを格納します。
enum QStyleOptionViewItem::ViewItemPosition
この列挙型は、行上の項目の配置を表すために使用されます。これを利用することで、配置に応じて項目の描画方法を変更することができます。例えば、先頭と末尾を丸くし、その間を直線にするといったことが可能です。
| 定数 | 値 | 説明 |
|---|---|---|
QStyleOptionViewItem::Invalid | 0 | ViewItemPosition は不明であり、無視してください。 |
QStyleOptionViewItem::Beginning | 1 | アイテムは行の先頭に表示されます。 |
QStyleOptionViewItem::Middle | 2 | 項目は行の中央に表示されます。 |
QStyleOptionViewItem::End | 3 | 項目は行の末尾に表示されます。 |
QStyleOptionViewItem::OnlyOne | 4 | その項目は行に唯一の項目であるため、行の先頭と末尾の両方に位置します。 |
メンバー関数のドキュメント
QStyleOptionViewItem::QStyleOptionViewItem()
QStyleOptionViewItem を作成し、メンバー変数をデフォルト値で初期化します。
QStyleOptionViewItem::QStyleOptionViewItem(const QStyleOptionViewItem &other)
other スタイルオプションのコピーを作成します。
[noexcept default] QStyleOptionViewItem &QStyleOptionViewItem::operator=(const QStyleOptionViewItem &)
other をこのQStyleOptionViewItem インスタンスにコピー代入します。
メンバ変数のドキュメント
QBrush QStyleOptionViewItem::backgroundBrush
ビュー項目の背景を描画するために使用するべきQBrush です。
Qt::CheckState QStyleOptionViewItem::checkState
このビュー項目がチェック可能である場合、つまり `ViewItemFeature::HasCheckIndicator ` が真である場合、項目がチェックされているときは `checkState ` が真となり、そうでない場合は偽となります。
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::TextElideMode 」および「QStyle::SH_ItemView_EllipsisLocation 」も参照してください 。
QStyleOptionViewItem::ViewItemPosition QStyleOptionViewItem::viewItemPosition
このビュー項目の、他の項目に対する相対的な位置を示します。詳細については、ViewItemPosition 列挙型を参照してください。
const QWidget *QStyleOptionViewItem::widget
この変数には、アイテムの親ウィジェットが格納されます
このメンバには、アイテムの親ウィジェット（itemview）が格納されており、これにより、例えばQStyledItemDelegate メソッド内で一部のプロパティにアクセスできるようになります。
© 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.
