Location:
gulalign.h
Link against: egul.lib
class TGulAlignment;
Provides a convenient way to describe horizontal and vertical layouts of rectangular objects and to enquire how they occupy an area given their alignment.
Defined in TGulAlignment
:
HAlignment()
, HAlignment()
, HasAbsoluteHAlignment()
, InnerRect()
, InnerRect()
, InnerTopLeft()
, InnerTopLeft()
, ParaAlign()
, SetAbsoluteHAlignment()
, SetHAlignment()
, SetHAlignment()
, SetHAlignment()
, SetVAlignment()
, TGulAlignment()
, TGulAlignment()
, TGulAlignment()
, TextAlign()
, TextAlign()
, VAlignment()
, operator TGulAlignmentValue()
inline TGulAlignment(TGulAlignmentValue aValue);
Constructor initialising the object with an alignment value.
|
inline TGulAlignment(CGraphicsContext::TTextAlign aHAlign, TGulVAlignment aVAlign=EVTop);
Constructor initialising the object with an alignment value.
|
IMPORT_C operator TGulAlignmentValue() const;
Gets the (absolute) alignment value as TGulAlignmentValue
.
Note that this has the absolute horizontal alignment. I.e. left and right horizontal alignment will not be swapped depending on language directionality.
|
inline TGulVAlignment VAlignment() const;
Gets the vertical alignment.
|
inline TGulHAlignment HAlignment() const;
Gets the absolute horizontal alignment.
Note that this is the alignment in absolute terms. I.e. left and right alignment will not be swapped depending on language directionality.
|
IMPORT_C TGulHAlignment HAlignment(TBidiText::TDirectionality aLanguageDirectionality) const;
Return the horizontal alignment, relative to the language directionality specified. Calling this method will return a horizontal
alignment where left and right has been swapped for any language with RightToLeft directionality, UNLESS the alignment has
been set as being absolute, by calling SetAbsoluteHAlignment()
.
|
|
IMPORT_C TBool HasAbsoluteHAlignment() const;
Return whether horizontal alignment will be treated as an absolute value, or relative the specified language directionality.
In the latter case, left and right will be swapped (by TGulAlignment
methods for which a TBidiText::TDirectionality
is provided) for languages with RightToLeft directionality.
|
IMPORT_C void SetAbsoluteHAlignment(TBool aAbsoluteHAlignment);
Set the current horizontal alignment to be used as an absolute value. If set to true, this means that the alignment will NOT
be swapped depending on language directionality when calling e.g. HAlignment(TBidiText::TDirectionality)
.
Note that the default is false (i.e. relative alignment), and calling any of the setters on the TGulAlignment
object will reset it to relative alignment (i.e. always call this method after the horizontal alignment has been set).
Also note that support for absolute horizontal alignment was added to TGulAlignment late in Symbian OS release 9.1. Hence if this method is called on an object that is passed to a client compiled against an earlier release (or if the client does not yet support absolute alignment) then the resulting alignment may be incorrect.
|
inline CGraphicsContext::TTextAlign TextAlign() const;
Gets the absolute horizontal text alignment.
Note that this is the alignment in absolute terms. I.e. left and right alignment will not be swapped depending on language directionality.
|
IMPORT_C CGraphicsContext::TTextAlign TextAlign(TBidiText::TDirectionality aLanguageDirectionality) const;
Return the horizontal alignment, relative to the language directionality specified. Calling this method will return a horizontal
alignment where left and right has been swapped for any language with RightToLeft directionality, UNLESS the alignment has
been set as being absolute, by calling SetAbsoluteHAlignment()
.
|
|
IMPORT_C CParaFormat::TAlignment ParaAlign() const;
Return the horizontal alignment as a CParaFormat::TAlignment
object. Note that the CParaFormat::TAlignment
class supports the concept of horizontal absolute alignment, so left and right alignment will not be swapped.
|
IMPORT_C void SetVAlignment(TGulVAlignment aVAlign);
Sets the vertical alignment.
|
IMPORT_C void SetHAlignment(TGulHAlignment aHAlign);
Sets the horizontal alignment. Alignment will be reset to relative. I.e. when calling HAlignment()
with a TBidiText::ERightToLeft
argument, left and right will be swapped. Calling HAlignment()
without argument will always return the alignment in absolute terms.
|
IMPORT_C void SetHAlignment(CGraphicsContext::TTextAlign aHAlign);
Sets the horizontal alignment. Alignment will be reset to relative. I.e. when calling HAlignment()
with a TBidiText::ERightToLeft
argument, left and right will be swapped. Calling HAlignment()
without argument will always return the alignment in absolute terms.
|
IMPORT_C void SetHAlignment(CParaFormat::TAlignment aHAlign);
Sets the horizontal alignment. Alignment will be set to absolute for EAbsoluteLeftAlign
and EAbsoluteRightAlign
, otherwise relative the language directionality (if specified).
|
IMPORT_C TPoint InnerTopLeft(const TRect &aOuter, const TSize &aInnerSize) const;
Gets the co-ordinates of the top left corner of an object of size aInnerSize
, which is placed in the area of the rectangle aOuter
according to the current alignment.
Note that horizontal alignment is always treated as being in absolute terms.
|
|
IMPORT_C TPoint InnerTopLeft(const TRect &aOuter, const TSize &aInnerSize, TBidiText::TDirectionality aLanguageDirectionality)
const;
Gets the co-ordinates of the top left corner of an object of size aInnerSize
, which is placed in the area of the rectangle aOuter
according to the current alignment.
Note that if RightToLeft language directionality is specified, left and right horizontal alignment for the inner object will be swapped.
|
|
IMPORT_C TRect InnerRect(const TRect &aOuter, const TSize &aInnerSize) const;
Gets the rectangle occupied by an object of size aInnerSize
, which is placed in the area of the rectangle aOuter
according to the current alignment.
Note that horizontal alignment is always treated as being in absolute terms.
|
|
IMPORT_C TRect InnerRect(const TRect &aOuter, const TSize &aInnerSize, TBidiText::TDirectionality aLanguageDirectionality)
const;
Gets the rectangle occupied by an object of size aInnerSize
, which is placed in the area of the rectangle aOuter
according to the current alignment.
Note that if RightToLeft language directionality is specified, left and right horizontal alignment for the inner object will be swapped.
|
|