CGUILayouterAlignToParent Class Reference

This layouter aligns an object to its parent. More...

#include <GUILayouterAlignToParent.h>

Inheritance diagram for CGUILayouterAlignToParent:

Public Types
enum	HorizontalAlignment_t { ALIGN_H_LEFT = 1 , ALIGN_H_CENTER = 2 , ALIGN_H_RIGHT = 3 , ALIGN_H_NONE = 4 }
	Enumeration for the horizontal alignment.
enum	VerticalAlignment_t { ALIGN_V_TOP = 1 , ALIGN_V_CENTER = 2 , ALIGN_V_BOTTOM = 3 , ALIGN_V_NONE = 4 }
	Enumeration for the vertical alignment.
Public Types inherited from CGUILayouter
enum	eMovedEdges_t {   CHANGED_WIDTH , CHANGED_HEIGHT , CHANGED_RELXPOS , CHANGED_RELYPOS ,   CHANGED_EDGE_ALL }
	Enumerate possible reasons for calling layout,. More...

Public Member Functions
	CGUILayouterAlignToParent (CGUIObject *const pkObject=NULL)
	~CGUILayouterAlignToParent ()
	Destructs an AlignToParent-Layouter.
virtual void	DoLayout (eMovedEdges_t eMovedEdges)
void	InitLayouter (eMovedEdges_t eMovedEdges)
virtual eC_Bool	IsDependentOnParentSize ()
virtual void	ReadFromStream ()
void	SetAlignment (const HorizontalAlignment_t &eHorizontalAlignment, const VerticalAlignment_t &eVerticalAlignment)
virtual void	WriteToStream (const eC_Bool bWriteClassID=false)
Public Member Functions inherited from CGUILayouter
virtual	~CGUILayouter ()
	Destructor. More...
virtual void	DoLayout (eMovedEdges_t eMovedEdges)=0
CGUIObject *	GetAssociatedObject () const
virtual void	InitLayouter (eMovedEdges_t eMovedEdges)
virtual eC_Bool	IsDependentOnParentSize ()=0
virtual eC_Bool	IsGroupLayouter () const
virtual void	SetAssociatedObject (CGUIObject *const pkObject)
Public Member Functions inherited from CGUIStreamableObject
const eC_String &	GetXMLTag () const
virtual void	ReadFromStream ()
void	SetXMLTag (const eC_String &kXMLTag)
virtual void	WriteToStream (const eC_Bool bWriteClassID=false)

Static Public Attributes
static const eC_UInt	LAYOUTER_ALIGN_TO_PARENT_CLASS_VERSION
	Class version of align-to-parent layouter class.
Static Public Attributes inherited from CGUILayouter
static const eC_Char	XMLTAG_LAYOUTERCLASSID []
	XML tag to be used when writing a layouter class ID into a stream.
Static Public Attributes inherited from CGUIStreamableObject
static const eC_Char	XMLTAG_CLASSVERSION []

Additional Inherited Members
Protected Member Functions inherited from CGUILayouter
	CGUILayouter (CGUIObject *const pkObject=NULL)
Protected Member Functions inherited from CGUIStreamableObject
eC_UInt	ReadStreamingHeader (const eC_UInt &uiClassVersion, const eC_UInt &uiClassMinVersion=0) const
void	WriteStreamingFooter (const eC_Bool &bWriteClassID) const
void	WriteStreamingHeader (const eC_Bool &bWriteClassID, const eC_Char *const pkClassIDTag, const eC_Int &iClassID, const eC_UInt &uiClassVersion) const

Detailed Description

This layouter aligns an object to its parent.

Note

The Layouter is only triggered to refresh the layout when the size or the position of the associated object is changed. Changing the size of the parent will not trigger a refresh of the layout.

The typical usage of a layouter is as follows:

1. Instantiate the layouter.
2. Set the alignment as required.
3. Finally, attach it to an object. The object will automatically gain ownership of the layouter and delete it upon its own destruction. (Note that there is always a One on One relationship between objects and layouters.)

   CGUILayouterAlignToParent* pLayouter = new CGUILayouterAlignToParent();
   pLayouter->SetAlignment(CGUILayouterAlignToParent::ALIGN_H_CENTER, CGUILayouterAlignToParent::ALIGN_V_CENTER);
   pkObject->SetLayouter(pLayouter);

Constructor & Destructor Documentation

CGUILayouterAlignToParent()

CGUILayouterAlignToParent::CGUILayouterAlignToParent

(

CGUIObject *const

pkObject = NULL

)

Constructs an AlignToParent-Layouter.

Parameters

pkObject

Pointer to the object to which the layouter is attached.

Member Function Documentation

DoLayout()

virtual void CGUILayouterAlignToParent::DoLayout ( eMovedEdges_t  eMovedEdges )

virtual

Called when the size of the parent of the associated object has changed.

This method must be re-implemented in derived classes to perform the actual layout change, typically adjustments to the associated object's dimension or position.

It is called by the framework every time the width or height of the parent of the associated object has changed. The framework first calls DoLayout() on the associated object itself and then on all children of the associated object in any depth in the hierarchy.

There are two valid types of layouters: Either: Implementations of DoLayout() shall only adjust the associated object and/or direct children of it. No other decendants of the associated object shall be changed in position or size! This is called a group layouter. CGUILayouterReposition and CGUILayouterGrid are examples of group layouters. Or: Implementations of DoLayout() shall only adjust the associated object depending on the layout of its parent object. No other objects shall be changed in position or size! This is called a child layouter. CGUILayouterAnchor is an example of a child layouter.

Implementing other types of layouters may compromise the framework architecture.

The two use cases may overlap: If a direct child of a group layouter composite object has a child layouter then while streaming in the composite object associated with the group layouter, the composite will first call DoLayout() on its layouter and then call InitLayouter() on the layouters of all direct children of that composite object. Therefore, the group layouter will re-initialize the child layouter. For an anchor layouter this implies that the child layouter will have no effect and should be removed. Still the child layouter's DoLayout() will be called after the parent layouter's DoLayout() later on for any change of the size of the parent so that the child layouter might change (override) the layouting of the group layouter concerning its child layout, for example if using hardcoded values for anchor distances.

Parameters

eMovedEdges

Reason for layouter call

Implements CGUILayouter.

InitLayouter()

void CGUILayouterAlignToParent::InitLayouter ( eMovedEdges_t  eMovedEdges )

inlinevirtual

This function is called when relative positions of the associated object are changed.

Parameters

eMovedEdges

Reimplemented from CGUILayouter.

IsDependentOnParentSize()

virtual eC_Bool CGUILayouterAlignToParent::IsDependentOnParentSize ( )

inlinevirtual

This function shall determine if the layouter shall initially be called due to resizing the parent of the associated object or if it shall initially be called by resizing the associated object. If it returns false the framework will call DoLayout() on this layouter of the object that is triggering the layout procedure, that is, the composite object on which the first (in the current call stack) SetWidth() or SetHeight() is called.

Returning false is the typical use case for a group layouter that does not consider the layout of the parent of the associated object. In this case the initially resized object starting the layout procedure is the 'group object' itself, therefore you can say changing the 'group object' starts the layout procedure in this case.

If it returns true, the first DoLayout() is called on a child of the initially resized object. This is the typical use case for a child layouter or a group layouter that is considering the layout of 'its' parent. Therefore, you can say changing the parent is starting the layout procedure in this case.

Returns

eC_Bool True if dependend, False otherwise

Implements CGUILayouter.

ReadFromStream()

virtual void CGUILayouterAlignToParent::ReadFromStream ( )

virtual

Reads attributes from the streaming file. Only for use with GUIFactoryManager.

See also

CGUIObject::ReadFromStream()

Reimplemented from CGUIStreamableObject.

SetAlignment()

void CGUILayouterAlignToParent::SetAlignment	(	const HorizontalAlignment_t &	eHorizontalAlignment,
		const VerticalAlignment_t &	eVerticalAlignment
	)

Set the horizontal alignment and the vertical alignment. Note: This will not directly refresh the layout. Call DoLayout to refresh the layout.

Parameters

eHorizontalAlignment	The horizontal alignment.
eVerticalAlignment	The vertical alignment.

WriteToStream()

virtual void CGUILayouterAlignToParent::WriteToStream ( const eC_Bool  bWriteClassID = false )

virtual

Writes attributes to the streaming file. A CGUIStreamWriter has to be initialized.

Parameters

bWriteClassID

This flag is used to switch writing of the class ID, leading and trailing tags. When implementing a new streamable object, check this flag. If it is true, first write the class ID, then continue with this object's attributes, and finally call the base class implementation with this flag set to false (this is the default).

Reimplemented from CGUIStreamableObject.

---

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

• GUILayouterAlignToParent.h