QGraphicsLayout Class

メンバ関数ドキュメント

QGraphicsLayout::QGraphicsLayout(QGraphicsLayoutItem *parent = nullptr)

QGraphicsLayout オブジェクトを構築します。

parent は のコンストラクタに渡され、 の isLayout 引数はQGraphicsLayoutItem QGraphicsLayoutItemtrue に設定されます。

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()

レイアウト内のキャッシュされたジオメトリとサイズヒント情報をすべてクリアし、LayoutRequest イベントを管理される親QGraphicsLayoutItem にポストします。

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

bool QGraphicsLayout::isActivated() const

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

activate() およびinvalidate()も参照 。

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

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

アイテムをどのように格納するかはサブクラスが自由に決めることができ、視覚的な配置をこの関数に反映させる必要はありません。

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

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

この純粋仮想関数は、index の項目を削除するために、QGraphicsLayout のサブクラスで再実装されなければならない。再実装は、index が有効である（すなわち、count （）の値を尊重する）と仮定することができる。

アイテムはレイアウト階層から削除されたとみなされるため、実装は、削除されたアイテムのparentLayoutItem （）がこのレイアウトを指していないことを保証しなければなりません。

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

アイテムをどのように保存するかは、サブクラスが自由に決めることができます。

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

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

コンテンツマージンをleft,top,right,bottom に設定します。トップレベルレイアウトのデフォルトのコンテンツマージンはスタイルに依存します（QStyle::PM_LayoutLeftMargin 、QStyle::PM_LayoutTopMargin 、QStyle::PM_LayoutRightMargin 、QStyle::PM_LayoutBottomMargin のpixelMetricをクエリする）。

サブレイアウトのデフォルトの余白は0です。

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

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

[override virtual] void QGraphicsLayout::updateGeometry()

再インプリメント：QGraphicsLayoutItem::updateGeometry().

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

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

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

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

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