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 で行われる。デフォルトでは、Shape がitem と交差しているか、item の Shape の中に含まれているすべてのアイテムが返される。

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

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

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

order を用いてソートされたリストにおいて、mode に依存して、指定されたpath の内部またはそれと交差するすべての可視アイテムを返す。この場合、"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

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

order を用いてソートされたリストにおいて、mode に依存して、指定されたpolygon の内部またはそれと交差するすべての可視アイテムを返す。この場合、"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

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

order を用いてソートされたリストにおいて、mode に依存して、指定されたrect の内部またはそれと交差するすべての可視アイテムを返す。この場合、"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, , , で定義される矩形の内側にあるか、 あるいは矩形と交差しているすべての可視アイテムを、 を用いてソートしたリストで返します。この場合、"visible" は、isVisible() が を返し、effectiveOpacity() が 0.0 より大きい値（これは完全に透明である）を返し、親アイテムがそれをクリップしないアイテムを定義する。y w h order true

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

QRectF QGraphicsScene::itemsBoundingRect() const

シーン上のすべてのアイテムの外接矩形を計算して返す。この関数は、すべてのアイテムを繰り返し処理することによって動作し、このため、大きなシーンでは遅くなることがあります。

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 を使って、シーンからsource rect をtarget にレンダリングします。この関数は、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)

このシグナルは、シーン矩形が変更されるたびに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)

可能なイベントフィルターを通してアイテムitem にイベントevent を送る。

イベントは、アイテムが有効な場合にのみ送られる。

イベントがフィルタリングされた場合、またはアイテムが無効な場合は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()も参照 。