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::Left | 0 | テキストの左 |
QStyleOptionViewItem::Right | 1 | テキストの右 |
QStyleOptionViewItem::Top | 2 | テキストの上 |
QStyleOptionViewItem::Bottom | 3 | テキストの下。 |
decorationPositionも参照してください 。
enum QStyleOptionViewItem::StyleOptionType
この列挙型は、スタイル・オプションのタイプに関する情報を保持するために使われ、QStyleOption サブクラスごとに定義されます。
定数 | 値 | 説明 |
---|---|---|
QStyleOptionViewItem::Type | SO_ViewItem | 提供されるスタイルオプションの型 (SO_ViewItem for this class)。 |
この型は、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 | 項目が装飾の役割を持つことを示す。 |
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 スタイル・オプションのコピーを構築します。
メンバ変数のドキュメント
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::TextElideMode とQStyle::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.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。