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