A component class used for layout. More...

Inherits Component.

Public Types
enum	HorizontalEdge
	Horizontal dock position type.

enum	VerticalEdge
	Vertical dock position type.

Public Member Functions
	LayoutComponent ()
	Default constructor.

	~LayoutComponent ()
	Default destructor.

	CREATE_FUNC (LayoutComponent)
	Create a LayoutComponent instance with default settings.

void	setUsingPercentContentSize (bool isUsed)
	Percent content size is used to adapt node's content size based on parent's content size.

bool	getUsingPercentContentSize () const
	Query whether use percent content size or not.

void	setPercentContentSize (const Vec2 &percent)
	Set percent content size.

Vec2	getPercentContentSize () const
	Query the percent content size value.

const Point &	getAnchorPosition () const
	Query the anchor position.

void	setAnchorPosition (const Point &point)
	Change the anchor position to it's parent.

const Point &	getPosition () const
	Query the owner's position.

void	setPosition (const Point &position)
	Change the position of component owner.

bool	isPositionPercentXEnabled () const
	Whether position percentX is enabled or not.

void	setPositionPercentXEnabled (bool isUsed)
	Toggle position percentX enabled.

float	getPositionPercentX () const
	Query the position percent X value.

void	setPositionPercentX (float percentMargin)
	Change position percent X value.

bool	isPositionPercentYEnabled () const
	Whether position percentY is enabled or not.

void	setPositionPercentYEnabled (bool isUsed)
	Toggle position percentY enabled.

float	getPositionPercentY () const
	Query the position percentY Y value.

void	setPositionPercentY (float percentMargin)
	Change position percentY value.

HorizontalEdge	getHorizontalEdge () const
	Query element horizontal dock type.

void	setHorizontalEdge (HorizontalEdge hEage)
	Change element's horizontal dock type.

VerticalEdge	getVerticalEdge () const
	Query element vertical dock type.

void	setVerticalEdge (VerticalEdge vEage)
	Change element's vertical dock type.

float	getLeftMargin () const
	Query left margin of owner relative to its parent.

void	setLeftMargin (float margin)
	Change left margin of owner relative to its parent.

float	getRightMargin () const
	Query the right margin of owner relative to its parent.

void	setRightMargin (float margin)
	Change right margin of owner relative to its parent.

float	getTopMargin () const
	Query the top margin of owner relative to its parent.

void	setTopMargin (float margin)
	Change the top margin of owner relative to its parent.

float	getBottomMargin () const
	Query the bottom margin of owner relative to its parent.

void	setBottomMargin (float margin)
	Change the bottom margin of owner relative to its parent.

const Size &	getSize () const
	Query owner's content size.

void	setSize (const Size &size)
	Change the content size of owner.

bool	isPercentWidthEnabled () const
	Query whether percent width is enabled or not.

void	setPercentWidthEnabled (bool isUsed)
	Toggle enable percent width.

float	getSizeWidth () const
	Query content size width of owner.

void	setSizeWidth (float width)
	Change content size width of owner.

float	getPercentWidth () const
	Query percent width of owner.

void	setPercentWidth (float percentWidth)
	Change percent width of owner.

bool	isPercentHeightEnabled () const
	Query whether percent height is enabled or not.

void	setPercentHeightEnabled (bool isUsed)
	Toggle enable percent height.

float	getSizeHeight () const
	Query size height of owner.

void	setSizeHeight (float height)
	Change size height of owner.

float	getPercentHeight () const
	Query percent height of owner.

void	setPercentHeight (float percentHeight)
	Change percent height value of owner.

bool	isStretchWidthEnabled () const
	Query whether stretch width is enabled or not.

void	setStretchWidthEnabled (bool isUsed)
	Toggle enable stretch width.

bool	isStretchHeightEnabled () const
	Query whether stretch height is enabled or not.

void	setStretchHeightEnabled (bool isUsed)
	Toggle enable stretch height.

void	setPercentOnlyEnabled (bool enable)
	Toggle enable percent only.

void	setActiveEnabled (bool enable)
	Toggle active enabled of LayoutComponent's owner.

void	refreshLayout ()
	Refresh layout of the owner.

Static Public Member Functions
static LayoutComponent *	bindLayoutComponent (Node *node)
	Bind a LayoutComponent to a specified node.

Detailed Description

A component class used for layout.

The LayoutComponent holds all the data for layouting.

Constructor & Destructor Documentation

LayoutComponent ( )

Default constructor.

new

~LayoutComponent ( )

Default destructor.

NA

Member Function Documentation

static LayoutComponent* bindLayoutComponent ( Node * node )

static

Bind a LayoutComponent to a specified node.

If the node has already binded a LayoutComponent named __LAYOUT_COMPONENT_NAME, just return the LayoutComponent. Otherwise, create a new LayoutComponent and bind the LayoutComponent to the node.

Parameters

node	A Node* instance pointer.

Returns: The binded LayoutComponent instance pointer.

void setUsingPercentContentSize ( bool isUsed )

Percent content size is used to adapt node's content size based on parent's content size.

If set to true then node's content size will be changed based on the value set by

See Also: setPercentContentSize

Parameters

isUsed True to enable percent content size, false otherwise.

bool getUsingPercentContentSize ( ) const

Query whether use percent content size or not.

Returns: True if using percent content size, false otherwise.

void setPercentContentSize ( const Vec2 & percent )

Set percent content size.

The value should be [0-1], 0 means the child's content size will be 0 and 1 means the child's content size is the same as its parents.

Parameters

percent The percent (x,y) of the node in [0-1] scope.

Vec2 getPercentContentSize ( ) const

Query the percent content size value.

Returns: Percent (x,y) in Vec2.

const Point& getAnchorPosition ( ) const

Query the anchor position.

Returns: Anchor position to it's parent

void setAnchorPosition ( const Point & point )

Change the anchor position to it's parent.

Parameters

point A value in (x,y) format.

const Point& getPosition ( ) const

Query the owner's position.

Returns: The owner's position.

void setPosition ( const Point & position )

Change the position of component owner.

Parameters

position A position in (x,y)

bool isPositionPercentXEnabled ( ) const

Whether position percentX is enabled or not.

Returns: True if position percentX is enable, false otherwise.

void setPositionPercentXEnabled ( bool isUsed )

Toggle position percentX enabled.

Parameters

isUsed True if enable position percentX, false otherwise.

float getPositionPercentX ( ) const

Query the position percent X value.

Returns: Position percent X value in float.

void setPositionPercentX ( float percentMargin )

Change position percent X value.

Parameters

percentMargin Margin in float.

bool isPositionPercentYEnabled ( ) const

Whether position percentY is enabled or not.

See Also: setPositionPercentYEnabled

Returns: True if position percentY is enabled, false otherwise.

void setPositionPercentYEnabled ( bool isUsed )

Toggle position percentY enabled.

Parameters

isUsed True if position percentY is enabled, false otherwise.

float getPositionPercentY ( ) const

Query the position percentY Y value.

Returns: Position percent Y value in float.

void setPositionPercentY ( float percentMargin )

Change position percentY value.

Parameters

percentMargin Margin in float.

HorizontalEdge getHorizontalEdge ( ) const

Query element horizontal dock type.

Returns: Horizontal dock type.

void setHorizontalEdge ( HorizontalEdge hEage )

Change element's horizontal dock type.

Parameters

hEage Horizontal dock type

See Also: HorizontalEdge

VerticalEdge getVerticalEdge ( ) const

Query element vertical dock type.

Returns: Vertical dock type.

void setVerticalEdge ( VerticalEdge vEage )

Change element's vertical dock type.

Parameters

vEage Vertical dock type

See Also: VerticalEdge.

float getLeftMargin ( ) const

Query left margin of owner relative to its parent.

Returns: Left margin in float.

void setLeftMargin ( float margin )

Change left margin of owner relative to its parent.

Parameters

margin Margin in float.

float getRightMargin ( ) const

Query the right margin of owner relative to its parent.

Returns: Right margin in float.

void setRightMargin ( float margin )

Change right margin of owner relative to its parent.

Parameters

margin Margin in float.

float getTopMargin ( ) const

Query the top margin of owner relative to its parent.

Returns: Top margin in float.

void setTopMargin ( float margin )

Change the top margin of owner relative to its parent.

Parameters

margin Margin in float.

float getBottomMargin ( ) const

Query the bottom margin of owner relative to its parent.

Returns: Bottom margin in float.

void setBottomMargin ( float margin )

Change the bottom margin of owner relative to its parent.

Parameters

margin in float.

const Size& getSize ( ) const

Query owner's content size.

Returns: Owner's content size.

void setSize ( const Size & size )

Change the content size of owner.

Parameters

size	Content size in

See Also: Size.

bool isPercentWidthEnabled ( ) const

Query whether percent width is enabled or not.

Returns: True if percent width is enabled, false, otherwise.

void setPercentWidthEnabled ( bool isUsed )

Toggle enable percent width.

Parameters

isUsed True if percent width is enabled, false otherwise.

float getSizeWidth ( ) const

Query content size width of owner.

Returns: Content size width in float.

void setSizeWidth ( float width )

Change content size width of owner.

Parameters

width Content size width in float.

float getPercentWidth ( ) const

Query percent width of owner.

Returns: percent width in float.

void setPercentWidth ( float percentWidth )

Change percent width of owner.

Parameters

percentWidth Percent Width in float.

bool isPercentHeightEnabled ( ) const

Query whether percent height is enabled or not.

Returns: True if percent height is enabled, false otherwise.

void setPercentHeightEnabled ( bool isUsed )

Toggle enable percent height.

Parameters

isUsed True if percent height is enabled, false otherwise.

float getSizeHeight ( ) const

Query size height of owner.

Returns: Size height in float.

void setSizeHeight ( float height )

Change size height of owner.

Parameters

height Size height in float.

float getPercentHeight ( ) const

Query percent height of owner.

Returns: Percent height in float.

void setPercentHeight ( float percentHeight )

Change percent height value of owner.

Parameters

percentHeight Percent height in float.

bool isStretchWidthEnabled ( ) const

Query whether stretch width is enabled or not.

Returns: True if stretch width is enabled, false otherwise.

void setStretchWidthEnabled ( bool isUsed )

Toggle enable stretch width.

Parameters

isUsed True if enable stretch width, false otherwise.

bool isStretchHeightEnabled ( ) const

Query whether stretch height is enabled or not.

Returns: True if stretch height is enabled, false otherwise.

void setStretchHeightEnabled ( bool isUsed )

Toggle enable stretch height.

Parameters

isUsed True if stretch height is enabled, false otherwise.

void setPercentOnlyEnabled ( bool enable )

Toggle enable percent only.

Parameters

enable True if percent only is enabled, false otherwise.

void setActiveEnabled ( bool enable )

Toggle active enabled of LayoutComponent's owner.

Parameters

enable True if active layout component, false otherwise.

The documentation for this class was generated from the following file:

UILayoutComponent.h

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation