QGraphicsScene Class

メンバ関数ドキュメント

QGraphicsScene::QGraphicsScene(QObject *parent = nullptr)

QGraphicsScene オブジェクトを構築します。parent パラメータはQObject のコンストラクタに渡されます。

QGraphicsScene::QGraphicsScene(const QRectF &sceneRect, QObject *parent = nullptr)

シーン矩形にsceneRect を使用して、QGraphicsScene オブジェクトを構築します。parent パラメータはQObject のコンストラクタに渡されます。

sceneRectも参照してください 。

QGraphicsScene::QGraphicsScene(qreal x, qreal y, qreal width, qreal height, QObject *parent = nullptr)

(x,y) で指定された矩形と、指定されたwidth とheight をシーンの矩形に使用して、QGraphicsScene オブジェクトを構築します。parent パラメータはQObject のコンストラクタに渡されます。

sceneRectも参照してください 。

[virtual noexcept] QGraphicsScene::~QGraphicsScene()

シーンオブジェクトを破棄する前に、シーンオブジェクトからすべてのアイテムを削除します。シーンオブジェクトは、アプリケーションのグローバルシーンリストから削除され、関連するすべてのビューから削除されます。

QGraphicsItem *QGraphicsScene::activePanel() const

現在アクティブなパネル、または現在アクティブなパネルがない場合はnullptr を返す。

QGraphicsScene::setActivePanel()も参照してください 。

QGraphicsWidget *QGraphicsScene::activeWindow() const

現在アクティブなウィンドウ、または現在アクティブなウィンドウがない場合はnullptr を返します。

QGraphicsScene::setActiveWindow() も参照して ください。

QGraphicsEllipseItem *QGraphicsScene::addEllipse(const QRectF &rect, const QPen &pen = QPen(), const QBrush &brush = QBrush())

楕円アイテムを作成してシーンに追加し、アイテムのポインタを返します。楕円のジオメトリはrect で定義され、そのペンとブラシはpen とbrush で初期化されます。

アイテムのジオメトリはアイテム座標で提供され、その位置は (0, 0) に初期化されることに注意してください。

アイテムが表示されている場合（すなわち、QGraphicsItem::isVisible() がtrue を返す場合）、QGraphicsScene は、制御がイベントループに戻ると、changed() を発行します。

addLine()、addPath()、addPixmap()、addRect()、addText()、addItem()、addWidget()も参照のこと 。

QGraphicsEllipseItem *QGraphicsScene::addEllipse(qreal x, qreal y, qreal w, qreal h, const QPen &pen = QPen(), const QBrush &brush = QBrush())

この便利関数は、addEllipse(QRectF(x,y,w,h),pen,brush) を呼び出すのと同じです。

void QGraphicsScene::addItem(QGraphicsItem *item)

このシーンにitem とそのすべての子を追加または移動する。このシーンはitem の所有権を持つ。

アイテムが可視の場合（すなわち、QGraphicsItem::isVisible() が真を返す）、QGraphicsScene は、制御がイベントループに戻ると、changed() を発する。

アイテムがすでに別のシーンにある場合は、まずその古いシーンから削除され、それからトップレベルとしてこのシーンに追加される。

QGraphicsScene がシーンに追加されている間、 にItemSceneChange通知を送る。アイテムが現在シーンに属していない場合、1つの通知のみが送られる。アイテムが既にシーンに属している場合（つまり、このシーンに移動された場合）、 は、アイテムがその前のシーンから削除される間、追加通知を送る。item QGraphicsScene

アイテムがパネルで、シーンがアクティブで、シーンにアクティブパネルがない場合、アイテムはアクティブになる。

removeItem(),addEllipse(),addLine(),addPath(),addPixmap(),addRect(),addText(),addWidget(),Sortingも参照 。

QGraphicsLineItem *QGraphicsScene::addLine(const QLineF &line, const QPen &pen = QPen())

ライン アイテムを作成してシーンに追加し、アイテム ポインタを返します。線のジオメトリはline で定義され、そのペンはpen で初期化されます。

アイテムのジオメトリはアイテム座標で提供され、その位置は (0, 0) に初期化されることに注意してください。

アイテムが表示されている場合（すなわち、QGraphicsItem::isVisible() がtrue を返す場合）、QGraphicsScene は、制御がイベントループに戻ると、changed() を発行します。

addEllipse()、addPath()、addPixmap()、addRect()、addText()、addItem()、addWidget()も参照のこと 。

QGraphicsLineItem *QGraphicsScene::addLine(qreal x1, qreal y1, qreal x2, qreal y2, const QPen &pen = QPen())

この便利関数は、addLine(QLineF(x1,y1,x2,y2),pen) を呼び出すのと等価である。

QGraphicsPathItem *QGraphicsScene::addPath(const QPainterPath &path, const QPen &pen = QPen(), const QBrush &brush = QBrush())

パスアイテムを作成してシーンに追加し、アイテムポインタを返します。パスのジオメトリはpath で定義され、そのペンとブラシはpen とbrush で初期化されます。

アイテムのジオメトリはアイテム座標で提供され、その位置は (0, 0) に初期化されることに注意してください。

アイテムが表示されている場合（すなわち、QGraphicsItem::isVisible() がtrue を返す場合）、QGraphicsScene は、制御がイベントループに戻ると、changed() を発行します。

addEllipse(),addLine(),addPixmap(),addRect(),addText(),addItem(),addWidget()も参照 。

QGraphicsPixmapItem *QGraphicsScene::addPixmap(const QPixmap &pixmap)

pixmap アイテムを作成してシーンに追加し、アイテムのポインタを返す。pixmap はpixmap で定義される。

アイテムのジオメトリはアイテム座標で提供され、その位置は (0, 0) に初期化されることに注意してください。

アイテムが表示されている場合（すなわち、QGraphicsItem::isVisible() がtrue を返す場合）、QGraphicsScene は、制御がイベントループに戻ると、changed() を発行します。

addEllipse(),addLine(),addPath(),addRect(),addText(),addItem(),addWidget()も参照 。

QGraphicsPolygonItem *QGraphicsScene::addPolygon(const QPolygonF &polygon, const QPen &pen = QPen(), const QBrush &brush = QBrush())

ポリゴン アイテムを作成してシーンに追加し、アイテム ポインタを返します。ポリゴンはpolygon で定義され、ペンとブラシはpen とbrush で初期化されます。

アイテムのジオメトリはアイテム座標で提供され、その位置は (0, 0) に初期化されることに注意してください。

アイテムが表示されている場合（すなわち、QGraphicsItem::isVisible() がtrue を返す場合）、QGraphicsScene は、制御がイベントループに戻ると、changed() を発行します。

addEllipse(),addLine(),addPath(),addRect(),addText(),addItem(),addWidget()も参照 。

QGraphicsRectItem *QGraphicsScene::addRect(const QRectF &rect, const QPen &pen = QPen(), const QBrush &brush = QBrush())

矩形アイテムを作成してシーンに追加し、アイテムのポインタを返します。矩形のジオメトリはrect で定義され、そのペンとブラシはpen とbrush で初期化されます。

アイテムのジオメトリはアイテム座標で提供され、その位置は (0, 0) に初期化されることに注意してください。た と えば、QRect(50, 50, 100, 100) が追加 さ れた場合、 その左上隅は、 アイテムの座標系の原点に対 し て相対的に (50, 50) の位置にな り ます。

アイテムが表示されている場合（すなわち、QGraphicsItem::isVisible() がtrue を返す場合）、QGraphicsScene は、制御がイベントループに戻ると、changed() を発行します。

addEllipse()、addLine()、addPixmap()、addPixmap()、addText()、addItem()、addWidget()も参照 。

QGraphicsRectItem *QGraphicsScene::addRect(qreal x, qreal y, qreal w, qreal h, const QPen &pen = QPen(), const QBrush &brush = QBrush())

この便利関数は、addRect(QRectF(x,y,w,h),pen,brush) を呼び出すのと同じです。

QGraphicsSimpleTextItem *QGraphicsScene::addSimpleText(const QString &text, const QFont &font = QFont())

QGraphicsSimpleTextItem を作成してシーンに追加し、アイテム・ポインタを返します。テ キ ス ト 文字列はtext に初期化 さ れ、 その フ ォ ン ト はfont に初期化 さ れます。

アイテムの位置は (0, 0) に初期化される。

アイテムが表示されている場合（すなわち、QGraphicsItem::isVisible() がtrue を返す場合）、QGraphicsScene は、制御がイベントループに戻ると、changed() を発行します。

addEllipse()、addLine()、addPixmap()、addPixmap()、addRect()、addItem()、addWidget()も参照 。

QGraphicsTextItem *QGraphicsScene::addText(const QString &text, const QFont &font = QFont())

テキスト・アイテムを作成してシーンに追加し、アイテム・ポインタを返します。テキスト文字列はtext に初期化され、そのフォントはfont に初期化される。

アイテムの位置は (0, 0) に初期化される。

アイテムが表示されている場合（すなわち、QGraphicsItem::isVisible() がtrue を返す場合）、QGraphicsScene は、制御がイベントループに戻ると、changed() を発行します。

addEllipse()、addLine()、addPixmap()、addPixmap()、addRect()、addItem()、addWidget()も参照 。

QGraphicsProxyWidget *QGraphicsScene::addWidget(QWidget *widget, Qt::WindowFlags wFlags = Qt::WindowFlags())

widget の新しいQGraphicsProxyWidget を作成し、シーンに追加し、プロキシへのポインタを返します。wFlags は、埋め込みプロキシウィジェットのデフォルトウィンドウフラグを設定します。

アイテムの位置は (0, 0) に初期化されます。

アイテムが表示されている場合（すなわち、QGraphicsItem::isVisible() は、true を返す）、QGraphicsScene は、制御がイベントループに戻ると、changed() を発行します。

Qt::WA_PaintOnScreen ウィジェット属性が設定されたウィジェットや、外部アプリケーションやコントローラをラップするウィジェットはサポートされていないことに注意してください。例として、QOpenGLWidget と QAxWidget があります。

addEllipse(),addLine(),addPixmap(),addPixmap(),addRect(),addText(),addSimpleText(),addItem()も参照してください 。

[slot] void QGraphicsScene::advance()

このスロットは、シーン上のすべてのアイテムに対してQGraphicsItem::advance() を呼び出すことで、シーンを1ステップ進めます。これは2つのフェーズで行われます。最初のフェーズでは、すべてのアイテムにシーンが変化しようとしていることを通知し、2番目のフェーズでは、すべてのアイテムに移動できることを通知します。最初のフェーズでは、QGraphicsItem::advance() が引数として 0 を渡して呼び出され、2 番目のフェーズでは 1 が渡されます。

アニメーションのためにアニメーションフレームワークを使用することもできます。

QGraphicsItem::advance() およびQTimeLineも参照して ください。

[signal] void QGraphicsScene::changed(const QList<QRectF> &region)

このシグナルは、制御がイベントループに達したとき、シーンの内容が変化すると、QGraphicsScene 。region パラメータには、変更された領域を示すシーン矩形のリストが含まれます。

QGraphicsView::updateScene()も参照してください 。

[slot] void QGraphicsScene::clear()

シーンからすべてのアイテムを削除・消去するが、それ以外はシーンの状態を変更しない。

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

void QGraphicsScene::clearFocus()

シーンからフォーカスをクリアします。この関数が呼び出されたときに、フォーカスを持つアイテムがあった場合、そのアイテムはフォーカスを失い、シーンがフォーカスを取り戻すと、再びフォーカスを取り戻します。

フォーカスを持たないシーンは、キーイベントを無視します。

hasFocus （）、setFocus （）、setFocusItem （）も参照して ください。

[slot] void QGraphicsScene::clearSelection()

現在の選択範囲をクリアします。

setSelectionArea() およびselectedItems() も参照して ください。

QList<QGraphicsItem *> QGraphicsScene::collidingItems(const QGraphicsItem *item, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const

item と衝突するすべての項目のリストを返します。衝突の判定はQGraphicsItem::collidesWithItem() を呼び出すことで行われます。衝突の判定はmode で行われます。デフォルトでは、形状がitem と交差するか、item の形状の中に含まれるすべてのアイテムが返されます。

項目は、積み重ねの降順で返される（つまり、リストの最初の項目が上位の項目で、 最後の項目が下位の項目である）。

items()、itemAt()、QGraphicsItem::collidesWithItem()、Sortingも参照のこと 。

[virtual protected] void QGraphicsScene::contextMenuEvent(QGraphicsSceneContextMenuEvent *contextMenuEvent)

このイベント・ハンドラ（イベントcontextMenuEvent 用）は、コンテキスト・メニュー・イベントを受け取るためにサブクラスで再実装することができます。デフォルトの実装では、イベントの位置でコンテキスト・メニュー・イベントを受け付ける一番上の可視アイテムにイベントを転送します。この位置でコンテキストメニューイベントを受け付ける項目がない場合、イベントは無視されます。

注意: この関数でどの項目を可視項目とみなすかの定義についてはitems() を参照。

QGraphicsItem::contextMenuEvent()も参照 。

QGraphicsItemGroup *QGraphicsScene::createItemGroup(const QList<QGraphicsItem *> &items)

items 内のすべての項目を新しいQGraphicsItemGroup にグループ化し、そのグループへのポインタを返します。グループは、items の共通の祖先を親として、位置 (0, 0) で作成されます。アイテムはすべてグループに再ペアレントされ、その位置と変換はグループにマップされます。items が空の場合、この関数は空のトップレベルQGraphicsItemGroup を返します。

QGraphicsScene にはグループアイテムの所有権があるので、削除する必要はありません。グループを解除するには、 () を呼び出します。destroyItemGroup

destroyItemGroup() およびQGraphicsItemGroup::addToGroup()も参照して ください。

void QGraphicsScene::destroyItemGroup(QGraphicsItemGroup *group)

group の全アイテムをgroup の親アイテムにレペアし、group をシーンから削除し、最後に削除します。アイテムの位置と変形は、グループからグループの親にマップされます。

createItemGroup() およびQGraphicsItemGroup::removeFromGroup()も参照してください 。

[virtual protected] void QGraphicsScene::dragEnterEvent(QGraphicsSceneDragDropEvent *event)

このイベントハンドラは、イベントevent に対して、シーンのドラッグ入力イベントを受け取るために、サブクラスで再実装することができます。

デフォルトの実装では、イベントを受け取り、ドラッグ移動イベントを受け取るようにシーンを準備します。

QGraphicsItem::dragEnterEvent(),dragMoveEvent(),dragLeaveEvent(),dropEvent()も参照してください 。

[virtual protected] void QGraphicsScene::dragLeaveEvent(QGraphicsSceneDragDropEvent *event)

イベントevent に対するこのイベントハンドラは、シーンのドラッグ離脱イベントを受け取るために、サブクラスで再実装することができます。

QGraphicsItem::dragLeaveEvent()、dragEnterEvent()、dragMoveEvent()、dropEvent()も参照してください 。

[virtual protected] void QGraphicsScene::dragMoveEvent(QGraphicsSceneDragDropEvent *event)

イベントevent に対するこのイベントハンドラは、シーンのドラッグ移動イベントを受け取るために、サブクラスで再実装することができます。

注: この関数で可視とみなされるアイテムの定義については、items() を参照してください。

QGraphicsItem::dragMoveEvent()、dragEnterEvent()、dragLeaveEvent()、dropEvent()も参照して ください。

[virtual protected] void QGraphicsScene::drawBackground(QPainter *painter, const QRectF &rect)

アイテムや前景が描画される前に、painter を使用してシーンの背景を描画します。この関数を再実装して、シーンのカスタム背景を提供してください。

すべての描画はシーン座標で行われます。rect パラメータは、露出した矩形です。

背景の色、テクスチャ、またはグラデーションを定義したい場合は、代わりにsetBackgroundBrush() を呼び出すことができます。

drawForeground() およびdrawItems()も参照して ください。

[virtual protected] void QGraphicsScene::drawForeground(QPainter *painter, const QRectF &rect)

背景とすべてのアイテムが描画された後に、painter を使用してシーンの前景を描画します。シーンのカスタム前景を提供するために、この関数を再実装してください。

すべての描画はシーン座標で行われます。rect パラメータは、露出された矩形である。

前景の色、テクスチャ、またはグラデーションを定義したい場合は、代わりにsetForegroundBrush() を呼び出すことができます。

drawBackground() およびdrawItems()も 参照してください。

[virtual protected] void QGraphicsScene::dropEvent(QGraphicsSceneDragDropEvent *event)

このイベントハンドラは、イベントevent に対して、シーンのドロップイベントを受け取るために、サブクラスで再実装することができます。

QGraphicsItem::dropEvent()、dragEnterEvent()、dragMoveEvent()、dragLeaveEvent()も 参照してください。

[override virtual protected] bool QGraphicsScene::event(QEvent *event)

再実装：QObject::event(QEvent *e)。

イベントevent を処理し、それぞれのイベントハンドラにディスパッチします。

便利なイベントハンドラを呼び出すことに加えて、この関数は、マウスグラバーアイテムがない場合のために、マウス移動イベントをホバーイベントに変換する役割を果たします。ホバー・イベントはアイテムに直接配信され、そのための便利関数はありません。

QWidget とは異なり、QGraphicsScene には便利関数enterEvent() とleaveEvent() がありません。これらのイベントを取得するには、この関数を使用します。

event が認識され処理された場合はtrue を返し、そうでない場合はfalse を返す。

contextMenuEvent()、keyPressEvent()、keyReleaseEvent()、mousePressEvent()、mouseMoveEvent()、mouseReleaseEvent()、mouseDoubleClickEvent()、focusInEvent()、focusOutEvent()も参照のこと 。

[override virtual protected] bool QGraphicsScene::eventFilter(QObject *watched, QEvent *event)

再インプリメント：QObject::eventFilter(QObject *watched, QEvent *event)。

QGraphicsScene パレットとフォントの変更を検出するために、 のイベントにフィルタをかけます。QApplication

[virtual protected] void QGraphicsScene::focusInEvent(QFocusEvent *focusEvent)

このイベントハンドラは、イベントfocusEvent のために、イベントでフォーカスを受け取るためにサブクラスで再実装することができます。

デフォルトの実装では、シーンにフォーカスが設定され、最後にフォーカスされたアイテムにフォーカスが設定されます。

QGraphicsItem::focusOutEvent()も参照してください 。

QGraphicsItem *QGraphicsScene::focusItem() const

シーンがアクティブな場合、この関数はシーンの現在のフォーカスアイテムを返し、現在フォーカスを持つアイテムがない場合はnullptr を返す。シーンが非アクティブの時、この関数は、シーンがアクティブになった時に入力フォーカスを得るアイテムを返す。

シーンがキーイベントを受信すると、フォーカスアイテムはキーボード入力を受け取る。

setFocusItem()、QGraphicsItem::hasFocus()、isActive()も参照してください 。

[signal] void QGraphicsScene::focusItemChanged(QGraphicsItem *newFocusItem, QGraphicsItem *oldFocusItem, Qt::FocusReason reason)

このシグナルは、シーン内でフォーカスが変わるたびに（つまり、アイテムが入力フォーカスを得たり失ったり、あるアイテムから別のアイテムにフォーカスが移るたびに）、QGraphicsScene によって発行されます。他のアイテムがいつ入力フォーカスを得たかを追跡する必要がある場合は、このシグナルに接続することができます。特に、仮想キーボード、入力メソッド、カーソル・アイテムの実装に便利です。

oldFocusItem newFocusItem は、入力フォーカスを得たアイテムへのポインターで、フォーカスが失われた場合は になります。 は、フォーカスが変更された理由です（例えば、入力フィールドにフォーカスがある間にシーンが非アクティブになった場合、 は入力フィールドのアイテムを指し、 は になり、 は になります）。nullptr reason oldFocusItem newFocusItem nullptr reason Qt::ActiveWindowFocusReason

[virtual protected slot] bool QGraphicsScene::focusNextPrevChild(bool next)

TabとShift+Tabに適切なように、キーボード・フォーカスを与える新しいウィジェットを見つけ、新しいウィジェットが見つかればtrue 、見つからなければfalseを返す。next が真なら、この関数は前方を検索し、next が偽なら、後方を検索する。

この関数をQGraphicsScene のサブクラスで再実装することで、シーン内でタブのフォーカスがどのように渡されるかを細かく制御することができます。デフォルトの実装は、QGraphicsWidget::setTabOrder() で定義されたタブ フォーカス チェーンに基づいています。

[virtual protected] void QGraphicsScene::focusOutEvent(QFocusEvent *focusEvent)

このイベントハンドラ（イベントfocusEvent 用）は、サブクラスで再実装して、フォーカスアウトイベントを受け取ることができます。

デフォルトの実装は、任意のフォーカス項目からフォーカスを外し、シーンからフォーカスを外します。

QGraphicsItem::focusInEvent()も参照してください 。

bool QGraphicsScene::hasFocus() const

シーンにフォーカスがあればtrue を返し、なければfalse を返す。シーンにフォーカスがある場合、QKeyEvent からのキーイベントをフォーカスを持つアイテムに転送します。

setFocus() およびsetFocusItem()も参照して ください。

qreal QGraphicsScene::height() const

この便利関数は、sceneRect().height() を呼び出すのと同じです。

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

[virtual protected] void QGraphicsScene::helpEvent(QGraphicsSceneHelpEvent *helpEvent)

イベントhelpEvent に対するこのイベント・ハンドラは、ヘルプ・イベントを受け取るためにサブクラスで再実装することができます。イベントはQEvent::ToolTip 型で、ツールチップが要求されたときに生成されます。

デフォルトの実装では、マウスカーソルの位置で一番上に表示されるアイテム、すなわち、最も高いz値を持つアイテムのツールチップが表示されます。どの項目にもツールチップが設定されていない場合、この関数は何もしない。

注意: この関数で可視とみなされるアイテムの定義については、items() を参照のこと。

QGraphicsItem::toolTip() およびQGraphicsSceneHelpEventも参照のこと 。

[virtual protected] void QGraphicsScene::inputMethodEvent(QInputMethodEvent *event)

イベントevent に対するこのイベントハンドラは、シーンの入力メソッドイベントを受け取るために、サブクラスで再実装することができます。

デフォルトの実装では、イベントはfocusItem() に転送されます。現在フォーカスを持つアイテムがない場合、または現在のフォーカスアイテムが入力メソッドを受け付けない場合、この関数は何もしません。

QGraphicsItem::inputMethodEvent()も参照してください 。

[virtual] QVariant QGraphicsScene::inputMethodQuery(Qt::InputMethodQuery query) const

このメソッドは、入力メソッドがシーンのプロパティのセットを照会するために使用され、周囲のテキストや再変換のサポートとして複雑な入力メソッド操作をサポートできるようにします。

query パラメータは、クエリされるプロパティを指定する。

QWidget::inputMethodQuery()も参照 。

[slot] void QGraphicsScene::invalidate(const QRectF &rect = QRectF(), QGraphicsScene::SceneLayers layers = AllLayers)

シーン上のrect のlayers を無効にして、再描画をスケジュールする。layers にキャッシュされたコンテンツは、無条件に無効化され、再描画されます。

この関数のオーバーロードを使用して、シーンの背景または前景の変更をQGraphicsScene に通知することができます。この関数は、QGraphicsView がCacheBackground を有効にしたときに変更を通知するために、タイルベースの背景を持つシーンに一般的に使用されます。

例

QRectF TileScene::rectForTile(int x, int y) const
{
    // Return the rectangle for the tile at position (x, y).
    return QRectF(x * tileWidth, y * tileHeight, tileWidth, tileHeight);
}

void TileScene::setTile(int x, int y, const QPixmap &pixmap)
{
    // Sets or replaces the tile at position (x, y) with pixmap.
    if (x >= 0 && x < numTilesH && y >= 0 && y < numTilesV) {
        tiles[y][x] = pixmap;
        invalidate(rectForTile(x, y), BackgroundLayer);
    }
}

void TileScene::drawBackground(QPainter *painter, const QRectF &exposed)
{
    // Draws all tiles that intersect the exposed area.
    for (int y = 0; y < numTilesV; ++y) {
        for (int x = 0; x < numTilesH; ++x) {
            QRectF rect = rectForTile(x, y);
            if (exposed.intersects(rect))
                painter->drawPixmap(rect.topLeft(), tiles[y][x]);
        }
    }
}

現在、QGraphicsView は背景のキャッシュのみをサポートしていることに注意してください（QGraphicsView::CacheBackground を参照）。この関数は、BackgroundLayer 以外のレイヤーが渡された場合、update() を呼び出すのと同じです。

QGraphicsView::resetCachedContent()も参照 。

void QGraphicsScene::invalidate(qreal x, qreal y, qreal w, qreal h, QGraphicsScene::SceneLayers layers = AllLayers)

これはオーバーロードされた関数である。

この便利な関数は、invalidate(QRectF(x,y,w,h),layers) を呼び出すのと同じです；

bool QGraphicsScene::isActive() const

シーンがアクティブである場合（例えば、アクティブである少なくとも1つのQGraphicsView によって表示されている場合）、true を返します。そうでない場合は、false を返します。

QGraphicsItem::isActive() およびQWidget::isActiveWindow()も参照して ください。

QGraphicsItem *QGraphicsScene::itemAt(const QPointF &position, const QTransform &deviceTransform) const

指定されたposition 、またはこの位置にアイテムがない場合はnullptr 。

deviceTransform はビューに適用されるトランスフォームであり、シーンにトランスフォームを無視するアイテムが含まれている場合は提供する必要があります。

注: この関数でどのアイテムが可視とみなされるかの定義については、items() を参照してください。

items()、collidingItems()、Sortingも参照のこと 。

QGraphicsItem *QGraphicsScene::itemAt(qreal x, qreal y, const QTransform &deviceTransform) const

これはオーバーロードされた関数です。

(x,y) で指定された位置の一番上の可視アイテム、またはこの位置にアイテムがない場合はnullptr を返します。

deviceTransform はビューに適用されるトランスフォームで、シーンにトランスフォームを無視するアイテムが含まれている場合は提供する必要があります。

この便利な関数は、itemAt(QPointF(x, y), deviceTransform) を呼び出すのと同じです。

注：この関数でどのアイテムが可視とみなされるかの定義については、items() を参照してください。

QList<QGraphicsItem *> QGraphicsScene::items(Qt::SortOrder order = Qt::DescendingOrder) const

シーン上のすべてのアイテムの順序付きリストを返します。order は、スタック順序を決定します。

addItem()、removeItem()、Sortingも参照してください 。

QList<QGraphicsItem *> QGraphicsScene::items(const QPointF &pos, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape, Qt::SortOrder order = Qt::DescendingOrder, const QTransform &deviceTransform = QTransform()) const

order を使用してソートされたリストで、mode に応じて、指定されたpos にあるすべての可視アイテムを返します。この場合、"visible" は、isVisible() がtrue を返し、effectiveOpacity() が 0.0 より大きい値 (これは完全に透明です) を返し、親アイテムがそれをクリップしないアイテムを定義します。

mode のデフ ォ ル ト 値はQt::IntersectsItemShape です。pos と正確な形状が交差するすべてのアイテムが返されます。

deviceTransform はビューに適用されるトランスフォームで、シーンにトランスフォームを無視するアイテムが含まれている場合は提供する必要があります。

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

QList<QGraphicsItem *> QGraphicsScene::items(const QPainterPath &path, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape, Qt::SortOrder order = Qt::DescendingOrder, const QTransform &deviceTransform = QTransform()) const

これはオーバーロードされた関数です。

mode に応じて、指定されたpath の内側にあるか、またはそれと交差するすべての可視アイテムを、order を使用してソートされたリストで返します。こ の場合、 "visible" は、 isVisible() がtrue を返 し 、 effectiveOpacity() が 0.0 よ り 大 き い値 （完全透過） を返 し 、 親ア イ テ ムがそれを ク リ ッ プ し ないア イ テ ム を定義 し ます。

mode のデフ ォ ル ト 値はQt::IntersectsItemShape です。path と正確な形状が交差するか、 または に含まれるすべてのアイテムが返されます。

deviceTransform はビューに適用されるトランスフォームであり、シーンにトランスフォームを無視するアイテムが含まれている場合は提供する必要があります。

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

QList<QGraphicsItem *> QGraphicsScene::items(const QPolygonF &polygon, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape, Qt::SortOrder order = Qt::DescendingOrder, const QTransform &deviceTransform = QTransform()) const

これはオーバーロードされた関数です。

mode に応じて、指定されたpolygon の内側にあるか、またはそれと交差するすべての可視アイテムを、order を使用してソートされたリストで返します。こ の場合、 "visible" は、 isVisible() がtrue を返 し 、 effectiveOpacity() が 0.0 よ り 大 き い値 （完全透過） を返 し 、 親ア イ テ ムがそれを ク リ ッ プ し ないア イ テ ム を定義 し ます。

mode のデフ ォ ル ト 値はQt::IntersectsItemShape です。polygon と正確な形状が交差するか、 または に含まれるすべてのアイテムが返されます。

deviceTransform はビューに適用されるトランスフォームであり、シーンにトランスフォームを無視するアイテムが含まれている場合は提供する必要があります。

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

QList<QGraphicsItem *> QGraphicsScene::items(const QRectF &rect, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape, Qt::SortOrder order = Qt::DescendingOrder, const QTransform &deviceTransform = QTransform()) const

これはオーバーロードされた関数です。

mode に応じて、指定されたrect の内側にあるか、またはそれと交差するすべての可視アイテムを、order を使用してソートされたリストで返します。こ の場合、 "visible" は、 isVisible() がtrue を返 し 、 effectiveOpacity() が 0.0 よ り 大 き い値 （完全透過） を返 し 、 親ア イ テ ムがそれを ク リ ッ プ し ないア イ テ ム を定義 し ます。

mode のデフ ォ ル ト 値はQt::IntersectsItemShape です。rect と正確な形状が交差するか、 または に含まれるすべてのアイテムが返されます。

deviceTransform はビューに適用されるトランスフォームであり、シーンにトランスフォームを無視するアイテムが含まれている場合は提供する必要があります。

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

QList<QGraphicsItem *> QGraphicsScene::items(qreal x, qreal y, qreal w, qreal h, Qt::ItemSelectionMode mode, Qt::SortOrder order, const QTransform &deviceTransform = QTransform()) const

これはオーバーロードされた関数です。

mode に応じて、x 、y 、w 、h で定義された矩形の内側にあるか、または矩形と交差しているすべての可視アイテムを、order を使用してソートされたリストで返します。この場合、"visible" は、isVisible() がtrue を返し、effectiveOpacity() が 0.0 より大きい値（これは完全に透明である）を返し、親アイテムがそれをクリップしないアイテムを定義する。

deviceTransform は、ビューに適用されるトランスフォームで、シーンにトランスフォームを無視するアイテムが含まれている場合は、提供する必要があります。

QRectF QGraphicsScene::itemsBoundingRect() const

シーン上のすべてのアイテムのバウンディング rect を計算して返します。この関数は、すべてのアイテムを繰り返し処理することによって動作し、このため、大きなシーンでは時間がかかることがあります。

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

[virtual protected] void QGraphicsScene::keyPressEvent(QKeyEvent *keyEvent)

このイベントハンドラは、イベントkeyEvent 、キープレスのイベントを受け取るためにサブクラスで再実装することができます。デフォルトの実装では、イベントは現在のフォーカスアイテムに転送されます。

QGraphicsItem::keyPressEvent() およびfocusItem()も参照してください 。

[virtual protected] void QGraphicsScene::keyReleaseEvent(QKeyEvent *keyEvent)

イベントkeyEvent に対するこのイベント・ハンドラは、キー・リリース・イベントを受け取るためにサブクラスで再実装することができます。デフォルトの実装では、イベントは現在のフォーカス項目に転送されます。

QGraphicsItem::keyReleaseEvent() およびfocusItem()も参照してください 。

[virtual protected] void QGraphicsScene::mouseDoubleClickEvent(QGraphicsSceneMouseEvent *mouseEvent)

このイベントハンドラは、イベントmouseEvent 、シーンのマウスダブルクリックイベントを受け取るために、サブクラスで再実装することができます。

誰かがシーンをダブルクリックすると、シーンは最初にマウスを押すイベントを受信し、次にリリースイベント（つまりクリック）を受信し、次にダブルクリックイベントを受信し、最後にリリースイベントを受信します。ダブルクリックイベントが、最初のプレスとリリースを受け取ったアイテムとは異なるアイテムに配信される場合は、プレスイベントとして配信されます。ただし、この場合、トリプルクリック・イベントはダブルクリック・イベントとして配信されません。

デフォルトの実装はmousePressEvent() と同様です。

注意: この関数で可視とみなされるアイテムの定義についてはitems() を参照してください。

QGraphicsItem::mousePressEvent()、QGraphicsItem::mouseMoveEvent()、QGraphicsItem::mouseReleaseEvent()、QGraphicsItem::setAcceptedMouseButtons()も参照 。

QGraphicsItem *QGraphicsScene::mouseGrabberItem() const

現在のマウス・グラブ・アイテム、または現在マウス・グラブ・アイテムがない場合はnullptr を返す。マウスグラバーアイテムは、シーンに送られるすべてのマウスイベントを受け取るアイテムです。

アイテムは、マウスを押すイベントを受信するとマウスグラバーになり、次のいずれかのイベントが発生するまでマウスグラバーであり続けます：

• 他のボタンが押されていない時に、アイテムがマウスリリースイベントを受信すると、マウスグラブを失います。
• アイテムが不可視になった場合（例：誰かがitem->setVisible(false) を呼び出す）、または無効になった場合（例：誰かがitem->setEnabled(false) を呼び出す）、マウスグラブを失う。
• アイテムがシーンから削除されると、マウスグラブを失います。

アイテムがマウスグラブを失うと、シーンは、新しいアイテムがマウスをつかむまで（つまり、新しいアイテムがマウスプレスイベントを受け取るまで）、すべてのマウスイベントを無視します。

[virtual protected] void QGraphicsScene::mouseMoveEvent(QGraphicsSceneMouseEvent *mouseEvent)

このイベントハンドラは、イベントmouseEvent 、シーンのマウス移動イベントを受け取るために、サブクラスで再実装することができます。

デフォルトの実装は、マウスグラバーの状態に依存します。マウスグラバーアイテムがある場合、イベントはマウスグラバーに送られます。現在の位置にホバーイベントを受け付けるアイテムがあれば、イベントはホバーイベントに変換されて受け付けられ、そうでなければ無視されます。

QGraphicsItem::mousePressEvent(),QGraphicsItem::mouseReleaseEvent(),QGraphicsItem::mouseDoubleClickEvent(),QGraphicsItem::setAcceptedMouseButtons()も参照 。

[virtual protected] void QGraphicsScene::mousePressEvent(QGraphicsSceneMouseEvent *mouseEvent)

このイベントハンドラは、イベントmouseEvent に対して、シーンのマウス押下イベントを受け取るために、サブクラスで再実装することができます。

デフォルトの実装は、シーンの状態に依存します。マウスグラバーアイテムがある場合、イベントはマウスグラバーに送られます。そうでない場合は、そのイベントからシーン位置でマウスイベントを受け付ける一番上の可視アイテムに転送され、そのアイテムが即座にマウスグラバーアイテムになる。

シーン上の指定された位置にアイテムがない場合、選択領域はリセットされ、フォーカスされたアイテムは入力フォーカスを失い、イベントは無視される。

注: この関数で可視とみなされるアイテムの定義については、items() を参照してください。

QGraphicsItem::mousePressEvent() およびQGraphicsItem::setAcceptedMouseButtons()も参照 。

[virtual protected] void QGraphicsScene::mouseReleaseEvent(QGraphicsSceneMouseEvent *mouseEvent)

このイベント・ハンドラは、イベントmouseEvent に対して、シーンのマウス・リリース・イベントを受け取るために、サブクラスで再実装することができます。

デフォルトの実装は、マウスグラバーの状態に依存します。マウスグラバーがない場合、イベントは無視されます。そうでない場合、マウスグラバーアイテムがあれば、イベントはマウスグラバーに送られます。このマウスリリースがマウスの最後に押されたボタンを表す場合、マウスグラバーアイテムはマウスグラブを失います。

QGraphicsItem::mousePressEvent(),QGraphicsItem::mouseMoveEvent(),QGraphicsItem::mouseDoubleClickEvent(),QGraphicsItem::setAcceptedMouseButtons()も参照 。

void QGraphicsScene::removeItem(QGraphicsItem *item)

アイテムitem とそのすべての子をシーンから削除する。item の所有権は呼び出し元に渡されます（つまり、QGraphicsScene が破棄されてもitem は削除されません）。

addItem()も参照 。

void QGraphicsScene::render(QPainter *painter, const QRectF &target = QRectF(), const QRectF &source = QRectF(), Qt::AspectRatioMode aspectRatioMode = Qt::KeepAspectRatio)

painter を使用して、シーンからtarget へsource rect をレンダリングします。この関数は、QImage のようなペイントデバイスにシーンの内容をキャプチャしたり（例えば、スクリーンショットを撮る）、QPrinter で印刷したりするのに便利です。例えば

QGraphicsScene scene;
scene.addItem(...
...
QPrinter printer(QPrinter::HighResolution);
printer.setPaperSize(QPrinter::A4);

QPainter painter(&printer);
scene.render(&painter);

source が null rect の場合、この関数はsceneRect() を使用してレンダリングを決定します。target が null rect の場合、painter のペイントデバイスの寸法が使用されます。

ソース rect の内容は，aspectRatioMode に従って変換され，ターゲット rect に収まるようになります。デフォルトでは、縦横比は維持され、source はtarget に収まるように拡大縮小されます。

QGraphicsView::render()も参照してください 。

[signal] void QGraphicsScene::sceneRectChanged(const QRectF &rect)

このシグナルは、シーンrectが変更されるたびにQGraphicsScene によって発せられます。rect パラメータは新しいシーン矩形である。

QGraphicsView::updateSceneRect()も参照して ください。

QList<QGraphicsItem *> QGraphicsScene::selectedItems() const

現在選択されているすべてのアイテムのリストを返します。項目は順不同で返されます。

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

QPainterPath QGraphicsScene::selectionArea() const

setSelectionArea() で以前に設定された選択領域、または選択領域が設定されていない場合は空のQPainterPath を返します。

setSelectionArea()も参照 。

[signal] void QGraphicsScene::selectionChanged()

このシグナルは、選択範囲が変更されるたびにQGraphicsScene から発行されます。selectedItems() を呼び出すと、新しい選択項目のリストを取得できます。

アイテムが選択されたり非選択になったり、選択領域が設定されたりクリアされたり、その他の方法で変更されたり、事前に選択されたアイテムがシーンに追加されたり、選択されたアイテムがシーンから削除されたりするたびに、セレクションが変更されます。

QGraphicsScene は、グループ選択操作に対して1度だけこのシグナルを発する。例えば、選択領域を設定したり、 を選択または選択解除したり、選択された複数のアイテムを含む親アイテムをシーンに追加またはシーンから削除した場合、selectionChanged() は、操作が完了した後に（各アイテムに対して1回ではなく）1回だけ発せられます。QGraphicsItemGroup

setSelectionArea(),selectedItems(),QGraphicsItem::setSelected()も参照してください 。

bool QGraphicsScene::sendEvent(QGraphicsItem *item, QEvent *event)

可能なイベント・フィルタを通して、イベントevent をアイテムitem に送ります。

イベントは、アイテムが有効になっている場合にのみ送信されます。

イベントがフィルタリングされた場合、またはアイテムが無効な場合はfalse を返します。そうでない場合は、イベント・ハンドラから返された値を返します。

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

void QGraphicsScene::setActivePanel(QGraphicsItem *item)

このシーンのアイテムでなければならないitem をアクティブにする。itemこの場合、QGraphicsScene は、現在アクティブなパネルを非アクティブにします。

シーンが現在非アクティブの場合、item は、シーンがアクティブになるまで非アクティブのままです（または、item がnullptr の場合、アイテムはアクティブになりません）。

activePanel （）、isActive （）、QGraphicsItem::isActive （）も参照 。

void QGraphicsScene::setActiveWindow(QGraphicsWidget *widget)

このシーンのウィジェットでなければならないwidget をアクティブにする。widgetこの場合、QGraphicsScene は、現在アクティブなウィンドウを非アクティブにします。

activeWindow() およびQGraphicsWidget::isActiveWindow()も参照してください 。

void QGraphicsScene::setFocus(Qt::FocusReason focusReason = Qt::OtherFocusReason)

シーンにQFocusEvent を送り、理由としてfocusReason を渡すことで、シーンにフォーカスを設定します。あるアイテムがフォーカスを持つ間にシーンがフォーカスを失った後、再びフォーカスを得た場合、最後にフォーカスを得たアイテムがfocusReason を理由としてフォーカスを受け取ります。

シーンにすでにフォーカスがある場合、この関数は何もしない。

hasFocus （）、clearFocus （）、setFocusItem （）も参照 。

void QGraphicsScene::setFocusItem(QGraphicsItem *item, Qt::FocusReason focusReason = Qt::OtherFocusReason)

focusReasonフォーカスを持つ可能性のある以前のアイテムからフォーカスを取り除いた後、シーンのフォーカスアイテムをitem に設定する。

item がnullptr である場合、またはフォーカスを受け入れない（すなわち、QGraphicsItem::ItemIsFocusable フラグが有効になっていない）か、表示されていないか、有効になっていない場合、この関数は前のフォーカス項目からフォーカスを取り除くだけである。

item がnullptr でなく、シーンが現在フォーカスを持っていない場合（すなわち、hasFocus() がfalse を返す場合）、この関数は自動的にsetFocus() を呼び出します。

focusItem()、hasFocus()、setFocus()も参照して ください。

void QGraphicsScene::setSelectionArea(const QPainterPath &path, const QTransform &deviceTransform)

選択領域をpath に設定します。この領域内の項目はすべて即座に選択され、領域外の項目はすべて非選択になります。すべての選択項目のリストは、selectedItems() をコールすることで取得できます。

deviceTransform は、ビューに適用されるトランスフォームで、シーンにトランスフォームを無視するアイテムが含まれている場合に指定する必要があります。

アイテムを選択するには、選択可能(QGraphicsItem::ItemIsSelectable) としてマークする必要があります。

clearSelection() およびselectionArea()も参照してください 。

void QGraphicsScene::setSelectionArea(const QPainterPath &path, Qt::ItemSelectionOperation selectionOperation = Qt::ReplaceSelection, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape, const QTransform &deviceTransform = QTransform())

これはオーバーロードされた関数です。

アイテムが選択範囲に含まれるかどうかを判定するためにmode を使用して、選択範囲をpath に設定します。

deviceTransform はビューに適用されるトランスフォームで、シーンにトランスフォームを無視するアイテムが含まれている場合は提供する必要があります。

selectionOperation は、現在選択されているアイテムをどうするかを決定します。

clearSelection() およびselectionArea()も参照してください 。

void QGraphicsScene::setStyle(QStyle *style)

シーンのスタイルをstyle に設定または置換し、このシーンにスタイルを再保存します。以前に割り当てられていたスタイルは削除されます。シーンのスタイルのデフォルトはQApplication::style() で、シーン内のすべてのQGraphicsWidget アイテムのデフォルトとして機能します。

この関数を直接呼び出すか、QApplication::setStyle() を間接的に呼び出すことによってスタイルを変更すると、スタイルが明示的に割り当てられていないシーン内のすべてのウィジェットのスタイルが自動的に更新されます。

style がnullptr の場合、QGraphicsScene はQApplication::style() に戻ります。

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

QStyle *QGraphicsScene::style() const

シーンのスタイル、またはシーンにスタイルが明示的に割り当てられていない場合はQApplication::style() と同じものを返します。

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

[slot] void QGraphicsScene::update(const QRectF &rect = QRectF())

シーン上の領域rect の再描画をスケジュールします。

sceneRect() およびchanged() も参照して ください。

void QGraphicsScene::update(qreal x, qreal y, qreal w, qreal h)

これはオーバーロードされた関数です。

この関数は、 update(QRectF(x,y,w,h)) を呼び出すのと同じです；

QList<QGraphicsView *> QGraphicsScene::views() const

このシーンを表示するすべてのビューのリストを返します。

QGraphicsView::scene()も参照してください 。

[virtual protected] void QGraphicsScene::wheelEvent(QGraphicsSceneWheelEvent *wheelEvent)

イベントwheelEvent に対するこのイベントハンドラは、シーンのマウスホイールイベントを受け取るために、サブクラスで再実装することができます。

デフォルトでは、イベントはカーソルの下にある一番上の可視アイテムに配信されます。無視された場合、イベントはその下のアイテムに伝搬し、イベントが受け入れられるか、シーンに到達するまで繰り返される。イベントを受け入れるアイテムがない場合、イベントは無視されます。

注: この関数で可視とみなされるアイテムの定義については、items() を参照してください。

QGraphicsItem::wheelEvent()も参照 。

qreal QGraphicsScene::width() const

この便利な関数は、sceneRect().width()を呼び出すのと同じです。

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