PySide6.QtWidgets.QGraphicsGridLayout

class QGraphicsGridLayout

QGraphicsGridLayout 类提供了一个网格布局，用于在图形视图中管理小部件。更多…

PySide6.QtWidgets.QGraphicsGridLayout 的继承图

概要

方法

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述

警告

本节包含从C++自动翻译到Python的代码片段，可能包含错误。

使用QGraphicsGridLayout最常见的方式是在堆上构造一个对象，将一个父部件传递给构造函数，然后通过调用addItem()来添加部件和布局。QGraphicsGridLayout在您添加项目时会自动计算网格的尺寸。

scene = QGraphicsScene()
textEdit = scene.addWidget(QTextEdit())
pushButton = scene.addWidget(QPushButton())
form = QGraphicsWidget()
scene.addItem(form)
layout = QGraphicsGridLayout(form)
layout.addItem(textEdit, 0, 0)
layout.addItem(pushButton, 0, 1)

或者，如果您没有将父部件传递给布局的构造函数，您将需要调用setLayout()来将此布局设置为该部件的顶级布局，该部件将拥有该布局的所有权。

布局拥有项目的所有权。在某些情况下，当布局项也继承自QGraphicsItem（例如QGraphicsWidget）时，所有权会出现歧义，因为布局项属于两个所有权层次结构。请参阅setOwnedByLayout()的文档以了解如何处理此问题。您可以通过调用count()和itemAt()来访问布局中的每个项目。调用removeAt()将从布局中移除一个项目，但不会销毁它。

QGraphicsGridLayout中的大小提示和大小策略

QGraphicsGridLayout 尊重每个项目的大小提示和大小策略，当网格中的单元格有比项目能填充的更多空间时，每个项目根据该项目的布局对齐方式进行排列。您可以通过调用 setAlignment() 为每个项目设置对齐方式，并通过调用 alignment() 检查任何项目的对齐方式。您还可以分别通过调用 setRowAlignment() 和 setColumnAlignment() 为整行或整列设置对齐方式。默认情况下，项目对齐到左上角。

__init__([parent=None])
Parameters:

父级 – QGraphicsLayoutItem

构建一个QGraphicsGridLayout实例。parent被传递给QGraphicsLayout的构造函数。

addItem(item, row, column[, alignment=Qt.Alignment()])
Parameters:

将item添加到row和column的网格中。您可以为item指定一个可选的alignment。

addItem(item, row, column, rowSpan, columnSpan[, alignment=Qt.Alignment()])
Parameters:

将item添加到row和column的网格中。您可以指定rowSpan和columnSpan以及可选的alignment。

alignment(item)
Parameters:

项目 – QGraphicsLayoutItem

Return type:

AlignmentFlag 的组合

返回item的对齐方式。

另请参阅

setAlignment()

columnAlignment(column)
Parameters:

列 – int

Return type:

AlignmentFlag 的组合

返回column的对齐方式。

另请参阅

setColumnAlignment()

columnCount()
Return type:

整数

返回网格布局中的列数。这总是比被布局项占用的最后一列的索引多一（空列也会被计算，除了末尾的空列）。

columnMaximumWidth(column)
Parameters:

列 – int

Return type:

浮点数

返回column的最大宽度。

columnMinimumWidth(column)
Parameters:

列 – int

Return type:

浮点数

返回column的最小宽度。

columnPreferredWidth(column)
Parameters:

列 – int

Return type:

浮点数

返回column的首选宽度。

columnSpacing(column)
Parameters:

列 – int

Return type:

浮点数

返回column的列间距。

另请参阅

setColumnSpacing()

columnStretchFactor(column)
Parameters:

列 – int

Return type:

整数

返回column的拉伸因子。

horizontalSpacing()
Return type:

浮点数

返回网格布局的默认水平间距。

另请参阅

setHorizontalSpacing()

itemAt(row, column)
Parameters:

  • row – int

  • column – 整数

Return type:

QGraphicsLayoutItem

返回指向位于(row, column)的布局项的指针。

removeItem(item)
Parameters:

项目 – QGraphicsLayoutItem

移除布局项 item 而不销毁它。该项的所有权转移给调用者。

另请参阅

addItem()

rowAlignment(row)
Parameters:

行 – 整数

Return type:

AlignmentFlag 的组合

返回row的对齐方式。

另请参阅

setRowAlignment()

rowCount()
Return type:

整数

返回网格布局中的行数。这总是比被布局项占用的最后一行的索引多一（空行也会被计算，除了末尾的空行）。

rowMaximumHeight(row)
Parameters:

行 – 整数

Return type:

浮点数

返回行的最大高度，row。

另请参阅

setRowMaximumHeight()

rowMinimumHeight(row)
Parameters:

行 – 整数

Return type:

浮点数

返回行的最小高度，row。

另请参阅

setRowMinimumHeight()

rowPreferredHeight(row)
Parameters:

行 – 整数

Return type:

浮点数

返回行的首选高度，row。

rowSpacing(row)
Parameters:

行 – 整数

Return type:

浮点数

返回row的行间距。

另请参阅

setRowSpacing()

rowStretchFactor(row)
Parameters:

行 – 整数

Return type:

整数

返回row的拉伸因子。

另请参阅

setRowStretchFactor()

setAlignment(item, alignment)
Parameters:

将item的对齐方式设置为alignment。

另请参阅

alignment()

setColumnAlignment(column, alignment)
Parameters:

将column的对齐方式设置为alignment。

另请参阅

columnAlignment()

setColumnFixedWidth(column, width)
Parameters:

  • column – 整数

  • width – 浮点数

将column的固定宽度设置为width。

setColumnMaximumWidth(column, width)
Parameters:

  • column – 整数

  • width – 浮点数

将column的最大宽度设置为width。

另请参阅

columnMaximumWidth()

setColumnMinimumWidth(column, width)
Parameters:

  • column – 整数

  • width – 浮点数

将column的最小宽度设置为width。

另请参阅

columnMinimumWidth()

setColumnPreferredWidth(column, width)
Parameters:

  • column – 整数

  • width – 浮点数

将column的首选宽度设置为width。

另请参阅

columnPreferredWidth()

setColumnSpacing(column, spacing)
Parameters:

  • column – 整数

  • spacing – 浮点数

将column的间距设置为spacing。

另请参阅

columnSpacing()

setColumnStretchFactor(column, stretch)
Parameters:

  • column – 整数

  • stretch – int

将column的拉伸因子设置为stretch。

另请参阅

columnStretchFactor()

setHorizontalSpacing(spacing)
Parameters:

间距 – float

将网格布局的默认水平间距设置为 spacing。

另请参阅

horizontalSpacing()

setRowAlignment(row, alignment)
Parameters:

将row的对齐方式设置为alignment。

另请参阅

rowAlignment()

setRowFixedHeight(row, height)
Parameters:

  • row – int

  • height – 浮点数

设置行 row 的固定高度为 height。

setRowMaximumHeight(row, height)
Parameters:

  • row – int

  • height – 浮点数

设置行的最大高度，row，为height。

另请参阅

rowMaximumHeight()

setRowMinimumHeight(row, height)
Parameters:

  • row – int

  • height – 浮点数

设置行 row 的最小高度为 height。

另请参阅

rowMinimumHeight()

setRowPreferredHeight(row, height)
Parameters:

  • row – int

  • height – 浮点数

将行 row 的首选高度设置为 height。

另请参阅

rowPreferredHeight()

setRowSpacing(row, spacing)
Parameters:

  • row – int

  • spacing – 浮点数

将row的间距设置为spacing。

另请参阅

rowSpacing()

setRowStretchFactor(row, stretch)
Parameters:

  • row – int

  • stretch – int

将row的拉伸因子设置为stretch。

另请参阅

rowStretchFactor()

setSpacing(spacing)
Parameters:

间距 – float

将网格布局的默认间距（包括垂直和水平）设置为 spacing。

setVerticalSpacing(spacing)
Parameters:

间距 – float

将网格布局的默认垂直间距设置为 spacing。

另请参阅

verticalSpacing()

verticalSpacing()
Return type:

浮点数

返回网格布局的默认垂直间距。

另请参阅

setVerticalSpacing()