Scroll to navigation

QwtDynGridLayout(3) Qwt User's Guide QwtDynGridLayout(3)

NAME

QwtDynGridLayout -
The QwtDynGridLayout class lays out widgets in a grid, adjusting the number of columns and rows to the current size.
 

SYNOPSIS

#include <qwt_dyngrid_layout.h>

Public Member Functions


virtual void addItem (QLayoutItem *)
 
virtual uint columnsForWidth (int width) const
 
virtual int count () const
 
virtual Qt::Orientations expandingDirections () const
 
virtual bool hasHeightForWidth () const
 
virtual int heightForWidth (int) const
 
virtual void invalidate ()
 
virtual bool isEmpty () const
 
virtual QLayoutItem * itemAt (int index) const
 
uint itemCount () const
 
QList< QRect > layoutItems (const QRect &, uint numCols) const
 
uint maxCols () const
 
virtual int maxItemWidth () const
 
uint numCols () const
 
uint numRows () const
 
QwtDynGridLayout (QWidget *, int margin=0, int space=-1)
 
QwtDynGridLayout (int space=-1)
 
void setExpandingDirections (Qt::Orientations)
 
virtual void setGeometry (const QRect &rect)
 
void setMaxCols (uint maxCols)
 
virtual QSize sizeHint () const
 
virtual QLayoutItem * takeAt (int index)
 
virtual ~QwtDynGridLayout ()
 

Protected Member Functions


void layoutGrid (uint numCols, QwtArray< int > &rowHeight, QwtArray< int > &colWidth) const
 
void stretchGrid (const QRect &rect, uint numCols, QwtArray< int > &rowHeight, QwtArray< int > &colWidth) const
 

Detailed Description

The QwtDynGridLayout class lays out widgets in a grid, adjusting the number of columns and rows to the current size.
 
QwtDynGridLayout takes the space it gets, divides it up into rows and columns, and puts each of the widgets it manages into the correct cell(s). It lays out as many number of columns as possible (limited by maxCols()).

Constructor & Destructor Documentation

QwtDynGridLayout::QwtDynGridLayout (QWidget *parent, intmargin = 0, intspacing = -1) [explicit] Parameters:

parent Parent widget
 
margin Margin
 
spacing Spacing
 

QwtDynGridLayout::QwtDynGridLayout (intspacing = -1) [explicit] Parameters:

spacing Spacing
 

QwtDynGridLayout::~QwtDynGridLayout () [virtual]

Destructor.

Member Function Documentation

void QwtDynGridLayout::addItem (QLayoutItem *item) [virtual]

Adds item to the next free position.

uint QwtDynGridLayout::columnsForWidth (intwidth) const [virtual] Calculate the number of columns for a given width. It tries to use as many columns as possible (limited by maxCols())

Parameters:
width Available width for all columns
See also:
maxCols(), setMaxCols()
 

int QwtDynGridLayout::count () const [virtual] Returns:

Number of items in the layout
 

Qt::Orientations QwtDynGridLayout::expandingDirections () const [virtual] Returns whether this layout can make use of more space than sizeHint(). A value of Qt::Vertical or Qt::Horizontal means that it wants to grow in only one dimension, while Qt::Vertical | Qt::Horizontal means that it wants to grow in both dimensions.

See also:
setExpandingDirections()
 

bool QwtDynGridLayout::hasHeightForWidth () const [virtual] Returns:

true: QwtDynGridLayout implements heightForWidth.
See also:
heightForWidth()
 

int QwtDynGridLayout::heightForWidth (intwidth) const [virtual] Returns:

The preferred height for this layout, given the width w.
See also:
hasHeightForWidth()
 

void QwtDynGridLayout::invalidate () [virtual]

Invalidate all internal caches.

bool QwtDynGridLayout::isEmpty () const [virtual] Returns:

true if this layout is empty.
 

QLayoutItem * QwtDynGridLayout::itemAt (intindex) const [virtual] Find the item at a spcific index

Parameters:
index Index
See also:
takeAt()
 

uint QwtDynGridLayout::itemCount () const Returns:

number of layout items
 

void QwtDynGridLayout::layoutGrid (uintnumCols, QwtArray< int > &rowHeight, QwtArray< int > &colWidth) const [protected] Calculate the dimensions for the columns and rows for a grid of numCols columns.

Parameters:
numCols Number of columns.
 
rowHeight Array where to fill in the calculated row heights.
 
colWidth Array where to fill in the calculated column widths.
 

QList< QRect > QwtDynGridLayout::layoutItems (const QRect &rect, uintnumCols) const Calculate the geometries of the layout items for a layout with numCols columns and a given rect.

Parameters:
rect Rect where to place the items
 
numCols Number of columns
Returns:
item geometries
 

uint QwtDynGridLayout::maxCols () const Return the upper limit for the number of columns. 0 means unlimited, what is the default.

See also:
setMaxCols()
 

int QwtDynGridLayout::maxItemWidth () const [virtual] Returns:

the maximum width of all layout items
 

uint QwtDynGridLayout::numCols () const Returns:

Number of columns of the current layout.
See also:
numRows()
Warning:
The number of columns might change whenever the geometry changes
 

uint QwtDynGridLayout::numRows () const Returns:

Number of rows of the current layout.
See also:
numCols()
Warning:
The number of rows might change whenever the geometry changes
 

void QwtDynGridLayout::setExpandingDirections (Qt::Orientationsexpanding) Set whether this layout can make use of more space than sizeHint(). A value of Qt::Vertical or Qt::Horizontal means that it wants to grow in only one dimension, while Qt::Vertical | Qt::Horizontal means that it wants to grow in both dimensions. The default value is 0.

Parameters:
expanding Or'd orientations
See also:
expandingDirections()
 

void QwtDynGridLayout::setGeometry (const QRect &rect) [virtual] Reorganizes columns and rows and resizes managed widgets within the rectangle rect.

Parameters:
rect Layout geometry
 

void QwtDynGridLayout::setMaxCols (uintmaxCols) Limit the number of columns.

Parameters:
maxCols upper limit, 0 means unlimited
See also:
maxCols()
 

QSize QwtDynGridLayout::sizeHint () const [virtual] Return the size hint. If maxCols() > 0 it is the size for a grid with maxCols() columns, otherwise it is the size for a grid with only one row.

See also:
maxCols(), setMaxCols()
 

void QwtDynGridLayout::stretchGrid (const QRect &rect, uintnumCols, QwtArray< int > &rowHeight, QwtArray< int > &colWidth) const [protected] Stretch columns in case of expanding() & QSizePolicy::Horizontal and rows in case of expanding() & QSizePolicy::Vertical to fill the entire rect. Rows and columns are stretched with the same factor.

See also:
setExpanding(), expanding()
 

QLayoutItem * QwtDynGridLayout::takeAt (intindex) [virtual] Find the item at a spcific index and remove it from the layout

Parameters:
index Index
See also:
itemAt()
 
 

Author

Generated automatically by Doxygen for Qwt User's Guide from the source code.
Mon Aug 1 2011 Version 5.2.2