Obsolete Members for QGraphicsScene

以下成员源于类 QGraphicsScene 已过时。 提供它们是为使旧源代码能继续工作。强烈建议不要在新代码中使用它们。

特性

• (obsolete) sortCacheEnabled : bool

公共函数

(obsolete) QGraphicsItem *	itemAt (const QPointF & position ) const
(obsolete) QGraphicsItem *	itemAt (qreal x , qreal y ) const
(obsolete) QList<QGraphicsItem *>	项 (const QPointF & pos ) const
(obsolete) QList<QGraphicsItem *>	项 (qreal x , qreal y , qreal w , qreal h , Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const
(obsolete) QList<QGraphicsItem *>	项 (const QRectF & rectangle , Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const
(obsolete) QList<QGraphicsItem *>	项 (const QPolygonF & polygon , Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const
(obsolete) QList<QGraphicsItem *>	项 (const QPainterPath & path , Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const
(obsolete) void	setSelectionArea (const QPainterPath & path )
(obsolete) void	setSelectionArea (const QPainterPath & path , Qt::ItemSelectionMode mode )

保护函数

(obsolete) virtual void

drawItems (QPainter * painter , int numItems , QGraphicsItem *[] 项 , const QStyleOptionGraphicsItem[] options , QWidget * widget = 0)

特性文档编制

sortCacheEnabled : bool

This property holds whether sort caching is enabled.

Since Qt 4.6, this property has no effect.

该特性在 Qt 4.5 引入。

访问函数：

bool	isSortCacheEnabled () const
void	setSortCacheEnabled (bool enabled )

成员函数文档编制

[virtual protected] void QGraphicsScene:: drawItems ( QPainter * painter , int numItems , QGraphicsItem *[] 项 , const QStyleOptionGraphicsItem [] options , QWidget * widget = 0)

Paints the given 项 使用提供 painter , after the background has been drawn, and before the foreground has been drawn. All painting is done in scene coordinates. Before drawing each item, the painter must be transformed using QGraphicsItem::sceneTransform ().

The options parameter is the list of style option objects for each item in 项 。 numItems parameter is the number of items in 项 and options in options 。 widget parameter is optional; if specified, it should point to the widget that is being painted on.

The default implementation prepares the painter matrix, and calls QGraphicsItem::paint () on all items. Reimplement this function to provide custom painting of all items for the scene; gaining complete control over how each item is drawn. In some cases this can increase drawing performance significantly.

范例：

void CustomScene::drawItems(QPainter *painter, int numItems,
                            QGraphicsItem *items[],
                            const QStyleOptionGraphicsItem options[],
                            QWidget *widget)
{
    for (int i = 0; i < numItems; ++i) {
         // Draw the item
         painter->save();
         painter->setMatrix(items[i]->sceneMatrix(), true);
         items[i]->paint(painter, &options[i], widget);
         painter->restore();
     }
}
					

Since Qt 4.6, this function is not called anymore unless the QGraphicsView::IndirectPainting flag is given as an Optimization flag.

另请参阅 drawBackground () 和 drawForeground ().

QGraphicsItem * QGraphicsScene:: itemAt (const QPointF & position ) const

这是重载函数。

返回最顶可见项在指定 position , or 0 if there are no items at this position.

This function is deprecated and returns incorrect results if the scene contains items that ignore transformations. Use the overload that takes a QTransform 代替。

另请参阅 项 (), collidingItems ()，和 排序 .

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

这是重载函数。

Returns the topmost item at the position specified by ( x , y ), or 0 if there are no items at this position.

此方便函数相当于调用 itemAt(QPointF(x, y)) .

This function is deprecated and returns incorrect results if the scene contains items that ignore transformations. Use the overload that takes a QTransform 代替。

QList < QGraphicsItem *> QGraphicsScene:: 项 (const QPointF & pos ) const

Returns all visible items at position pos in the scene. The items are listed in descending stacking order (i.e., the first item in the list is the top-most item, and the last item is the bottom-most item).

This function is deprecated and returns incorrect results if the scene contains items that ignore transformations. Use the overload that takes a QTransform 代替。

另请参阅 itemAt () 和 排序 .

QList < QGraphicsItem *> QGraphicsScene:: 项 ( qreal x , qreal y , qreal w , qreal h , Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const

This convenience function is equivalent to calling items( QRectF ( x , y , w , h ), mode ).

This function is deprecated and returns incorrect results if the scene contains items that ignore transformations. Use the overload that takes a QTransform 代替。

该函数在 Qt 4.3 引入。

QList < QGraphicsItem *> QGraphicsScene:: 项 (const QRectF & rectangle , Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const

这是重载函数。

返回的所有可见项，从属 mode ，在内部或相交与指定 rectangle .

默认值对于 mode is Qt::IntersectsItemShape ; all items whose exact shape intersects with or is contained by rectangle 被返回。

This function is deprecated and returns incorrect results if the scene contains items that ignore transformations. Use the overload that takes a QTransform 代替。

另请参阅 itemAt () 和 排序 .

QList < QGraphicsItem *> QGraphicsScene:: 项 (const QPolygonF & polygon , Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const

这是重载函数。

返回的所有可见项，从属 mode , are either inside or intersect with the polygon polygon .

默认值对于 mode is Qt::IntersectsItemShape ; all items whose exact shape intersects with or is contained by polygon 被返回。

This function is deprecated and returns incorrect results if the scene contains items that ignore transformations. Use the overload that takes a QTransform 代替。

另请参阅 itemAt () 和 排序 .

QList < QGraphicsItem *> QGraphicsScene:: 项 (const QPainterPath & path , Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const

这是重载函数。

返回的所有可见项，从属 path , are either inside or intersect with the path path .

默认值对于 mode is Qt::IntersectsItemShape ; all items whose exact shape intersects with or is contained by path 被返回。

This function is deprecated and returns incorrect results if the scene contains items that ignore transformations. Use the overload that takes a QTransform 代替。

另请参阅 itemAt () 和 排序 .

void QGraphicsScene:: setSelectionArea (const QPainterPath & path )

这是重载函数。

将选定区域设为 path .

This function is deprecated and leads to incorrect results if the scene contains items that ignore transformations. Use the overload that takes a QTransform 代替。

void QGraphicsScene:: setSelectionArea (const QPainterPath & path , Qt::ItemSelectionMode mode )

这是重载函数。

将选定区域设为 path 使用 mode 以确定项是否包括在选定区域中。

该函数在 Qt 4.3 引入。

另请参阅 clearSelection () 和 selectionArea ().