Wt::WVBoxLayout Class Reference

A layout manager which arranges widgets vertically. More...

#include <Wt/WVBoxLayout>

Inheritance diagram for Wt::WVBoxLayout:

Public Member Functions
	WVBoxLayout (WWidget *parent=0)
	Create a new vertical box layout. More...
Public Member Functions inherited from Wt::WBoxLayout
	WBoxLayout (Direction dir, WWidget *parent=0)
	Creates a new box layout. More...
virtual void	addItem (WLayoutItem *item)
	Adds a layout item. More...
virtual void	removeItem (WLayoutItem *item)
	Removes a layout item (widget or nested layout). More...
virtual WLayoutItem *	itemAt (int index) const
	Returns the layout item at a specific index. More...
virtual int	count () const
	Returns the number of items in this layout. More...
virtual void	clear ()
	Removes and deletes all child widgets and nested layouts. More...
void	setDirection (Direction direction)
	Sets the layout direction. More...
Direction	direction () const
	Returns the layout direction. More...
void	setSpacing (int size)
	Sets spacing between each item. More...
int	spacing () const
	Returns the spacing between each item. More...
void	addWidget (WWidget *widget, int stretch=0, WFlags< AlignmentFlag > alignment=0)
	Adds a widget to the layout. More...
void	addLayout (WLayout *layout, int stretch=0, WFlags< AlignmentFlag > alignment=0)
	Adds a nested layout to the layout. More...
void	addSpacing (const WLength &size)
	Adds extra spacing. More...
void	addStretch (int stretch=0)
	Adds a stretch element. More...
void	insertWidget (int index, WWidget *widget, int stretch=0, WFlags< AlignmentFlag > alignment=0)
	Inserts a widget in the layout. More...
void	insertLayout (int index, WLayout *layout, int stretch=0, WFlags< AlignmentFlag > alignment=0)
	Inserts a nested layout in the layout. More...
void	insertSpacing (int index, const WLength &size)
	Inserts extra spacing in the layout. More...
void	insertStretch (int index, int stretch=0)
	Inserts a stretch element in the layout. More...
bool	setStretchFactor (WLayout *layout, int stretch)
	Sets the stretch factor for a nested layout. More...
bool	setStretchFactor (WWidget *widget, int stretch)
	Sets the stretch factor for a widget. More...
void	setResizable (int index, bool enabled=true, const WLength &initialSize=WLength::Auto)
	Sets whether the use may drag a particular border. More...
bool	isResizable (int index) const
	Returns whether the user may drag a particular border. More...
Public Member Functions inherited from Wt::WLayout
virtual	~WLayout ()
	Destructor. More...
void	addWidget (WWidget *widget)
	Adds the given widget to the layout. More...
bool	removeWidget (WWidget *widget)
	Removes the given widget from the layout. More...
virtual int	indexOf (WLayoutItem *item) const
	Returns the index of a given item. More...
virtual WWidgetItem *	findWidgetItem (WWidget *widget)
	Finds the widget item associated with the given widget.
void	setLayoutHint (const std::string &name, const std::string &value)
	Provides a hint to the layout implementation. More...
virtual WWidget *	widget ()
	Returns the widget that is held by this WLayoutItem. More...
virtual WLayout *	layout ()
	Returns the layout that implements this WLayoutItem. More...
virtual WLayout *	parentLayout () const
	Returns the layout in which this item is contained.
WLayoutItemImpl *	impl () const
	Returns the implementation for this layout item. More...
void	setContentsMargins (int left, int top, int right, int bottom)
	Set contents margins (in pixels). More...
void	getContentsMargins (int *left, int *top, int *right, int *bottom) const
	Returns the contents margins. More...
Public Member Functions inherited from Wt::WLayoutItem
virtual	~WLayoutItem ()
	Destructor.
Public Member Functions inherited from Wt::WObject
	WObject (WObject *parent=0)
	Create a WObject with a given parent object. More...
virtual	~WObject ()
	Destructor. More...
virtual const std::string	id () const
	Returns the (unique) identifier for this object. More...
virtual void	setObjectName (const std::string &name)
	Sets an object name. More...
virtual std::string	objectName () const
	Returns the object name. More...
void	resetLearnedSlots ()
	Resets learned stateless slot implementations. More...
template<class T >
void	resetLearnedSlot (void(T::*method)())
	Resets a learned stateless slot implementation. More...
template<class T >
WStatelessSlot *	implementStateless (void(T::*method)())
	Declares a slot to be stateless and learn client-side behaviour on first invocation. More...
template<class T >
WStatelessSlot *	implementStateless (void(T::*method)(), void(T::*undoMethod)())
	Declares a slot to be stateless and learn client-side behaviour in advance. More...
void	isNotStateless ()
	Marks the current function as not stateless. More...
template<class T >
WStatelessSlot *	implementJavaScript (void(T::*method)(), const std::string &jsCode)
	Provides a JavaScript implementation for a method. More...
void	addChild (WObject *child)
	Adds a child object. More...
virtual void	removeChild (WObject *child)
	Removes a child object. More...
const std::vector< WObject * > &	children () const
	Returns the children.
WObject *	parent () const
	Returns the parent object.

Additional Inherited Members
Public Types inherited from Wt::WBoxLayout
Public Types inherited from Wt::WObject
typedef void(WObject::*	Method) ()
	Typedef for a WObject method without arguments.
Protected Member Functions inherited from Wt::WLayout
	WLayout ()
	Create a layout.
void	update (WLayoutItem *item=0)
	Update the layout. More...
void	updateAddItem (WLayoutItem *item)
	Update the layout, adding the given layout item. More...
void	updateRemoveItem (WLayoutItem *item)
	Update the layout, remove the given layout item. More...
void	setLayoutInParent (WWidget *parent)
	Set the layout in the parent. More...
void	clearLayoutItem (WLayoutItem *item)
	Clears and deletes an item. More...
Protected Member Functions inherited from Wt::WObject
virtual WStatelessSlot *	getStateless (Method method)
	On-demand stateless slot implementation. More...
Static Protected Member Functions inherited from Wt::WObject
static WObject *	sender ()
	Returns the sender of the current slot call. More...

Detailed Description

A layout manager which arranges widgets vertically.

This convenience class creates a vertical box layout, laying contained widgets out from top to bottom.

See WBoxLayout for available member methods and more information.

Usage example:

Wt::WContainerWidget *w = new Wt::WContainerWidget(this);
w->resize(WLength::Auto, 600);

Wt::WVBoxLayout *layout = new Wt::WVBoxLayout();
layout->addWidget(new Wt::WText("One"));
layout->addWidget(new Wt::WText("Two"));
layout->addWidget(new Wt::WText("Three"));
layout->addWidget(new Wt::WText("Four"));

w->setLayout(layout);

Note

First consider if you can achieve your layout using CSS !

See also

WHBoxLayout

Constructor & Destructor Documentation

Wt::WVBoxLayout::WVBoxLayout

(

WWidget *

parent = 0

)

Create a new vertical box layout.

Use parent=0 to created a layout manager that can be nested inside other layout managers.