Class CQikTimeAndDateEditor

class CQikTimeAndDateEditor : public CQikTTimeEditor, private MCoeControlObserver, private MEikCalendarObserver;

Description

Time and date editor.

This editor displays time and date. On a tap, either a calendar or time picker is displayed — these can be used to select a new time and date respectively.

The editor has a time editor with the same behaviour as CQikTimeEditor , followed by a date editor with the same behaviour as CQikDateEditor . Global locale information is used to determine the date's field order and the characters used to separate the date components, and whether 12 or 24 hour time format is used — see TLocale .

The base class CQikTTimeEditor provides the members for setting the maximum and minimum values that the user may enter into the editor, and for getting and setting the current editor values. Flags can be passed to CQikTTimeEditor::ConstructL() to enforce 24 hour time format, and to disable the time and calendar/date picker popouts. The editor may also be constructed from a resource.

This class is not intended for user derivation. The associated resource is QIK_TIME_AND_DATE_EDITOR .

Note:

• This class implements the MEikCalendarObserver interface. However its members are not exported, and hence do not form part of the public API.

Derivation

• MEikCalendarObserver - Calendar observer interface
• MCoeControlObserver - Interface for a control to send events to its observer control
• 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
• CQikTimeAndDateEditor - Time and date editor

Members

Defined in CQikTimeAndDateEditor:
CQikTimeAndDateEditor(), ConstructFromResourceL(), GetColorUseListL(), HandleControlEventL(), HandleResourceChange(), MinimumSize(), ~CQikTimeAndDateEditor()

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(), 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 CQikTTimeEditor:
ConstructL(), Draw(), DrawContent(), EDisableWrapTime, EFiveMinuteSteps, EForce24HourFormat, EMirroredLayout, EWithoutPopoutCalendar, EWithoutPopoutPicker, Font(), GetMinimumAndMaximum(), SetMinimumAndMaximum(), SetTimeL(), SetWrapTime(), Time(), anonymous, iDateString, iTimeString

Inherited from MCoeControlObserver:
EEventInteractionRefused, EEventPrepareFocusTransition, EEventRequestCancel, EEventRequestExit, EEventRequestFocus, EEventStateChanged, TCoeEvent

Inherited from MEikBorderedControl:
ETypeId

Inherited from MEikCalendarObserver:
GetMinimumAndMaximumAndInitialDatesForCalendarL(), SetDateFromCalendarAndDrawNow()

Inherited from MObjectProvider:
MopGetObject(), MopGetObjectNoChaining()

IMPORT_C CQikTimeAndDateEditor();

Description

Default constructor.

This function constructs an uninitialised CQikTimeAndDateEditor . It should be used as the first stage in two stage construction, followed by a call to either ConstructFromResourceL() (to initialise the editor's field values from a resource file) or CQikTTimeEditor::ConstructL() (if no resource file is used).

If ConstructL() is used, EQikTimeWithoutPopout and EQikTimeForce24HourFormat may be passed to the aFlags variable.

See also:

• ConstructFromResourceL()

virtual IMPORT_C ~CQikTimeAndDateEditor();

Description

Destructor. The destructor frees any resources owned by the editor, including the time picker popout, prior to its destruction.

virtual IMPORT_C void ConstructFromResourceL(TResourceReader &aResourceReader);

Description

Second phase construction from a resource.

This function completes the construction of a newly-allocated time and date editor from a QIK_TIME_AND_DATE_EDITOR resource. The minimum and maximum dates and times and the editor flags are read from the resource file (.rss), and CQikTTimeEditor::ConstructL() is called with these settings. The initial value of the editor is set to the maximum value.

Note:

• The resource defines “intervening text”, however this field is not used by the editor.

Parameters

TResourceReader &aResourceReader pointer to the resource file reader.

See also:

• CQikTimeAndDateEditor()

virtual IMPORT_C TSize MinimumSize();

Description

Gets the minimum size of the control.

Return value

TSize TSize The minimum size of the control.

See also:

• CCoeControl::MinimumSize()

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

See also:

• CCoeControl::GetColorUseListL()

virtual IMPORT_C void HandleResourceChange(TInt aType);

Description

Handles a change to the control's resources of type aType 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 void HandleControlEventL(CCoeControl *aControl, TCoeEvent aEventType);

Description

Handles control events. Inherited by CCoeControl . Defines the behaviour of this control in case of EEventRequestExit and EEventRequestCancel events.

The function gets events for the Time picker popout — it may or may not retrieve the time value (depending on whether the popout was cancelled) and then destroys popout.

Parameters

CCoeControl *aControl Pointer to a CCoeControl object sending the event. TCoeEvent aEventType The event type. Either EEventRequestExit or EEventRequestCancel .

See also:

• MCoeControlObserver::HandleControlEventL()
• .
• DestroyPopup()