Class CQikTTimeEditor

class CQikTTimeEditor : public CEikBorderedControl;

Description

This class provides methods and members for time and date handling. The base class for time, date, time/date and duration editors. it's inherited by QikTimeEditor , by QikDateEditor , by QikTimeAndDateEditor and by QikDurationEditor .

This class is not intended for user derivation.

Derivation

• MEikBorderedControl - Interface for bordered controls
• MObjectProvider - An interface that allows an object to be part of a network of object providers
• CBase - Base class for all classes to be instantiated on the heap
• CCoeControl - Control base class from which all other controls are derived
• CEikBorderedControl - A control which is drawn surrounded by a rectangular border
• CQikTTimeEditor - This class provides methods and members for time and date handling

Members

Defined in CQikTTimeEditor:
ConstructL(), Draw(), DrawContent(), EDisableWrapTime, EFiveMinuteSteps, EForce24HourFormat, EMirroredLayout, EWithoutPopoutCalendar, EWithoutPopoutPicker, Font(), GetColorUseListL(), GetMinimumAndMaximum(), HandleResourceChange(), MinimumSize(), SetMinimumAndMaximum(), SetTimeL(), SetWrapTime(), Time(), anonymous, iDateString, iTimeString, ~CQikTTimeEditor()

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

Inherited from CCoeControl:
AccumulatedZoom(), ActivateGc(), BackedUpWindow(), Background(), CapturesPointer(), ClaimPointerGrab(), CloseWindow(), Components(), ControlContext(), ControlEnv(), CopyControlContextFrom(), CreateBackedUpWindowL(), CreateWindowL(), DeactivateGc(), DrawBackground(), DrawDeferred(), DrawForeground(), DrawNow(), DrawableWindow(), EAbsoluteZoom, ERelativeZoom, EnableDragEvents(), FindBackground(), FindFontProvider(), GetColor(), GetGc(), GrabbingComponent(), HandleComponentControlsResourceChange(), HandleRedrawEvent(), HitTest(), IgnoreEventsUntilNextPointerUp(), Index(), InitComponentArrayL(), IsActivated(), IsBackedUp(), IsBeingDestroyed(), IsBlank(), IsDimmed(), IsFocused(), IsNonFocusing(), IsReadyToDraw(), IsVisible(), LayoutManager(), MaximumWidth(), Observer(), OverrideColorL(), OwnsWindow(), Parent(), Position(), PositionRelativeToScreen(), Rect(), RecursivelyMergedInputCapabilities(), ReportEventL(), Reserved_CCoeControl_10(), Reserved_CCoeControl_11(), Reserved_CCoeControl_12(), Reserved_CCoeControl_13(), 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 CEikBorderedControl:
ActivateL(), Border(), ComponentControl(), ConstructFromResourceL(), CountComponentControls(), FocusChanged(), GetHelpContext(), HandleControlArrayEventL(), HandlePointerBufferReadyL(), HandlePointerEventL(), HasBorder(), InputCapabilities(), MakeVisible(), MopSupplyObject(), OfferKeyEventL(), PositionChanged(), PrepareForFocusGainL(), PrepareForFocusLossL(), RequestRelayout(), SetAdjacent(), SetBorder(), SetContainerWindowL(), SetDimmed(), SetLayoutManagerL(), SetNeighbor(), SetParent(), SetTextBaselineSpacing(), SizeChanged(), TextBaselineOffset(), WriteInternalStateL(), iBorder

Inherited from MEikBorderedControl:
ETypeId

Inherited from MObjectProvider:
MopGetObject(), MopGetObjectNoChaining()

See also:

• CQikTimeEditor
• CQikDateEditor
• CQikTimeAndDateEditor
• CQikDurationEditor

virtual ~CQikTTimeEditor();

Description

Default constructor.

This function constructs an uninitialised CQikTTimeEditor . It is the first stage in two stage construction. ConstructL() should be called to initialise the editor's maximum and minimum values, initial value and flags.

IMPORT_C void ConstructL(const TTime &aMinimumTime, const TTime &aMaximumTime, const TTime &aInitialTime, TUint32 aFlags);

Description

Second phase construction.

The function completes the construction of a newly-allocated time/date/duration editor (CQikTTimeEditor ), by setting its minimum, maximum and initial values. The AM/PM settings and time separator characters specified in class TLocale are honoured. The function should be called by the container, in derived classes, only if the control is not constructed from a resource file.

The aFlags parameter enables sub-classes to enforce certain behaviour. Possible flags are given in this classes’ anonymous enum.

The function does not check that the initial time is between the maximum and minimum values, and it does not check that the maximum time is greater than the minimum time.

The function sets the default behaviour to wrap the time.

Parameters

const TTime &aMinimumTime Minimum time allowed for this control. const TTime &aMaximumTime Maximum time allowed for this control. const TTime &aInitialTime Time stored by the control at the start. TUint32 aFlags Enable sub-classes to enforce certain behaviour, see enum below.

See also:

• CQikTTimeEditor()

IMPORT_C void SetMinimumAndMaximum(const TTime &aMinimumTime, const TTime &aMaximumTime);

Description

Set minimum and maximum time values allowed for this control. The editor will not allow users to enter values outside these bounds.

Parameters

const TTime &aMinimumTime Minimum time allowed for this control. const TTime &aMaximumTime Maximum time allowed for this control.

See also:

• GetMinimumAndMaximum()

IMPORT_C void GetMinimumAndMaximum(TTime &aMinimumTime, TTime &aMaximumTime) const;

Description

Get the minimum and maximum time values allowed for this control. The editor will not allow users to enter values outside these bounds.

Parameters

TTime &aMinimumTime The minimum allowed editor value. TTime &aMaximumTime The maximum allowed editor value.

See also:

• SetMinimumAndMaximum()

IMPORT_C void SetTimeL(const TTime &aTime);

Description

Set the time stored in this control.

Parameters

const TTime &aTime The new time value.

See also:

• Time()

IMPORT_C TTime Time() const;

Description

Gets the time actually stored in this control.

Return value

TTime A TTime object containing the time.

See also:

• SetTimeL()

IMPORT_C const CFont *Font() const;

Description

Gets the font used to draw editor text. This is used by the framework to establish the minimum size of the control.

Return value

const CFont * A pointer to the font used.

See also:

• SetFont()

IMPORT_C void SetWrapTime(TBool aWrap);

Description

Sets if the time shall wrap when it comes to its maimum/minimum values.

Parameters

TBool aWrap ETrue sets wrapping, EFalse disables wrapping

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

Description

Gets the list of logical colors used to draw the control. Pairs the colors with an explanation of how they are used and appends this information to aColorUseList .

Parameters

CArrayFix< TCoeColorUse > &aColorUseList The list of logical colors.

See also:

• CCoeControl::GetColorUseListL()

virtual IMPORT_C void HandleResourceChange(TInt aType);

Description

Handles a change to the control's resources which are shared across the environment; colors or fonts for example.

Parameters

TInt aType The type of resource that has changed.

See also:

• CCoeControl::HandleResourceChange()

virtual IMPORT_C TSize MinimumSize();

Description

Gets the minimum size of the control.

Return value

TSize A Tsize object defining the minimum size.

See also:

• CCoeControl::MinimumSize()

protected: virtual IMPORT_C void Draw(const TRect &aRect) const;

Description

Draws the control's border.

Parameters

const TRect &aRect The area to redraw.

See also:

• CCoeControl::Draw()

protected: virtual void DrawContent(CWindowGc &aGc, const TRect &aRect) const=0;

Description

Parameters

CWindowGc &aGc const TRect &aRect

n/a

Description

Time/date/duration editor flags. There are equivalent flags for use in resources.

See also:

• EQikDateWithoutPopoutCalendar

EWithoutPopoutCalendar Date editor without a popout calendar. EWithoutPopoutPicker Editor without a popout time picker. EForce24HourFormat Forces 24 hour clock format, overriding the locale setting. EFiveMinuteSteps Sets picker value to change in 5 minute steps. EMirroredLayout Sets if the layout shall be mirrored EDisableWrapTime Sets if the time value shall NOT wrap round its max/min value

protected: TBuf< 20 > iTimeString;

Description

protected: TBuf< 50 > iDateString;

Description