QSizePolicy¶

Synopsis¶

Functions¶

def __eq__ (s)
def __ne__ (s)
def controlType ()
def expandingDirections ()
def hasHeightForWidth ()
def hasWidthForHeight ()
def horizontalPolicy ()
def horizontalStretch ()
def setControlType (type)
def setHeightForWidth (b)
def setHorizontalPolicy (d)
def setHorizontalStretch (stretchFactor)
def setVerticalPolicy (d)
def setVerticalStretch (stretchFactor)
def setWidthForHeight (b)
def transpose ()
def verticalPolicy ()
def verticalStretch ()

Detailed Description¶

The PySide.QtGui.QSizePolicy class is a layout attribute describing horizontal and vertical resizing policy.

The size policy of a widget is an expression of its willingness to be resized in various ways, and affects how the widget is treated by the layout engine . Each widget returns a PySide.QtGui.QSizePolicy that describes the horizontal and vertical resizing policy it prefers when being laid out. You can change this for a specific widget by changing its QWidget.sizePolicy property.

PySide.QtGui.QSizePolicy contains two independent QSizePolicy.Policy values and two stretch factors; one describes the widgets’s horizontal size policy, and the other describes its vertical size policy. It also contains a flag to indicate whether the height and width of its preferred size are related.

The horizontal and vertical policies can be set in the constructor, and altered using the PySide.QtGui.QSizePolicy.setHorizontalPolicy() and PySide.QtGui.QSizePolicy.setVerticalPolicy() functions. The stretch factors can be set using the PySide.QtGui.QSizePolicy.setHorizontalStretch() and PySide.QtGui.QSizePolicy.setVerticalStretch() functions. The flag indicating whether the widget’s PySide.QtGui.QWidget.sizeHint() is width-dependent (such as a menu bar or a word-wrapping label) can be set using the PySide.QtGui.QSizePolicy.setHeightForWidth() function.

The current size policies and stretch factors be retrieved using the PySide.QtGui.QSizePolicy.horizontalPolicy() , PySide.QtGui.QSizePolicy.verticalPolicy() , PySide.QtGui.QSizePolicy.horizontalStretch() and PySide.QtGui.QSizePolicy.verticalStretch() functions. Alternatively, use the PySide.QtGui.QSizePolicy.transpose() function to swap the horizontal and vertical policies and stretches. The PySide.QtGui.QSizePolicy.hasHeightForWidth() function returns the current status of the flag indicating the size hint dependencies.

Use the PySide.QtGui.QSizePolicy.expandingDirections() function to determine whether the associated widget can make use of more space than its PySide.QtGui.QWidget.sizeHint() function indicates, as well as find out in which directions it can expand.

Finally, the PySide.QtGui.QSizePolicy class provides operators comparing this size policy to a given policy, as well as a PySide.QtCore.QVariant operator storing this PySide.QtGui.QSizePolicy as a PySide.QtCore.QVariant object.

See also

PySide.QtCore.QSize QWidget.sizeHint() QWidget.sizePolicy QLayoutItem.sizeHint()

class PySide.QtGui.QSizePolicy¶

class PySide.QtGui.QSizePolicy(horizontal, vertical)

class PySide.QtGui.QSizePolicy(horizontal, vertical, type)

class PySide.QtGui.QSizePolicy(QSizePolicy)

Parameters:	vertical – `PySide.QtGui.QSizePolicy.Policy` type – `PySide.QtGui.QSizePolicy.ControlType` horizontal – `PySide.QtGui.QSizePolicy.Policy` QSizePolicy – `PySide.QtGui.QSizePolicy`

Constructs a PySide.QtGui.QSizePolicy object with Fixed as its horizontal and vertical policies.

The policies can be altered using the PySide.QtGui.QSizePolicy.setHorizontalPolicy() and PySide.QtGui.QSizePolicy.setVerticalPolicy() functions. Use the PySide.QtGui.QSizePolicy.setHeightForWidth() function if the preferred height of the widget is dependent on the width of the widget (for example, a PySide.QtGui.QLabel with line wrapping).

Constructs a PySide.QtGui.QSizePolicy object with the given horizontal and vertical policies, and DefaultType as the control type.

Use PySide.QtGui.QSizePolicy.setHeightForWidth() if the preferred height of the widget is dependent on the width of the widget (for example, a PySide.QtGui.QLabel with line wrapping).

Constructs a PySide.QtGui.QSizePolicy object with the given horizontal and vertical policies, and the specified control type .

Use PySide.QtGui.QSizePolicy.setHeightForWidth() if the preferred height of the widget is dependent on the width of the widget (for example, a PySide.QtGui.QLabel with line wrapping).

PySide.QtGui.QSizePolicy.ControlType¶

This enum specifies the different types of widgets in terms of layout interaction:

Constant	Description
QSizePolicy.DefaultType	The default type, when none is specified.
QSizePolicy.ButtonBox	A `PySide.QtGui.QDialogButtonBox` instance.
QSizePolicy.CheckBox	A `PySide.QtGui.QCheckBox` instance.
QSizePolicy.ComboBox	A `PySide.QtGui.QComboBox` instance.
QSizePolicy.Frame	A `PySide.QtGui.QFrame` instance.
QSizePolicy.GroupBox	A `PySide.QtGui.QGroupBox` instance.
QSizePolicy.Label	A `PySide.QtGui.QLabel` instance.
QSizePolicy.Line	A `PySide.QtGui.QFrame` instance with `QFrame.HLine` or `QFrame.VLine` .
QSizePolicy.LineEdit	A `PySide.QtGui.QLineEdit` instance.
QSizePolicy.PushButton	A `PySide.QtGui.QPushButton` instance.
QSizePolicy.RadioButton	A `PySide.QtGui.QRadioButton` instance.
QSizePolicy.Slider	A `PySide.QtGui.QAbstractSlider` instance.
QSizePolicy.SpinBox	A `PySide.QtGui.QAbstractSpinBox` instance.
QSizePolicy.TabWidget	A `PySide.QtGui.QTabWidget` instance.
QSizePolicy.ToolButton	A `PySide.QtGui.QToolButton` instance.

PySide.QtGui.QSizePolicy.PolicyFlag¶

These flags are combined together to form the various QSizePolicy.Policy values:

Constant	Description
QSizePolicy.GrowFlag	The widget can grow beyond its size hint if necessary.
QSizePolicy.ExpandFlag	The widget should get as much space as possible.
QSizePolicy.ShrinkFlag	The widget can shrink below its size hint if necessary.
QSizePolicy.IgnoreFlag	The widget’s size hint is ignored. The widget will get as much space as possible.

See also

QSizePolicy.Policy

PySide.QtGui.QSizePolicy.SizePolicyMasks¶

PySide.QtGui.QSizePolicy.Policy¶

This enum describes the various per-dimension sizing types used when constructing a PySide.QtGui.QSizePolicy .

Constant	Description
QSizePolicy.Fixed	The `QWidget.sizeHint()` is the only acceptable alternative, so the widget can never grow or shrink (e.g. the vertical direction of a push button).
QSizePolicy.Minimum	The `sizeHint()` is minimal, and sufficient. The widget can be expanded, but there is no advantage to it being larger (e.g. the horizontal direction of a push button). It cannot be smaller than the size provided by `sizeHint()` .
QSizePolicy.Maximum	The `sizeHint()` is a maximum. The widget can be shrunk any amount without detriment if other widgets need the space (e.g. a separator line). It cannot be larger than the size provided by `sizeHint()` .
QSizePolicy.Preferred	The `sizeHint()` is best, but the widget can be shrunk and still be useful. The widget can be expanded, but there is no advantage to it being larger than `sizeHint()` (the default `PySide.QtGui.QWidget` policy).
QSizePolicy.Expanding	The `sizeHint()` is a sensible size, but the widget can be shrunk and still be useful. The widget can make use of extra space, so it should get as much space as possible (e.g. the horizontal direction of a horizontal slider).
QSizePolicy.MinimumExpanding	The `sizeHint()` is minimal, and sufficient. The widget can make use of extra space, so it should get as much space as possible (e.g. the horizontal direction of a horizontal slider).
QSizePolicy.Ignored	The `sizeHint()` is ignored. The widget will get as much space as possible.

PySide.QtGui.QSizePolicy.controlType()¶

Return type:	`PySide.QtGui.QSizePolicy.ControlType`

Returns the control type associated with the widget for which this size policy applies.

PySide.QtGui.QSizePolicy.expandingDirections()¶

Return type:	`PySide.QtCore.Qt.Orientations`

Returns whether a widget can make use of more space than the QWidget.sizeHint() function indicates.

A value of Qt.Horizontal or Qt.Vertical means that the widget can grow horizontally or vertically (i.e., the horizontal or vertical policy is Expanding or MinimumExpanding ), whereas Qt.Horizontal | Qt.Vertical means that it can grow in both dimensions.

PySide.QtGui.QSizePolicy.hasHeightForWidth()¶

Return type:	`PySide.QtCore.bool`

Returns true if the widget’s preferred height depends on its width; otherwise returns false.

PySide.QtGui.QSizePolicy.hasWidthForHeight()¶

Return type:	`PySide.QtCore.bool`

Returns true if the widget’s width depends on its height; otherwise returns false.

PySide.QtGui.QSizePolicy.horizontalPolicy()¶

Return type:	`PySide.QtGui.QSizePolicy.Policy`

Returns the horizontal component of the size policy.

PySide.QtGui.QSizePolicy.horizontalStretch()¶

Return type:	`PySide.QtCore.int`

Returns the horizontal stretch factor of the size policy.

PySide.QtGui.QSizePolicy.__ne__(s)¶

Parameters:	s – `PySide.QtGui.QSizePolicy`
Return type:	`PySide.QtCore.bool`

Returns true if this policy is different from other ; otherwise returns false.

See also

PySide.QtGui.QSizePolicy.operator==()

PySide.QtGui.QSizePolicy.__eq__(s)¶

Parameters:	s – `PySide.QtGui.QSizePolicy`
Return type:	`PySide.QtCore.bool`

Returns true if this policy is equal to other ; otherwise returns false.

See also

PySide.QtGui.QSizePolicy.operator!=()

PySide.QtGui.QSizePolicy.setControlType(type)¶

Parameters:	type – `PySide.QtGui.QSizePolicy.ControlType`

Sets the control type associated with the widget for which this size policy applies to type .

The control type specifies the type of the widget for which this size policy applies. It is used by some styles, notably PySide.QtGui.QMacStyle , to insert proper spacing between widgets. For example, the Mac OS X Aqua guidelines specify that push buttons should be separated by 12 pixels, whereas vertically stacked radio buttons only require 6 pixels.

PySide.QtGui.QSizePolicy.setHeightForWidth(b)¶

Parameters:	b – `PySide.QtCore.bool`

Sets the flag determining whether the widget’s preferred height depends on its width, to dependent .

PySide.QtGui.QSizePolicy.setHorizontalPolicy(d)¶

Parameters:	d – `PySide.QtGui.QSizePolicy.Policy`

Sets the horizontal component to the given policy .

PySide.QtGui.QSizePolicy.setHorizontalStretch(stretchFactor)¶

Parameters:	stretchFactor – `PySide.QtCore.uchar`

Sets the horizontal stretch factor of the size policy to the given stretchFactor .

PySide.QtGui.QSizePolicy.setVerticalPolicy(d)¶

Parameters:	d – `PySide.QtGui.QSizePolicy.Policy`

Sets the vertical component to the given policy .

PySide.QtGui.QSizePolicy.setVerticalStretch(stretchFactor)¶

Parameters:	stretchFactor – `PySide.QtCore.uchar`

Sets the vertical stretch factor of the size policy to the given stretchFactor .

PySide.QtGui.QSizePolicy.setWidthForHeight(b)¶

Parameters:	b – `PySide.QtCore.bool`

Sets the flag determining whether the widget’s width depends on its height, to dependent .

This is only supported for PySide.QtGui.QGraphicsLayout ‘s subclasses. It is not possible to have a layout with both height-for-width and width-for-height constraints at the same time.

PySide.QtGui.QSizePolicy.transpose()¶: Swaps the horizontal and vertical policies and stretches.

PySide.QtGui.QSizePolicy.verticalPolicy()¶

Return type:	`PySide.QtGui.QSizePolicy.Policy`

Returns the vertical component of the size policy.

PySide.QtGui.QSizePolicy.verticalStretch()¶

Return type:	`PySide.QtCore.int`

Returns the vertical stretch factor of the size policy.

Table Of Contents

Previous topic

Next topic

QSizePolicy¶

Synopsis¶

Functions¶

Detailed Description¶

Table Of Contents

Previous topic

Next topic

Quick search

QSizePolicy¶

Synopsis¶

Functions¶

Detailed Description¶