Class CQikTimeEditor

class CQikTimeEditor : public CQikTTimeEditor, public MCoeControlObserver, public MQikCommandListOwner, public MQikCommandHandler;

Description

Time editor.

This editor displays a time. On a tap a Time Picker control is popped up — this can be used to select a new time.

12 and 24-hour format are supported. When 12-hour format is used, and am or pm field is displayed after the time. Locale information is used to determine the time separator and format. Locale information is set and retrieved using class 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 value. Flags can be passed to CQikTTimeEditor::ConstructL() to enforce 24 hour format, and to disable the Time Picker popout.

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

Derivation

• MQikCommandHandler - Interface for classes responsible of executing commands
• MQikCommandListOwner - Interface for classes adding commands
• 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
• CQikTimeEditor - Time editor

Members

Defined in CQikTimeEditor:
CQikTimeEditor(), ConstructFromResourceL(), GetColorUseListL(), HandleCommandL(), HandleControlEventL(), HandleResourceChange(), InputCapabilities(), MapCommandHandler(), MinimumSize(), OfferKeyEventL(), PrepareForFocusGainL(), PrepareForFocusLossL(), ~CQikTimeEditor()

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(), MakeVisible(), MopSupplyObject(), PositionChanged(), 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 MObjectProvider:
MopGetObject(), MopGetObjectNoChaining()

Inherited from MQikCommandHandler:
HandleAttemptDimmedSelectionL()

IMPORT_C CQikTimeEditor();

Description

Default constructor.

This function constructs an uninitialised CQikTimeEditor . 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()

IMPORT_C ~CQikTimeEditor();

Description

Default 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 file (.rss).

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

Parameters

TResourceReader &aResourceReader A pointer to the resource where to read from.

See also:

• CCoeControl::ConstructFromResourceL()

virtual IMPORT_C TSize MinimumSize();

Description

Gets the minimum size possible for this control.

Return value

TSize A TSize object containing the minimum size.

See also:

• CCoeControl::MinimumSize()

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

Description

Gets the list of logical colors employed in the drawing of the control, paired with an explanation of how they are used. Appends the list to aColorUseList.

Parameters

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

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, e.g. colors or fonts.

Parameters

TInt aType The type of resource that has changed.

See also:

• CCoeControl::HandleResourceChange()

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

Description

Handles key events.

Parameters

const TKeyEvent &aKeyEvent The key event. TEventCode aType The type of the event: EEventKeyDown, EEventKeyUp or EEventKey.

Return value

TKeyResponse A suitable response code.

virtual IMPORT_C void PrepareForFocusGainL();

Description

Notifier called upon before the control gains focus.

virtual IMPORT_C void PrepareForFocusLossL();

Description

Notifier called upon before the control loses focus.

virtual IMPORT_C MQikCommandHandler *MapCommandHandler(CQikCommand &aCommand);

Description

From MQikCommandListOwner

Parameters

CQikCommand &aCommand

Return value

MQikCommandHandler *

See also:

• MQikCommandListOwner::MapCommandHandler()

virtual IMPORT_C void HandleCommandL(CQikCommand &aCommand);

Description

From MQikCommandHandler

Parameters

CQikCommand &aCommand

See also:

• MQikCommandListOwner::HandleCommandL()

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.

Parameters

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

See also:

• MCoeControlObserver::HandleControlEventL()

protected: virtual IMPORT_C TCoeInputCapabilities InputCapabilities() const;

Description

Gets the editor's input capabilities.

This editor supports entry of numbers that are TCoeInputCapabilities::EWesternNumericIntegerNegative , or TCoeInputCapabilities::EWesternNumericIntegerPositive .

Return value

TCoeInputCapabilities The editor's input capabilities.

See also:

• CCoeControl::InputCapabilities()