QGraphicsLayout Class

メンバ関数のドキュメント

QGraphicsLayout::QGraphicsLayout(QGraphicsLayoutItem *parent = nullptr)

QGraphicsLayout オブジェクトを生成します。

parent QGraphicsLayoutItem のコンストラクタに渡され、 のisLayoutQGraphicsLayoutItem引数がtrueに設定されます。

parent がQGraphicsWidget の場合、レイアウトはそのウィジェットにインストールされます。（レイアウトをインストールすると、以前にインストールされていたレイアウトは削除されることに注意してください。）

[virtual noexcept] QGraphicsLayout::~QGraphicsLayout()

QGraphicsLayout オブジェクトを破棄します。

void QGraphicsLayout::activate()

レイアウトをアクティブにし、レイアウト内のすべてのアイテムを直ちに再配置します。この関数は、count() およびitemAt() を呼び出した後、すべてのアイテムに対して順次setGeometry() を呼び出す仕組みに基づいています。アクティブ化されると、レイアウトはそのジオメトリを親のcontentsRect() に合わせるように調整します。その後、親は自身のレイアウトをすべて無効化します。

例えば、配置された項目のいずれかがサイズ変更に応答して、この関数を連続的または再帰的に呼び出した場合、この関数は何も実行しません。

なお、レイアウトは、このプロセスを最適化するためにジオメトリのキャッシュを使用しても構いません。そのようなキャッシュを強制的に無効化するには、activate()を呼び出す前にinvalidate()を呼び出すことができます。

invalidate()も参照してください 。

[protected] void QGraphicsLayout::addChildLayoutItem(QGraphicsLayoutItem *layoutItem)

この関数は、カスタムレイアウト向けに提供されている便利な関数であり、レイアウト内のすべての項目を順に処理し、それらのグラフィック項目を、レイアウトの最も近いQGraphicsWidget の親要素に再配置します。

layoutItem がすでに別のレイアウトに含まれている場合、そのレイアウトから削除されます。

カスタムレイアウトで特別な動作が必要な場合は、この関数の使用を無視して、独自の動作を実装することができます。

graphicsItem()も参照してください 。

[pure virtual] int QGraphicsLayout::count() const

この純粋仮想関数は、レイアウト内のアイテム数を返すために、QGraphicsLayout のサブクラスで再実装する必要があります。

アイテムの保存方法については、サブクラスが自由に決定できます。

itemAt() およびremoveAt()も参照してください 。

[override virtual] void QGraphicsLayout::getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const

QGraphicsLayoutItem::getContentsMargins （qreal *left, qreal *top, qreal *right, qreal *bottom）const を再実装します。

[virtual] void QGraphicsLayout::invalidate()

レイアウト内のキャッシュされたジオメトリおよびサイズヒント情報をすべてクリアし、マネージド親QGraphicsLayoutItem に対してLayoutRequest イベントを送信します。

activate() およびsetGeometry()も参照してください 。

bool QGraphicsLayout::isActivated() const

レイアウトが現在アクティブ化されている場合は `true ` を返し、そうでない場合は `false` を返します。レイアウトがアクティブ化されている場合、それは現在、そのアイテムの再配置が行われている最中であることを意味します（つまり、activate() 関数が呼び出されており、まだ戻り値が返されていない状態です）。

activate() およびinvalidate()も参照してください 。

[pure virtual] QGraphicsLayoutItem *QGraphicsLayout::itemAt(int i) const

この純粋仮想関数は、QGraphicsLayout のサブクラスにおいて、インデックスi にあるアイテムへのポインタを返すように再実装されなければなりません。再実装では、i が有効である（すなわち、count()の値を尊重している）と仮定してもかまいません。count()と併せて、レイアウト内のすべてのアイテムを反復処理するための手段として提供されています。

サブクラスは項目の保存方法を自由に決定でき、視覚的な配置をこの関数を通じて反映させる必要はありません。

count() およびremoveAt()も参照してください 。

[pure virtual] void QGraphicsLayout::removeAt(int index)

この純粋仮想関数は、`QGraphicsLayout ` のサブクラスにおいて、`index` にあるアイテムを削除するために再実装する必要があります。再実装では、`index ` が有効である（すなわち、`count()` の値を尊重している）と仮定してもかまいません。

そのアイテムはレイアウト階層から削除されたものとみなされるため、実装では、削除されたアイテムの `parentLayoutItem()` がこのレイアウトを指さないようにする必要があります。

レイアウトをアプリケーション間で再利用する場合は、レイアウトがアイテムを削除することを推奨しますが、グラフィックスビューフレームワークはこれに依存しません。

サブクラスは、アイテムの保存方法を自由に決定できます。

itemAt() およびcount()も参照してください 。

void QGraphicsLayout::setContentsMargins(qreal left, qreal top, qreal right, qreal bottom)

コンテンツの余白を、left 、top 、right 、bottom に設定します。最上位レイアウトのデフォルトのコンテンツ余白は、スタイルによって異なります（pixelMetric に対して、QStyle::PM_LayoutLeftMargin 、QStyle::PM_LayoutTopMargin 、QStyle::PM_LayoutRightMargin 、QStyle::PM_LayoutBottomMargin を問い合わせることで確認できます）。

サブレイアウトの場合、デフォルトのマージンは 0 です。

コンテンツのマージンを変更すると、レイアウトは自動的に無効になります。

invalidate()も参照してください 。

[override virtual] void QGraphicsLayout::updateGeometry()

QGraphicsLayoutItem::updateGeometry() を再実装します。

[virtual] void QGraphicsLayout::widgetEvent(QEvent *e)

この仮想イベントハンドラは、管理対象のウィジェットに関するすべてのイベントを受け取ります。QGraphicsLayout は、このイベントハンドラを使用して、ジオメトリの変更、レイアウトの変更、レイアウト方向の変更など、レイアウトに関連するイベントを監視します。

e はイベントへのポインタです。

このイベントハンドラを再実装して、独自のカスタムレイアウトの同様のイベントを追跡することができます。

QGraphicsWidget::event() およびQGraphicsItem::sceneEvent()も参照してください 。