コレクション
GridView グリッドビュー
均一なセルのグリッドに項目を配置し、選択できるようにします。
サンプル
プロパティプレビューを読み込めませんでした。もう一度「プロパティプレビュー」を選択して再試行してください。

使い方
GridView フォトグリッド
setCellSize() でタイルのサイズを設定し、setMaxColumns() で最大列数を制限します。組み込みのタイルはテキスト、QIcon、QColor を描画でき、カスタムデリゲートで独自のカードを作成することもできます。
#include <FluentQt/Collections.h>
using namespace fluent::collections;
auto* gridView = new GridView(this);
gridView->setCellSize(QSize(150, 112));
gridView->setItemDelegate(photoDelegate);
gridView->setModel(model);
gridView->setSelectedIndex(0);import fluentqt
from PySide6.QtCore import QSize
grid_view = fluentqt.GridView()
grid_view.setCellSize(QSize(150, 112))
grid_view.setItemDelegate(photo_delegate)
grid_view.setModel(model)
grid_view.setSelectedIndex(0)API
宣言を表示一致する API メンバーはありません。
fluent::collections::GridView
継承元 QListView · FluentElement · QMLPlus
セルサイズ、間隔、最大列数を設定できるグリッドコレクションビューです。Fluent の選択表示、任意のヘッダー/プレースホルダーテキスト、オーバースクロール、ドラッグによる並べ替えに対応しています。
コンストラクタ
デストラクタ
メソッド
SelectionMode selectionMode() constコレクションビューで使用される選択モードです。
void setSelectionMode(SelectionMode mode)コレクションビューで使用される選択モードです。
Typography::FontRole fontRole() constテキスト描画に使用される Fluent タイポグラフィロール。
void setFontRole(Typography::FontRole role)テキスト描画に使用される Fluent タイポグラフィロール。
bool borderVisible() constコントロールの枠線を描画するかどうか。
void setBorderVisible(bool visible)コントロールの枠線を描画するかどうか。
bool backgroundVisible() constコントロールの背景を描画するかどうか。
void setBackgroundVisible(bool visible)コントロールの背景を描画するかどうか。
QString headerText() constヘッダー領域に表示される簡易テキスト。
void setHeaderText(const QString& text)ヘッダー領域に表示される簡易テキスト。
QString placeholderText() constモデルに項目がないときに表示されるテキストです。
void setPlaceholderText(const QString& text)モデルに項目がないときに表示されるテキストです。
bool viewportHovered() constビューポートが現在ホバーされているかどうか。
bool canReorderItems() constドラッグによる並べ替えが有効かどうかです。
void setCanReorderItems(bool enabled)ドラッグによる並べ替えが有効かどうかです。
bool isScrollChainingEnabled() constスクロール境界でのホイール入力を外側のスクローラーへ引き継ぐかどうかです。
void setScrollChainingEnabled(bool enabled)スクロール境界でのホイール入力を外側のスクローラーへ引き継ぐかどうかです。
bool isOverscrollEnabled() constスクロール境界で弾性オーバースクロールのバウンスを有効にするかどうかです。デフォルトで有効であり、端でそのまま停止させたい場合は無効にします。
void setOverscrollEnabled(bool enabled)スクロール境界で弾性オーバースクロールのバウンスを有効にするかどうかです。デフォルトで有効であり、端でそのまま停止させたい場合は無効にします。
QSize cellSize() const項目レイアウトに使用されるグリッドセルサイズ。
void setCellSize(const QSize& size)項目レイアウトに使用されるグリッドセルサイズ。
int horizontalSpacing() const項目間の水平方向の間隔。
void setHorizontalSpacing(int spacing)項目間の水平方向の間隔。
int verticalSpacing() const項目間の垂直間隔です。
void setVerticalSpacing(int spacing)項目間の垂直間隔です。
int maxColumns() const最大列数です。0 は無制限を意味します。
void setMaxColumns(int maxCols)最大列数です。0 は無制限を意味します。
プロパティ
SelectionMode selectionModeコレクションビューで使用される選択モードです。
読み取りselectionMode()書き込みsetSelectionMode()通知シグナルselectionModeChanged()Typography::FontRole fontRoleテキスト描画に使用される Fluent タイポグラフィロール。
読み取りfontRole()書き込みsetFontRole()通知シグナルfontRoleChanged()bool viewportHoveredビューポートが現在ホバーされているかどうか。
読み取りviewportHovered()通知シグナルviewportHoveredChanged()bool canReorderItemsドラッグによる並べ替えが有効かどうかです。
読み取りcanReorderItems()書き込みsetCanReorderItems()通知シグナルcanReorderItemsChanged()bool scrollChainingEnabledスクロール境界でのホイール入力を外側のスクローラーへ引き継ぐかどうかです。
読み取りisScrollChainingEnabled()書き込みsetScrollChainingEnabled()通知シグナルscrollChainingEnabledChanged()bool overscrollEnabledスクロール境界で弾性オーバースクロールのバウンスを有効にするかどうかです。デフォルトで有効であり、端でそのまま停止させたい場合は無効にします。
読み取りisOverscrollEnabled()書き込みsetOverscrollEnabled()通知シグナルoverscrollEnabledChanged()bool borderVisibleコントロールの枠線を描画するかどうか。
読み取りborderVisible()書き込みsetBorderVisible()通知シグナルborderVisibleChanged()bool backgroundVisibleコントロールの背景を描画するかどうか。
読み取りbackgroundVisible()書き込みsetBackgroundVisible()通知シグナルbackgroundVisibleChanged()QString headerTextヘッダー領域に表示される簡易テキスト。
読み取りheaderText()書き込みsetHeaderText()通知シグナルheaderTextChanged()QString placeholderTextモデルに項目がないときに表示されるテキストです。
読み取りplaceholderText()書き込みsetPlaceholderText()通知シグナルplaceholderTextChanged()QSize cellSize項目レイアウトに使用されるグリッドセルサイズ。
読み取りcellSize()書き込みsetCellSize()通知シグナルcellSizeChanged()int horizontalSpacing項目間の水平方向の間隔。
読み取りhorizontalSpacing()書き込みsetHorizontalSpacing()通知シグナルhorizontalSpacingChanged()int verticalSpacing項目間の垂直間隔です。
読み取りverticalSpacing()書き込みsetVerticalSpacing()通知シグナルverticalSpacingChanged()int maxColumns最大列数です。0 は無制限を意味します。
読み取りmaxColumns()書き込みsetMaxColumns()通知シグナルmaxColumnsChanged()
シグナル
void selectionModeChanged()コレクションビューで使用される選択モードです。
void fontRoleChanged()テキスト描画に使用される Fluent タイポグラフィロール。
void viewportHoveredChanged()ビューポートが現在ホバーされているかどうか。
void borderVisibleChanged()コントロールの枠線を描画するかどうか。
void backgroundVisibleChanged()コントロールの背景を描画するかどうか。
void headerTextChanged()ヘッダー領域に表示される簡易テキスト。
void placeholderTextChanged()モデルに項目がないときに表示されるテキストです。
void cellSizeChanged()項目レイアウトに使用されるグリッドセルサイズ。
void horizontalSpacingChanged()項目間の水平方向の間隔。
void verticalSpacingChanged()項目間の垂直間隔です。
void maxColumnsChanged()最大列数です。0 は無制限を意味します。
void canReorderItemsChanged()ドラッグによる並べ替えが有効かどうかです。
void scrollChainingEnabledChanged()スクロール境界でのホイール入力を外側のスクローラーへ引き継ぐかどうかです。
void overscrollEnabledChanged()スクロール境界で弾性オーバースクロールのバウンスを有効にするかどうかです。デフォルトで有効であり、端でそのまま停止させたい場合は無効にします。
void itemClicked(int index)QAbstractItemView::clicked() と併せて、クリックされた行インデックスを送出する便利なシグナル。
型とエイリアス
PySide6 拡張
protected メンバー
メソッド
fluent::FluentElement から継承
列挙型
enum Themeデザイントークン解決時に使用されるグローバルな視覚テーマ。
Light = 0Dark = 1HighContrast = 2
メソッド
static void setTheme(Theme theme)グローバルテーマを更新し、アクティブな FluentElement インスタンスに通知します。
static void setThemeDeferred(Theme theme)現在の操作をブロックせずに、可視要素を優先したバッチ処理でテーマの更新をスケジュールします。
static Theme currentTheme()現在有効なグローバルテーマを返します。
static bool themeUsesDarkAppearance(Theme theme)テーマがダークベースのクロームおよびマテリアルトークンを使用するかどうかを返します。
static void refreshTheme()デザイントークンの変更後に再描画するため、現在のテーマを再ブロードキャストします。
static int themeGeneration()テーマ変更ごとに加算される単調増加カウンターです。鮮度チェックに使用されます。
Theme effectiveTheme() const継承された QWidget の上書きを尊重し、この要素が使用するテーマを解決します。
bool effectiveThemeUsesDarkAppearance() constこの要素の有効なテーマがダークベースのクロームを使用するかどうかを返します。
bool setThemeOverrides(const QJsonObject& overrides)この要素のスパースな色、角丸半径、フォントトークンの上書きを置き換えます。
QJsonObject themeOverrides() constこの要素に設定されたオーバーライドを返します。
void clearThemeOverrides()すべてのトークンフィールドをグローバルテーマの既定値に復元します。
const Colors& themeColorsRef() const描画のホットパス向けにアクティブなカラーセットへ非コピーでアクセスします。
Material::AcrylicToken themeAcrylic() constマテリアル、エレベーション、およびアダプティブレイアウトのトークン。
QColor themeBackdrop(bool active) const指定されたアクティブ状態に対するウィンドウ chrome の背景色。
virtual void onThemeUpdated()グローバルテーマの変更後に呼び出されます。
型とエイリアス
struct Colorsコンポーネントに返されるデザイントークンのスナップショット。
fluent::QMLPlus から継承
メソッド
AnchorLayout::Anchors* anchors()QWidget ホストの変更可能なアンカーを返します。
void setState(const QString& name)登録済みの状態を名前で適用するか、@p name が空の場合はデフォルト状態を復元します。未知の名前は無視され、その状態を離れると既存のバインディングが再開されます。
void addState(const QMLState& state)名前付き状態定義を登録または置換します。アクティブな状態を置換した場合は即座に適用されます。
void evaluateStates()登録順に状態条件を再評価し、最初に一致した状態(一致しない場合はデフォルト状態)をアクティブにします。依存プロパティの変更通知時にも自動実行され、extend を使用する派生状態は、循環や欠損がない限り祖先の変更を継承します。
QMLPlusRuntime* runtime()このホストが所有し、遅延生成される状態オブザーバーを返します。
void setAnchors(const AnchorLayout::Anchors& anchors)すべてのホストアンカーを置き換え、親レイアウトを無効化します。
void resetAnchors()ホストのすべてのアンカーをクリアし、親レイアウトを無効化します。
void bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay)PropertyBinder::bind() を介して、@p source の @p sourceProp をこの QWidget ホストの @p targetProp にバインドします。
BindingHandle bindManaged(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction direction = PropertyBinder::OneWay, BindingOptions options = {})この QWidget ホストに管理された直接バインディングを設定します。
BindingHandle bindComputed(const char* targetProp, const QVector<BindingDependency>& dependencies, std::function<QVariant()> evaluate, BindingOptions options = {})この QWidget ホストに明示的依存関係を持つ C++ 式を設定します。
void addTransition(const StateTransition& transition)優先順位順に状態遷移を登録します。
void setBehavior(const char* propertyName, const PropertyAnimation& animation)writeProperty() またはバインディング経由で @p propertyName が書き込まれた際に使用されるデフォルトアニメーションを設定します。明示的な StateTransition ルールが優先され、C++ のセッターを直接呼び出した場合はアニメーションしません。
void clearBehavior(const char* propertyName)今後のマネージド書き込みに使用するデフォルトアニメーションを削除します。
bool writeProperty(const char* propertyName, const QVariant& value)バインディングを削除せずに Behavior 経由でホストプロパティに書き込みます。
Qt 基底クラスドキュメント:QListView