На этом шаге мы рассмотрим назначение, форматы конструктора и основные методы этого класса.

    Класс QPolygon описывает координаты вершин многоугольника. Форматы конструктора класса:

  <Объект> = QPolygon()
  <Объект> = QPolygon(<Список с экземплярами класса QPoint>)
  <Объект> = QPolygon(<QRect>[, closed=False])
  <Объект> = QPolygon(<Количество вершин>)
  <Объект> = QPolygon(<QPolygon>)

    Первый конструктор создает пустой объект. Заполнить объект координатами вершин можно с помощью оператора <<. Пример добавления координат вершин треугольника:

  polygon = QtGui.QPolygon()
  polygon << QtCore.QPoint(20, 50) << QtCore.QPoint(280, 50)
  polygon << QtCore.QPoint(150, 280)

    Во втором конструкторе указывается список с экземплярами класса QPoint, которые задают координаты отдельных вершин. Пример:

  polygon = QtGui.QPolygon([QtCore.QPoint(20, 50), QtCore.QPoint(280, 50),
    QtCore.QPoint(150, 280)])

    Третий конструктор создает многоугольник на основе экземпляра класса QRect. Если параметр closed имеет значение False, то будут созданы четыре вершины, а если значение True - то пять вершин.

    В четвертом конструкторе можно указать количество вершин, а затем задать координаты путем присваивания значения по индексу:

  polygon = QtGui.QPolygon(3)
  polygon[0] = QtCore.QPoint(20, 50)
  polygon[l] = QtCore.QPoint(280, 50)
  polygon[2] = QtCore.QPoint(150, 280)

    Пятый конструктор создает новый объект на основе другого объекта.

    Класс QPolygon поддерживает следующие методы (здесь приведены только основные - полный их список можно найти на странице https://doc.qt.io/qt-5/qpolygon.html):

• setPoints () - устанавливает координаты вершин. Ранее установленные значения удаляются. Форматы метода:

    setPoints(<Список с координатами>) 
    setPoints(<Xl>, <Y1>[, ..., <Xn>, <Yn>])
  

      Пример указания значений:

    polygon = QtGui.QPolygon()
    polygon.setPoints([20,50, 280,50, 150,280])
  

• prepend (<QPoint>) -добавляет новую вершину в начало объекта;

• append (<QPoint>) - добавляет новую вершину в конец объекта. Добавить вершину можно также с помощью операторов << и +=;

• insert (<Индекс>, <QPoint>) - добавляет новую вершину в указанную позицию;

• setPoint () - задает координаты для вершины с указанным индексом. Форматы метода:

    setPoint(<Индекс>, <QPoint>) 
    setPoint(<Индекс>, <Х>, <Y>)
  

      Можно также задать координаты путем присваивания значения по индексу:

    polygon = QtGui.QPolygon(3)
    polygon.setPoint(0, QtCore.QPoint(20, 50))
    polygon.setPoint(1, 280, 50)
    polygon[2] = QtCore.QPoint(150, 280)
  

• point (<Индекс>) - возвращает экземпляр класса QPoint с координатами вершины, индекс которой указан в параметре. Получить значение можно также с помощью операции доступа по индексу. Пример:

    polygon = QtGui.QPolygon([20,50, 280,50, 150,280]) 
    print(polygon.point(0)) # PyQt5.QtCore.QPoint(20, 50) 
    print(polygon[l])       # PyQt5.QtCore.QPoint(280, 50)
  

• remove (<Индекс>[, <Количество>]) - удаляет указанное количество вершин, начиная с индекса <Индекс>. Если второй параметр не указан, то удаляется одна вершина. Удалить вершину можно также с помощью оператора del по индексу или срезу;

• clear () - удаляет все вершины;

• size () и count ([<QPoint>]) - возвращают количество вершин. Если в методе count() указан параметр, возвращается только количество вершин с указанными координатами. Получить количество вершин можно также с помощью функции len();
• isEmpty () - возвращает значение True, если объект пустой (многоугольник не содержит ни одной вершины), и False - в противном случае;

• boundingRect () - возвращает экземпляр класса QRect с координатами и размерами прямоугольной области, в которую вписан многоугольник.

    На следующем шаге мы рассмотрим класс QFont.

Предыдущий шаг Содержание Следующий шаг