UIQ Technology
Symbian OS Library

UIQ 3.1 SDK        UIQ developer portal

[Index] [Spacer] [Previous] [Next]



Location: EIKALIGN.H
Link against: eikcoctl.lib

Class CEikAlignedControl

class CEikAlignedControl : public CCoeControl, public MEikAlignedControl;

Description

Base class for aligned controls.

The CEikAlignedControl class extends the CCoeControl class in order to support extra functionality such as control alignment and margins.

It is only intended as a simple starting point for controls.

Derivation

Members

Defined in CEikAlignedControl:
ActivateL(), Alignment(), CEikAlignedControl(), ComponentControl(), ConstructFromResourceL(), CountComponentControls(), FocusChanged(), GetColorUseListL(), GetHelpContext(), HandleControlArrayEventL(), HandlePointerBufferReadyL(), HandlePointerEventL(), HandleResourceChange(), HasBorder(), InputCapabilities(), MakeVisible(), Margins(), MinimumSize(), MopSupplyObject(), OfferKeyEventL(), PositionChanged(), PrepareForFocusGainL(), PrepareForFocusLossL(), RequestRelayout(), SetAdjacent(), SetAlignment(), SetAllMarginsTo(), SetContainerWindowL(), SetDimmed(), SetLayoutManagerL(), SetNeighbor(), SetParent(), SetTextBaselineSpacing(), SizeChanged(), TextBaselineOffset(), WriteInternalStateL(), iAlignment, iMargin, ~CEikAlignedControl()

Inherited from CBase:
Delete(), Extension_(), operator new()

Inherited from CCoeControl:
AccumulatedZoom(), ActivateGc(), BackedUpWindow(), Background(), CapturesPointer(), ClaimPointerGrab(), CloseWindow(), ComponentArrayExists(), Components(), ControlContext(), ControlEnv(), CopyControlContextFrom(), CreateBackedUpWindowL(), CreateWindowL(), DeactivateGc(), Draw(), DrawBackground(), DrawDeferred(), DrawForeground(), DrawNow(), DrawableWindow(), EAbsoluteZoom, ERelativeZoom, EnableDragEvents(), FindBackground(), FindFontProvider(), GetColor(), GetGc(), GetTextDrawer(), GrabbingComponent(), HandleComponentControlsResourceChange(), HandleRedrawEvent(), HitTest(), IgnoreEventsUntilNextPointerUp(), Index(), InitComponentArrayL(), IsActivated(), IsBackedUp(), IsBeingDestroyed(), IsBlank(), IsDimmed(), IsFocused(), IsNonFocusing(), IsReadyToDraw(), IsVisible(), LayoutManager(), MaximumWidth(), MopNext(), Observer(), OverrideColorL(), OwnsWindow(), Parent(), Position(), PositionRelativeToScreen(), Rect(), RecursivelyMergedInputCapabilities(), ReportEventL(), Reserved_2(), ResetGc(), ScreenFont(), SetAllowStrayPointers(), SetBackground(), SetBlank(), SetCanDrawOutsideRect(), SetComponentsToInheritVisibility(), SetControlContext(), SetCornerAndSize(), SetExtent(), SetExtentToWholeScreen(), SetFocus(), SetFocusing(), SetFontProviderL(), SetGc(), SetGloballyCapturing(), SetHitTest(), SetMaximumWidth(), SetMopParent(), SetNonFocusing(), SetObserver(), SetPointerCapture(), SetPosition(), SetRect(), SetSize(), SetSizeWithoutNotification(), SetUniqueHandle(), SetZoomFactorL(), Size(), SystemGc(), TZoomType, TextDrawer(), UniqueHandle(), Window(), ZoomWithType(), iCoeEnv, iContext, iPosition, iSize

Inherited from MEikAlignedControl:
ETypeId, anonymous

Inherited from MObjectProvider:
MObjectProvider_Reserved1(), MObjectProvider_Reserved2(), MopGetObject(), MopGetObjectNoChaining()


Construction and destruction


CEikAlignedControl()

IMPORT_C CEikAlignedControl();

Description

Default constructor.


~CEikAlignedControl()

IMPORT_C ~CEikAlignedControl();

Description

Destructor.

[Top]


Member functions


MopSupplyObject()

virtual IMPORT_C TTypeUid::Ptr MopSupplyObject(TTypeUid aId);

Description

Gets an object whose type is encapsulated by the specified TTypeUid object.

Parameters

TTypeUid aId

Encapsulates the Uid that identifies the type of object required.

Return value

TTypeUid::Ptr

Encapsulates the pointer to the object provided. Note that the encapsulated pointer may be NULL.


SetAllMarginsTo()

virtual IMPORT_C void SetAllMarginsTo(TInt aValue);

Description

Sets all margins.

Parameters

TInt aValue


SetAlignment()

virtual IMPORT_C void SetAlignment(TGulAlignmentValue aAlign);

Description

Sets control alignment.

Parameters

TGulAlignmentValue aAlign


Margins()

virtual IMPORT_C TMargins8 &Margins();

Description

Return value

TMargins8 &


Alignment()

virtual IMPORT_C TGulAlignment &Alignment();

Description

Return value

TGulAlignment &


WriteInternalStateL()

protected: virtual IMPORT_C void WriteInternalStateL(RWriteStream &aWriteStream) const;

Description

Writes the internal state of the control and its components to aStream. Does nothing in release mode. Designed to be overidden and base called by subclasses.

Parameters

RWriteStream &aWriteStream


OfferKeyEventL()

virtual IMPORT_C TKeyResponse OfferKeyEventL(const TKeyEvent &aKeyEvent, TEventCode aType);

Description

Handles key events. From CCoeControl .

Parameters

const TKeyEvent &aKeyEvent

The key event.

TEventCode aType

The type of key event: EEventKey, EEventKeyUp or EEventKeyDown.

Return value

TKeyResponse

Indicates whether or not the key event was used by this control.

See also:


MakeVisible()

virtual IMPORT_C void MakeVisible(TBool aVisible);

Description

Sets this control as visible or invisible. From CCoeControl .

Parameters

TBool aVisible

ETrue to make the control visible, EFalse to make it invisible.

See also:


SetDimmed()

virtual IMPORT_C void SetDimmed(TBool aDimmed);

Description

Sets the control to be dimmed. From CCoeControl .

Parameters

TBool aDimmed

ETrue to dim the control, EFalse to set the control as not dimmed.

See also:


SetContainerWindowL()

virtual IMPORT_C void SetContainerWindowL(const CCoeControl &aContainer);

Description

Sets the control's containing window by copying it from aContainer. From CCoeControl .

Parameters

const CCoeControl &aContainer

The compound control that is the container for this control

See also:


ConstructFromResourceL()

virtual IMPORT_C void ConstructFromResourceL(TResourceReader &aReader);

Description

Constructs the control from a resource file. From CCoeControl .

Parameters

TResourceReader &aReader

The resource reader to use.

See also:


ActivateL()

virtual IMPORT_C void ActivateL();

Description

Sets the control as ready to be drawn. From CCoeControl .

See also:


PrepareForFocusLossL()

virtual IMPORT_C void PrepareForFocusLossL();

Description

Prepares the control for loss of focus. From CCoeControl .

See also:


PrepareForFocusGainL()

virtual IMPORT_C void PrepareForFocusGainL();

Description

Prepares the control for gaining focus. From CCoeControl .

See also:


SetAdjacent()

virtual IMPORT_C void SetAdjacent(TInt aAdjacent);

Description

Sets the control's appearance when it is next to other controls. From CCoeControl .

Parameters

TInt aAdjacent

Typically a value defined in TGulAdjacent.

See also:


SetNeighbor()

virtual IMPORT_C void SetNeighbor(CCoeControl *aNeighbor);

Description

Sets an associated control. From CCoeControl .

Parameters

CCoeControl *aNeighbor

A control to be used by this function.

See also:


HasBorder()

virtual IMPORT_C TBool HasBorder() const;

Description

Tests if the control has a border. From CCoeControl .

Return value

TBool

ETrue if the control has a border, EFalse if the control does not have a border. The default implementation of this function returns EFalse.

See also:


MinimumSize()

virtual IMPORT_C TSize MinimumSize();

Description

Gets the control's minimum required size. From CCoeControl .

Return value

TSize

The minimum size required by the control.

See also:


HandleResourceChange()

virtual IMPORT_C void HandleResourceChange(TInt aType);

Description

Handles a change to the control's resources. From CCoeControl .

Parameters

TInt aType

The type of resource that has changed.

See also:


GetColorUseListL()

virtual IMPORT_C void GetColorUseListL(CArrayFix< TCoeColorUse > &aColorUseList) const;

Description

Gets the list of logical colours used to draw the control. From CCoeControl .

Parameters

CArrayFix< TCoeColorUse > &aColorUseList

The colour list.

See also:


GetHelpContext()

virtual IMPORT_C void GetHelpContext(TCoeHelpContext &aContext) const;

Description

Gets the control's help context. From CCoeControl .

Parameters

TCoeHelpContext &aContext

The control's help context

See also:


InputCapabilities()

virtual IMPORT_C TCoeInputCapabilities InputCapabilities() const;

Description

Gets the control's input capabilities. From CCoeControl .

Return value

TCoeInputCapabilities

The control's input capabilities.

See also:


SetParent()

virtual IMPORT_C TInt SetParent(CCoeControl *aParent);

Description

Sets aParent as the parent of this control. From CCoeControl .

Parameters

CCoeControl *aParent

The control to set as this control's parent.

Return value

TInt

KErrNone if successful, otherwise another of the system error codes.

See also:


SetLayoutManagerL()

virtual IMPORT_C void SetLayoutManagerL(MCoeLayoutManager *aLayout);

Description

Sets the layout manager From CCoeControl .

Parameters

MCoeLayoutManager *aLayout

The new layout manager, NULL if you just want to remove the current layout manager.

See also:


RequestRelayout()

virtual IMPORT_C TBool RequestRelayout(const CCoeControl *aChildControl);

Description

Requests a relayout. From CCoeControl .

Parameters

const CCoeControl *aChildControl

The child control that requests the relayout, might be NULL.

Return value

TBool

ETrue if the request is addressed, otherwise EFalse

See also:


TextBaselineOffset()

virtual IMPORT_C TInt TextBaselineOffset(const TSize &aSize) const;

Description

Gets the offset to the first text baseline relative to the top of the control. From CCoeControl .

Parameters

const TSize &aSize

The offset of the baseline may depend on the size of the control. This argument specifies the size to use when computing the baseline offset.

Return value

TInt

The offset of the baseline from the top of the control.

See also:


SetTextBaselineSpacing()

virtual IMPORT_C void SetTextBaselineSpacing(TInt aSpacing);

Description

Sets the spacing between text baselines. From CCoeControl .

Parameters

TInt aSpacing

The baseline spacing i.e. the space in pixels between the text baselines.

See also:


HandlePointerEventL()

virtual IMPORT_C void HandlePointerEventL(const TPointerEvent &aPointerEvent);

Description

Handles pointer events. From CCoeControl .

Parameters

const TPointerEvent &aPointerEvent

The pointer event.

See also:


CountComponentControls()

virtual IMPORT_C TInt CountComponentControls() const;

Description

Gets the number of controls contained in a compound control. From CCoeControl .

Return value

TInt

The number of component controls contained by this control.

See also:


ComponentControl()

virtual IMPORT_C CCoeControl *ComponentControl(TInt aIndex) const;

Description

Gets an indexed component of a compound control. From CCoeControl .

Parameters

TInt aIndex

The index of the control.

Return value

CCoeControl *

The component control with an index of aIndex.

See also:


HandlePointerBufferReadyL()

protected: virtual IMPORT_C void HandlePointerBufferReadyL();

Description

Handles pointer buffer ready events. From CCoeControl .

See also:


FocusChanged()

protected: virtual IMPORT_C void FocusChanged(TDrawNow aDrawNow);

Description

Responds to a change in focus. From CCoeControl .

Parameters

TDrawNow aDrawNow

Contains the value that was passed to it by SetFocus().

See also:


SizeChanged()

protected: virtual IMPORT_C void SizeChanged();

Description

Responds to changes to the size and position of the contents of this control. From CCoeControl .

See also:


PositionChanged()

protected: virtual IMPORT_C void PositionChanged();

Description

Responds to changes in the position of a control. From CCoeControl .

See also:


HandleControlArrayEventL()

protected: virtual IMPORT_C void HandleControlArrayEventL(CCoeControlArray::TEvent aEvent, const CCoeControlArray *aArray, CCoeControl *aControl, TInt aControlId);

Description

Handles events generated by the CCoeControlArray. From CCoeControl .

Parameters

CCoeControlArray::TEvent aEvent

The type of the event

const CCoeControlArray *aArray

The array that generated the event

CCoeControl *aControl

The control affected by the event

TInt aControlId

The id of the control affected by the event

See also:

[Top]


Member data


iMargin

TMargins8 iMargin;

Description


iAlignment

TGulAlignment iAlignment;

Description