QStyleOptionViewItem Class

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

Header: #include <QStyleOptionViewItem>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Inherits: 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
bool showDecorationSelected
QString text
Qt::TextElideMode textElideMode
QStyleOptionViewItem::ViewItemPosition viewItemPosition

詳細な説明

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 for this class)。

この型は、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

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

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 を参照してください。

©2024 The Qt Company Ltd. 本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。