A layout attribute describing horizontal and vertical resizing. More...
#include <qsizepolicy.h>
The size policy of a widget is an expression of its willingness to be resized in various ways.
Widgets which reimplement QWidget::sizePolicy() return a QSizePolicy describing the horizontal and vertical resizing policy best used when laying out the widget. Only one of the constructors is of interest in most applications.
QSizePolicy contains two independent SizeType objects, one which describes the widgets's horizontal size policy and one which describes its vertical size policy, and it contains a flag to indicate whether the height and width of its preferred size are related.
The per-dimension SizeType objects are set in the usual constructor, and can be queried using a variety of functions, none of which are really interesting to application programmers.
The hasHeightForWidth() flag indicates whether the widget's sizeHint() is width-dependent (like a word-wrapping label).
See also QSizePolicy::SizeType.
Examples: xform/xform.cpp
NoDirection
- the widget cannot make us of extra space in any
direction.
Horizontal
- the widget can usefully be wider than sizeHint()
says.
Vertical
- the widget can usefully be taller than sizeHint()
says.
BothDirections
- the widget can usefully be both wider and
taller than sizeHint() says.
Fixed
- the sizeHint() is the only acceptable alternative, so
widget can never grow or shrink (eg. the vertical direction of a
pushbutton).
Minimum
- the sizeHint() is minimal, and sufficient. The
widget can be expanded, but there is no advantage to it being
larger (eg. the horizontal direction of a pushbutton).
Maximum
- the sizeHint() is a maximum. The widget can be
shrunk any amount without detriment if other widgets need the space
(eg. a separator line).
Preferred
- the sizeHint() is best, but the widget can be
shrunk below that and still be useful. The widget can be expanded, but
there is no advantage to it being larger than sizeHint() (the default
QWidget policy).
MinimumExpanding
- the sizeHint() is a minimum. The widget
can make use of extra space, so it should get as much space as
possible (not currently used by any standard Qt widgets).
Expanding
- the sizeHint() is a sensible size, but the
widget can be shrunk below that and still be useful. The widget can
make use of extra space, so it should get as much space as
possible (eg. the horizontal direction of a slider).
Default constructor, produces a minimally initialized QSizePolicy.
This is the constructor normally used to return a value in the overridden QWidget::sizePolicy() function of a QWidget subclass.
It constructs a QSizePolicy with independent horizontal and vertical sizing types, hor and ver respectively. These sizing types affect how the widget is treated by the layout engine.
If hfw is TRUE, the preferred height of the widget is dependent on the width of the widget (for example, a QLabel with automatic word-breaking).
Returns a value indicating if the widget can make use of extra space (ie. if it "wants" to grow) horizontally and/or vertically.
Returns TRUE if the widget's preferred height depends on its width.
Returns the horizontal component of the size policy.
Returns TRUE if the widget can sensibly be wider than its sizeHint().
Returns TRUE if the widget can sensibly be taller than its sizeHint().
Returns TRUE if the widget can sensibly be narrower than its sizeHint().
Returns TRUE if the widget can sensibly be lower than its sizeHint().
Sets the hasHeightForWidth() flag to b.
Sets the horizontal component of the size policy to d.
Sets the vertical component of the size policy to d.
Returns the vertical component of the size policy.
Search the documentation, FAQ, qt-interest archive and more (uses
www.trolltech.com):
This file is part of the Qt toolkit, copyright © 1995-2000 Trolltech, all rights reserved.
Copyright © 2000 Trolltech | Trademarks | Qt version 2.2.1
|