Skip to content

GraphicsGridLayout

Qt Base Class: QGraphicsGridLayout

Signature: QGraphicsGridLayout(self, parent: Optional[PySide6.QtWidgets.QGraphicsLayoutItem] = None) -> None

Base classes

Name Children Inherits
GraphicsLayoutMixin
prettyqt.widgets.graphicslayout
QGraphicsGridLayout
PySide6.QtWidgets
QGraphicsGridLayout(self, parent: Optional[PySide6.QtWidgets.QGraphicsLayoutItem] \= None) -> None

⋔ Inheritance diagram

graph TD
  1473296153408["widgets.GraphicsGridLayout"]
  1473293716544["widgets.GraphicsLayoutMixin"]
  1473293712640["widgets.GraphicsLayoutItemMixin"]
  140713234304496["builtins.object"]
  1473290813568["QtWidgets.QGraphicsGridLayout"]
  1473290826256["QtWidgets.QGraphicsLayout"]
  1473290825280["QtWidgets.QGraphicsLayoutItem"]
  1473291690208["Shiboken.Object"]
  1473293716544 --> 1473296153408
  1473293712640 --> 1473293716544
  140713234304496 --> 1473293712640
  1473290813568 --> 1473296153408
  1473290826256 --> 1473290813568
  1473290825280 --> 1473290826256
  1473291690208 --> 1473290825280
  140713234304496 --> 1473291690208

🛈 DocStrings

Bases: GraphicsLayoutMixin, QGraphicsGridLayout

Grid layout for managing widgets in Graphics View.

Source code in prettyqt\widgets\graphicsgridlayout.py 
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
class GraphicsGridLayout(widgets.GraphicsLayoutMixin, widgets.QGraphicsGridLayout):
    """Grid layout for managing widgets in Graphics View."""

    def __getitem__(
        self, index: tuple[int | slice, int | slice] | int
    ) -> widgets.QGraphicsLayoutItem | None:
        rowcount = self.rowCount()
        colcount = self.columnCount()
        match index:
            case int() as row, int() as col:
                if row >= rowcount or col >= rowcount:
                    raise IndexError(index)
                return self.itemAt(row, col)
            case (row, col):
                items = [
                    item
                    for i, j in helpers.iter_positions(row, col, rowcount, colcount)
                    if (item := self.itemAt(i, j)) is not None
                ]
                return listdelegators.ListDelegator(list(set(items)))
            case int() as row:
                if row >= rowcount:
                    raise IndexError(index)
                return self.itemAt(row)
            case slice() as rowslice:
                count = rowcount if rowslice.stop is None else rowslice.stop
                items = [self.itemAt(i) for i in range(count)[rowslice]]
                return listdelegators.ListDelegator(list(set(item)))
            case str():
                return self.find_child(widgets.QGraphicsWidget, index)
            case _:
                raise TypeError(index)

    def __setitem__(
        self,
        idx: tuple[int | slice, int | slice],
        value: widgets.QGraphicsLayoutItem,
    ):
        row, col = idx
        rowspan = row.stop - row.start + 1 if isinstance(row, slice) else 1
        colspan = col.stop - col.start + 1 if isinstance(col, slice) else 1
        rowstart = row.start if isinstance(row, slice) else row
        colstart = col.start if isinstance(col, slice) else col
        self.add(value, rowstart, colstart, rowspan, colspan)

    def serialize_fields(self):
        items = []
        positions = []
        for row in range(self.rowCount()):
            for col in range(self.columnCount()):
                item = self.itemAt(row, col)
                if item is not None:
                    items.append(item)
                    positions.append((row, col))
        return dict(widgets=items, positions=positions)

    def __reduce__(self):
        return type(self), (), self.__getstate__()

    def __setstate__(self, state):
        for item, pos in zip(state["widgets"], state["positions"]):
            x, y, w, h = pos
            self[x : x + w - 1, y : y + h - 1] = item

    def __iter__(self) -> Iterator[widgets.QWidget | widgets.QLayout]:
        return iter(self[i] for i in range(self.count()) if self[i] is not None)

    def __add__(
        self,
        other: (Iterable[widgets.QGraphicsLayoutItem] | widgets.QGraphicsLayoutItem),
    ):
        if isinstance(other, Iterable):
            for i, control in enumerate(other):
                self[self.rowCount(), i] = control
        else:
            self[self.rowCount(), 0 : self.columnCount() - 1] = other
        return self

    def add(
        self,
        item: widgets.QGraphicsLayoutItem,
        rowstart: int,
        colstart: int,
        rowspan: int = 1,
        colspan: int = 1,
    ):
        self.addItem(item, rowstart, colstart, rowspan, colspan)

    def append(self, item: widgets.QGraphicsLayoutItem):
        self[self.rowCount(), 0 : self.columnCount() - 1] = item

    def set_column_alignment(
        self, column: int, alignment: constants.AlignmentStr | constants.AlignmentFlag
    ):
        self.setColumnAlignment(column, constants.ALIGNMENTS.get_enum_value(alignment))

    def set_row_alignment(
        self, row: int, alignment: constants.AlignmentStr | constants.AlignmentFlag
    ):
        self.setRowAlignment(row, constants.ALIGNMENTS.get_enum_value(alignment))