На этом шаге мы рассмотрим методы, используемые для поиска объектов.
Для поиска графических объектов, находящихся на сцене, предназначены следующие методы класса QGraphicsScene:
- itemAt() - возвращает ссылку на верхний видимый объект, который расположен по указанным координатам, или значение None, если никакого объекта там нет. Форматы метода:
itemAt(<X>, <Y>, <QTransform>) itemAt(<QPointF>, <QTransform>)
Третий параметр задает примененные к сцене преобразования системы координат (см. 191 шаг). Его необходимо указывать, если на сцене присутствуют объекты, игнорирующие преобразования, - в противном случае следует указать пустой экземпляр класса QTransform;
- соllidingItems (<QGraphicsItem>[, mode=IntersectsItemShape]) - возвращает список со ссылками на объекты, которые находятся в указанном в первом параметре объекте или
пересекаются с ним. Если таких объектов нет, метод возвращает пустой список. Необязательный параметр mode указывает режим поиска графических объектов и должен задаваться
следующими атрибутами класса QtCore.Qt:
- ContainsItemShape (или 0) - ищутся объекты, чьи границы полностью находятся внутри заданного объекта;
- IntersectsItemShape (или 1) - ищутся объекты, чьи границы полностью находятся внутри заданного объекта или пересекаются с его границей;
- ContainsItemBoundingRect (или 2) - ищутся объекты, охватывающие прямоугольники (то есть прямоугольники минимальных размеров, в которые эти объекты помещаются полностью), которые полностью находятся внутри охватывающего прямоугольника заданного объекта;
- IntersectsItemBoundingRect(или 3) - ищутся объекты, охватывающие прямоугольники (то есть прямоугольники минимальных размеров, в которые эти объекты помещаются полностью), которые полностью находятся внутри охватывающего прямоугольника заданного объекта или пересекаются с его границами;
- items () - возвращает список со ссылками на все объекты или на объекты, расположенные по указанным координатам, или на объекты, попадающие в указанную область. Если объектов
нет, то возвращается пустой список. Форматы метода:
items() items([order=DescendingOrder]) items(<QPointF>[, mode=IntersectsltemShape][, order=DescendingOrder][, deviceTransform=QTransform()]) items(<X>, <Y>, <Ширина>, <Высота>[, mode=IntersectsItemShape][, order=DescendingOrder][, deviceTransform=QTransform()]) items (<QRectF>[, mode=IntersectsItemShape][, order=DescendingOrder] [, deviceTransfom=QTransform()]) items(<QPolygonF>[, mode=lntersectsltemShape][, order=DescendingOrder][, deviceTransfom=QTransform()]) items(<QPainterPath>[, mode=IntersectsItemShape][, order=DescendingOrder][, deviceTransform=QTransform()])В необязательном параметре order, задающем порядок сортировки объектов, указываются атрибуты AscendingOrder (в алфавитном порядке) или DescendingOrder (в обратном порядке) класса QtCore.Qt.
В необязательном параметре mode указываются следующие атрибуты класса QtCore.Qt:
- ContainsItemShape (или 0) - объект попадет в список, если все точки объекта находятся внутри заданной области;
- IntersectsItemShape (или 1) - объект попадет в список, если любая точка объекта попадает в заданную область;
- ContainsItemBoundingRect (или 2) - объект попадет в список, если охватывающий прямоугольник полностью находится внутри заданной области;
- IntersectsItemBoundingRect(или 3) - объект попадет в список, если любая точка охватывающего прямоугольника попадает в заданную область.
Необязательный параметр deviceTransform задает примененные к сцене преобразования системы координат (см. 191 шаг). Его необходимо указывать, если на сцене присутствуют объекты, игнорирующие преобразования.
На следующем шаге мы рассмотрим управление фокусом ввода.
