              
QSizePolicy Class Reference |
| enum | ControlType { DefaultType, ButtonBox, CheckBox, ComboBox, ..., ToolButton } |
| flags | ControlTypes |
| enum | Policy { Fixed, Minimum, Maximum, Preferred, ..., Ignored } |
| enum | PolicyFlag { GrowFlag, ExpandFlag, ShrinkFlag, IgnoreFlag } |
Public Functions
| QSizePolicy () | |
| QSizePolicy ( Policy horizontal, Policy vertical ) | |
| QSizePolicy ( Policy horizontal, Policy vertical, ControlType type ) | |
| ControlType | controlType () const |
| Qt::Orientations | expandingDirections () const |
| bool | hasHeightForWidth () const |
| Policy | horizontalPolicy () const |
| int | horizontalStretch () const |
| void | setControlType ( ControlType type ) |
| void | setHeightForWidth ( bool dependent ) |
| void | setHorizontalPolicy ( Policy policy ) |
| void | setHorizontalStretch ( uchar stretchFactor ) |
| void | setVerticalPolicy ( Policy policy ) |
| void | setVerticalStretch ( uchar stretchFactor ) |
| void | transpose () |
| Policy | verticalPolicy () const |
| int | verticalStretch () const |
| operator QVariant () const | |
| bool | operator!= ( const QSizePolicy & other ) const |
| bool | operator== ( const QSizePolicy & other ) const |
Related Non-Members
| QDataStream & | operator<< ( QDataStream & stream, const QSizePolicy & policy ) |
| QDataStream & | operator>> ( QDataStream & stream, QSizePolicy & policy ) |
Detailed Description
The 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 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.
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 setHorizontalPolicy() and setVerticalPolicy() functions. The stretch factors can be set using the setHorizontalStretch() and setVerticalStretch() functions. The flag indicating whether the widget's sizeHint() is width-dependent (such as a menu bar or a word-wrapping label) can be set using the setHeightForWidth() function.
The current size policies and stretch factors be retrieved using the horizontalPolicy(), verticalPolicy(), horizontalStretch() and verticalStretch() functions. Alternatively, use the transpose() function to swap the horizontal and vertical policies and stretches. The hasHeightForWidth() function returns the current status of the flag indicating the size hint dependencies.
Use the expandingDirections() function to determine whether the associated widget can make use of more space than its sizeHint() function indicates, as well as find out in which directions it can expand.
Finally, the QSizePolicy class provides operators comparing this size policy to a given policy, as well as a QVariant operator storing this QSizePolicy as a QVariant object.
See also QSize, QWidget::sizeHint(), QWidget::sizePolicy, and QLayoutItem::sizeHint().
Member Type Documentation
enum QSizePolicy::ControlType
flags QSizePolicy::ControlTypes
flags QSizePolicy::ControlTypes
This enum specifies the different types of widgets in terms of layout interaction:
| Constant | Value | Description |
|---|---|---|
| QSizePolicy::DefaultType | 0x00000001 | The default type, when none is specified. |
| QSizePolicy::ButtonBox | 0x00000002 | A QDialogButtonBox instance. |
| QSizePolicy::CheckBox | 0x00000004 | A QCheckBox instance. |
| QSizePolicy::ComboBox | 0x00000008 | A QComboBox instance. |
| QSizePolicy::Frame | 0x00000010 | A QFrame instance. |
| QSizePolicy::GroupBox | 0x00000020 | A QGroupBox instance. |
| QSizePolicy::Label | 0x00000040 | A QLabel instance. |
| QSizePolicy::Line | 0x00000080 | A QFrame instance with QFrame::HLine or QFrame::VLine. |
| QSizePolicy::LineEdit | 0x00000100 | A QLineEdit instance. |
| QSizePolicy::PushButton | 0x00000200 | A QPushButton instance. |
| QSizePolicy::RadioButton | 0x00000400 | A QRadioButton instance. |
| QSizePolicy::Slider | 0x00000800 | A QAbstractSlider instance. |
| QSizePolicy::SpinBox | 0x00001000 | A QAbstractSpinBox instance. |
| QSizePolicy::TabWidget | 0x00002000 | A QTabWidget instance. |
| QSizePolicy::ToolButton | 0x00004000 | A QToolButton instance. |
This enum was introduced in Qt 4.3.
The ControlTypes type is a typedef for QFlags<ControlType>. It stores an OR combination of ControlType values.
See also setControlType() and controlType().
enum QSizePolicy::Policy
This enum describes the various per-dimension sizing types used when constructing a QSizePolicy.
| Constant | Value | Description |
|---|---|---|
| QSizePolicy::Fixed | 0 | 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 | GrowFlag | 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 | ShrinkFlag | 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 | GrowFlag | ShrinkFlag | 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 QWidget policy). |
| QSizePolicy::Expanding | GrowFlag | ShrinkFlag | ExpandFlag | 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 | GrowFlag | ExpandFlag | 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 | ShrinkFlag | GrowFlag | IgnoreFlag | The sizeHint() is ignored. The widget will get as much space as possible. |
See also PolicyFlag, setHorizontalPolicy(), and setVerticalPolicy().
enum QSizePolicy::PolicyFlag
These flags are combined together to form the various Policy values:
| Constant | Value | Description |
|---|---|---|
| QSizePolicy::GrowFlag | 1 | The widget can grow beyond its size hint if necessary. |
| QSizePolicy::ExpandFlag | 2 | The widget should get as much space as possible. |
| QSizePolicy::ShrinkFlag | 4 | The widget can shrink below its size hint if necessary. |
| QSizePolicy::IgnoreFlag | 8 | The widget's size hint is ignored. The widget will get as much space as possible. |
See also Policy.
Member Function Documentation
QSizePolicy::QSizePolicy ()
Constructs a QSizePolicy object with Fixed as its horizontal and vertical policies.
The policies can be altered using the setHorizontalPolicy() and setVerticalPolicy() functions. Use the setHeightForWidth() function if the preferred height of the widget is dependent on the width of the widget (for example, a QLabel with line wrapping).
See also setHorizontalStretch() and setVerticalStretch().
QSizePolicy::QSizePolicy ( Policy horizontal, Policy vertical )
Constructs a QSizePolicy object with the given horizontal and vertical policies, and DefaultType as the control type.
Use setHeightForWidth() if the preferred height of the widget is dependent on the width of the widget (for example, a QLabel with line wrapping).
See also setHorizontalStretch() and setVerticalStretch().
QSizePolicy::QSizePolicy ( Policy horizontal, Policy vertical, ControlType type )
Constructs a QSizePolicy object with the given horizontal and vertical policies, and the specified control type.
Use setHeightForWidth() if the preferred height of the widget is dependent on the width of the widget (for example, a QLabel with line wrapping).
This function was introduced in Qt 4.3.
See also setHorizontalStretch(), setVerticalStretch(), and controlType().
ControlType QSizePolicy::controlType () const
Returns the control type associated with the widget for which this size policy applies.
This function was introduced in Qt 4.3.
See also setControlType().
Qt::Orientations QSizePolicy::expandingDirections () const
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.
See also horizontalPolicy() and verticalPolicy().
bool QSizePolicy::hasHeightForWidth () const
Returns true if the widget's preferred height depends on its width; otherwise returns false.
See also setHeightForWidth().
Policy QSizePolicy::horizontalPolicy () const
Returns the horizontal component of the size policy.
See also setHorizontalPolicy(), verticalPolicy(), and horizontalStretch().
int QSizePolicy::horizontalStretch () const
Returns the horizontal stretch factor of the size policy.
See also setHorizontalStretch(), verticalStretch(), and horizontalPolicy().
void QSizePolicy::setControlType ( ControlType type )
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 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.
This function was introduced in Qt 4.3.
See also controlType() and QStyle::layoutSpacing().
void QSizePolicy::setHeightForWidth ( bool dependent )
Sets the flag determining whether the widget's preferred height depends on its width, to dependent.
See also hasHeightForWidth().
void QSizePolicy::setHorizontalPolicy ( Policy policy )
Sets the horizontal component to the given policy.
See also horizontalPolicy(), setVerticalPolicy(), and setHorizontalStretch().
void QSizePolicy::setHorizontalStretch ( uchar stretchFactor )
Sets the horizontal stretch factor of the size policy to the given stretchFactor.
See also horizontalStretch(), setVerticalStretch(), and setHorizontalPolicy().
void QSizePolicy::setVerticalPolicy ( Policy policy )
Sets the vertical component to the given policy.
See also verticalPolicy(), setHorizontalPolicy(), and setVerticalStretch().
void QSizePolicy::setVerticalStretch ( uchar stretchFactor )
Sets the vertical stretch factor of the size policy to the given stretchFactor.
See also verticalStretch(), setHorizontalStretch(), and setVerticalPolicy().
void QSizePolicy::transpose ()
Swaps the horizontal and vertical policies and stretches.
Policy QSizePolicy::verticalPolicy () const
Returns the vertical component of the size policy.
See also setVerticalPolicy(), horizontalPolicy(), and verticalStretch().
int QSizePolicy::verticalStretch () const
Returns the vertical stretch factor of the size policy.
See also setVerticalStretch(), horizontalStretch(), and verticalPolicy().
QSizePolicy::operator QVariant () const
Returns a QVariant storing this QSizePolicy.
Returns true if this policy is different from other; otherwise returns false.
See also operator==().
bool QSizePolicy::operator== ( const QSizePolicy & other ) const
Returns true if this policy is equal to other; otherwise returns false.
See also operator!=().
Related Non-Members
QDataStream & operator<< ( QDataStream & stream, const QSizePolicy & policy )
Writes the size policy to the data stream stream.
This function was introduced in Qt 4.2.
See also Format of the QDataStream operators.
QDataStream & operator>> ( QDataStream & stream, QSizePolicy & policy )
Reads the size policy from the data stream stream.
This function was introduced in Qt 4.2.
See also Format of the QDataStream operators.
Best Of
Actualités les plus lues
- « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 64
- 2017 : un quinquennat pour une nouvelle version du C++ ? Possible, selon Herb Sutter 5
- Créer des applications avec un style Metro avec Qt, exemples en QML et C++, un article du blog Digia traduit par Thibaut Cuvelier 0
- Orientation de l'écran en QML, un article de Christophe Dumez traduit par Thibaut Cuvelier 0
- « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 64
- Apercevoir la troisième dimension ou l'utilisation multithreadée d'OpenGL dans Qt, un article des Qt Quarterly traduit par Guillaume Belz 0
- Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
- BlackBerry 10 : premières images du prochain OS de RIM qui devrait intégrer des widgets et des tuiles inspirées de Windows Phone 0
- Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
- Adieu qmake, bienvenue qbs : Qt Building Suite, un outil déclaratif et extensible pour la compilation de projets Qt 17
- La rubrique Qt a besoin de vous ! 1
- Linus Torvalds : le "C++ est un langage horrible", en justifiant le choix du C pour le système de gestion de version Git 100
- Comment prendre en compte l'utilisateur dans vos applications ? Pour un développeur, « 90 % des utilisateurs sont des idiots » 229
- Quel est LE livre que tout développeur doit lire absolument ? Celui qui vous a le plus marqué et inspiré 96
- Apple cède et s'engage à payer des droits à Nokia, le conflit des brevets entre les deux firmes s'achève 158
- Nokia porte à nouveau plainte contre Apple pour violation de sept nouveaux brevets 158
- Quel est le code dont vous êtes le plus fier ? Pourquoi l'avez-vous écrit ? Et pourquoi vous a-t-il donné autant de satisfaction ? 83
- Le Draft final de la norme C++ 0X validé 181
Communauté
Ressources
- cours et tutoriels Qt
- F.A.Q. Qt : questions et réponses
- Qt Quarterly, Qt Labs et Qt DevNet en français
- outils Qt
- sources Qt
- binaires Qt
- livres Qt et critiques
- La documentation de Qt en français : classes, concepts et modules
- 3 certifications Qt
Liens utiles
Contact
- Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).
Qt dans le magazine
| Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. | Qt 4.6 | |
| Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD. | ||
| Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP ! | ||
Copyright © 2000-2012 - www.developpez.com