Collapse all Symbian^3 Product Developer Library

CAknLocationEditor Class Reference

class CAknLocationEditor : public CEikMfne

Editor for TPosition type; latitude and longitude editor

There exists two ways to construct CAknLocationEditor:

 CAknLocationEditor *editor = CAknLocationEditor::NewL(pos, context);

Using resources:

 CAknLocationEditor *editor = new (ELeave) CAknLocationEditor
 TResourceReader reader;
 iCoeEnv->CreateResourceReaderLC(reader,R_RES_ID_FOR_EDITOR);
 editor->ConstructFromResourceL(reader);
 editor->Set(pos);
 CleanupStack::PopAndDestroy();

Resource file format is as follows:

     LATITUDE_EDITOR
        {
	      flags = ELocationEdFlagLatitude;
		  latlongresourceid = R_EIK_LATITUDE_AND_LONGITUDE;
        };

or:

      LONGITUDE_EDITOR
        {
		  flags = ELocationEdFlagLongitude;
		  latlongresourceid = R_EIK_LATITUDE_AND_LONGITUDE;
        };

eikctl.lib lbs.lib (for TPosition class)

Since: 3.2

TPosition

Inherits from

CAknLocationEditor
- CEikMfne
  - CEikBorderedControl
    - CAknControl
      - CCoeControl
        CBase

Public Member Functions
	CAknLocationEditor()
	~CAknLocationEditor()
IMPORT_C void	ConstructFromResourceL(TResourceReader &)
void	CreateMfneFieldsL(const TPosition &)
IMPORT_C HBufC *	DisplayableLocationL(const TPosition &, TLocationContext)
IMPORT_C void	Get(TPosition &)
void	HandleCenRepChangedL(TUint32, TInt)
IMPORT_C CAknLocationEditor *	NewL(TPosition &, TLocationContext)
IMPORT_C TKeyResponse	OfferKeyEventL(const TKeyEvent &, TEventCode)
IMPORT_C void	PrepareForFocusLossL()
IMPORT_C void	Set(const TPosition &)

Protected Member Functions
IMPORT_C void *	CAknLocationEditor_ExtensionInterface(TUid)

Private Member Functions
void	CombineDD(TPosition &, TLocationContext, TInt, TInt, TBool, TBool)
void	CombineDMM(TPosition &, TLocationContext, TInt, TInt, TInt, TBool, TBool)
void	CombineDMSD(TPosition &, TLocationContext, TInt, TInt, TInt, TInt, TBool, TBool)
void	ConstructL(TPosition &, TLocationContext)
TInt	FieldMapping(const TInt, const TLocationType)
void	LoadStringsL(TInt)
void	RefreshFromLocale()
void	SetUninitialised(TBool)
void	Split(const TPosition &, TLocationContext, TInt &, TInt &, TInt &, TInt &, TInt &, TInt &, TBool &, TBool &)
void	SplitDD(const TPosition &, TLocationContext, TInt &, TInt &, TBool &, TBool &)
void	SplitDMM(const TPosition &, TLocationContext, TInt &, TInt &, TInt &, TBool &, TBool &)
void	SplitDMSD(const TPosition &, TLocationContext, TInt &, TInt &, TInt &, TInt &, TBool &, TBool &)
TLocationType	Type()

Inherited Functions
	CAknControl::CAknControl()
	CAknControl::~CAknControl()
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()
	CCoeControl::AccumulatedZoom()const
	CCoeControl::ActivateGc()const
	CCoeControl::ActivateL()
	CCoeControl::BackedUpWindow()const
	CCoeControl::Background()const
	CCoeControl::CCoeControl()
	CCoeControl::CCoeControl(CCoeEnv *)
	CCoeControl::CCoeControl(const CCoeControl &)
	CCoeControl::CapturesPointer()const
	CCoeControl::ClaimPointerGrab(TBool)
	CCoeControl::ClaimPointerGrab(TInt,TBool)
	CCoeControl::CloseWindow()
	CCoeControl::ComponentArrayExists()const
	CCoeControl::ComponentControl(TInt)const
	CCoeControl::Components()
	CCoeControl::Components()const
	CCoeControl::ControlContext()const
	CCoeControl::ControlEnv()const
	CCoeControl::CopyControlContextFrom(const CCoeControl *)
	CCoeControl::CountComponentControls()const
	CCoeControl::CreateBackedUpWindowL(RWindowTreeNode &)
	CCoeControl::CreateBackedUpWindowL(RWindowTreeNode &,TDisplayMode)
	CCoeControl::CreateWindowL()
	CCoeControl::CreateWindowL(RWindowGroup *)
	CCoeControl::CreateWindowL(RWindowTreeNode &)
	CCoeControl::CreateWindowL(const CCoeControl *)
	CCoeControl::CustomGc()const
	CCoeControl::DeactivateGc()const
	CCoeControl::DrawBackground(const TRect &)const
	CCoeControl::DrawDeferred()const
	CCoeControl::DrawForeground(const TRect &)const
	CCoeControl::DrawNow()const
	CCoeControl::DrawNow(const TRect &)const
	CCoeControl::DrawableWindow()const
	CCoeControl::EnableDragEvents()
	CCoeControl::EnableReportControlStateChange(TBool)
	CCoeControl::EnableWindowTransparency()
	CCoeControl::FindBackground()const
	CCoeControl::FindFontProvider()const
	CCoeControl::GetColor(TInt,TRgb &)const
	CCoeControl::GetGc()const
	CCoeControl::GetHelpContext(TCoeHelpContext &)const
	CCoeControl::GrabbingComponent()const
	CCoeControl::GrabbingComponent(TInt)const
	CCoeControl::HandleComponentControlsResourceChange(TInt)
	CCoeControl::HandleControlArrayEventL(CCoeControlArray::TEvent,const CCoeControlArray ,CCoeControl ,TInt)
	CCoeControl::HandlePointerBufferReadyL()
	CCoeControl::HandleRedrawEvent(const TRect &)const
	CCoeControl::HitTest()const
	CCoeControl::IgnoreEventsUntilNextPointerUp()
	CCoeControl::Index(const CCoeControl *)const
	CCoeControl::InitComponentArrayL()
	CCoeControl::IsActivated()const
	CCoeControl::IsBackedUp()const
	CCoeControl::IsBeingDestroyed()const
	CCoeControl::IsBlank()const
	CCoeControl::IsDimmed()const
	CCoeControl::IsFocused()const
	CCoeControl::IsNonFocusing()const
	CCoeControl::IsReadyToDraw()const
	CCoeControl::IsVisible()const
	CCoeControl::LayoutManager()const
	CCoeControl::MaximumWidth()const
	CCoeControl::NotifyFontChange(const CCoeFontProvider *)
	CCoeControl::Observer()const
	CCoeControl::OverrideColorL(TInt,TRgb)
	CCoeControl::OwnsWindow()const
	CCoeControl::Parent()
	CCoeControl::Parent()const
	CCoeControl::Position()const
	CCoeControl::PositionChanged()
	CCoeControl::PositionRelativeToScreen()const
	CCoeControl::PrepareForFocusGainL()
	CCoeControl::ProcessPointerBufferReadyL()
	CCoeControl::ProcessPointerEventL(const TPointerEvent &)
	CCoeControl::Rect()const
	CCoeControl::RecursivelyMergeInputCapabilities(TCoeInputCapabilities &)const
	CCoeControl::RecursivelyMergedInputCapabilities()const
	CCoeControl::RefetchPixelMappingL()
	CCoeControl::RemoveFromParent()
	CCoeControl::ReportEventL(MCoeControlObserver::TCoeEvent)
	CCoeControl::RequestRelayout(const CCoeControl *)
	CCoeControl::ResetGc()const
	CCoeControl::ScreenFont(const TCoeFont &)const
	CCoeControl::SetAllowStrayPointers()
	CCoeControl::SetBackground(const MCoeControlBackground *)
	CCoeControl::SetBlank()
	CCoeControl::SetCanDrawOutsideRect()
	CCoeControl::SetComponentsToInheritVisibility(TBool)
	CCoeControl::SetContainerWindowL(RBackedUpWindow &)
	CCoeControl::SetContainerWindowL(RWindow &)
	CCoeControl::SetContainerWindowL(const CCoeControl &)
	CCoeControl::SetControlContext(MCoeControlContext *)
	CCoeControl::SetCornerAndSize(TGulAlignment,const TSize &)
	CCoeControl::SetCustomGc(CWindowGc *)
	CCoeControl::SetDimmed(TBool)
	CCoeControl::SetExtent(const TPoint &,const TSize &)
	CCoeControl::SetExtentToWholeScreen()
	CCoeControl::SetFocus(TBool,TDrawNow)
	CCoeControl::SetFocusing(TBool)
	CCoeControl::SetFontProviderL(const CCoeFontProvider &)
	CCoeControl::SetGc(CWindowGc *)const
	CCoeControl::SetGloballyCapturing(TBool)
	CCoeControl::SetHitTest(const MCoeControlHitTest *)
	CCoeControl::SetLayoutManagerL(MCoeLayoutManager *)
	CCoeControl::SetMaximumWidth(TInt)
	CCoeControl::SetMopParent(MObjectProvider *)
	CCoeControl::SetNeighbor(CCoeControl *)
	CCoeControl::SetNonFocusing()
	CCoeControl::SetObserver(MCoeControlObserver *)
	CCoeControl::SetParent(CCoeControl *)
	CCoeControl::SetPointerCapture(TBool)
	CCoeControl::SetPosition(const TPoint &)
	CCoeControl::SetRect(const TRect &)
	CCoeControl::SetSize(const TSize &)
	CCoeControl::SetSizeWithoutNotification(const TSize &)
	CCoeControl::SetTextBaselineSpacing(TInt)
	CCoeControl::SetUniqueHandle(TInt)
	CCoeControl::SetZoomFactorL(TInt,TZoomType)
	CCoeControl::Size()const
	CCoeControl::SystemGc()const
	CCoeControl::TextBaselineOffset(const TSize &)const
	CCoeControl::TextDrawer(TInt)const
	CCoeControl::UniqueHandle()const
	CCoeControl::Window()const
	CCoeControl::WriteInternalStateNowL(RWriteStream &)const
	CCoeControl::ZoomWithType()const
	CCoeControl::operator=(const CCoeControl &)
	CCoeControl::~CCoeControl()
	CEikBorderedControl::Border()const
	CEikBorderedControl::CEikBorderedControl()
	CEikBorderedControl::CEikBorderedControl(const TGulBorder &)
	CEikBorderedControl::HasBorder()const
	CEikBorderedControl::SetAdjacent(TInt)
	CEikBorderedControl::SetBorder(TGulBorder::TBorderType)
	CEikBorderedControl::SetBorder(TInt)
	CEikMfne::AddField(CEikMfneField *)
	CEikMfne::BorderMargins()const
	CEikMfne::CEikMfne()
	CEikMfne::Convert(const TTime &)
	CEikMfne::Convert(const TTimeIntervalSeconds &)
	CEikMfne::CreateFieldArrayL(TInt)
	CEikMfne::CurrentField()const
	CEikMfne::DrawNowAndLeaveWithTimeDateFormatInfoMsgL(TInt,const TTime &)const
	CEikMfne::Field(TInt)const
	CEikMfne::FieldIsAboutToBeDeHighlighted(CEikMfneField *,TBool &)
	CEikMfne::FocusChanged(TDrawNow)
	CEikMfne::Font()const
	CEikMfne::GetColorUseListL(CArrayFix< TCoeColorUse > &)const
	CEikMfne::GetCursorInfo(TPoint &,TInt &,TInt &,TInt &)
	CEikMfne::GetFeature(TInt,TInt &)const
	CEikMfne::HandleInteraction(TBool,TInt,TInt,CEikMfneField::THighlightType,TBool &,TBool &)
	CEikMfne::HandleMfneCommandL(TInt)
	CEikMfne::HandlePointerEventL(const TPointerEvent &)
	CEikMfne::HandleResourceChange(TInt)
	CEikMfne::HighlightField(TInt)
	CEikMfne::InputCapabilities()const
	CEikMfne::InvalidFieldAlert()
	CEikMfne::LeaveWithAlert(TInt)
	CEikMfne::MakeVisible(TBool)
	CEikMfne::MfneSize()const
	CEikMfne::MfneSize(TBool)
	CEikMfne::MinimumSize()
	CEikMfne::MopSupplyObject(TTypeUid)
	CEikMfne::NumFields()const
	CEikMfne::ReadDate(TResourceReader &)
	CEikMfne::ReadDuration(TResourceReader &)
	CEikMfne::ReadTime(TResourceReader &)
	CEikMfne::ReadTimeAndDate(TResourceReader &)
	CEikMfne::ReadTimeOffset(TResourceReader &)
	CEikMfne::ReportStateChangeEventL()
	CEikMfne::ReportUpdate()
	CEikMfne::ResetFieldArray()
	CEikMfne::SetCurrentField(TInt)
	CEikMfne::SetFeature(TInt,TInt)
	CEikMfne::SetFirstEditableField()
	CEikMfne::SetFont(const CFont *)
	CEikMfne::SetMfneAlignment(TInt)
	CEikMfne::SetSkinBackgroundControlContextL(MAknsControlContext *)
	CEikMfne::SetSkinTextColorL(TInt,TInt)
	CEikMfne::SetSuppressBackgroundDrawing(TBool)
	CEikMfne::SetUpAndDownKeysConsumed(TBool)
	CEikMfne::SetUseOverrideColors(TBool)
	CEikMfne::SetValidateCallBack(TCallBack)
	CEikMfne::SizeChanged()
	CEikMfne::SupportsFeature(TInt)const
	CEikMfne::WriteInternalStateL(RWriteStream &)const
	CEikMfne::~CEikMfne()

Public Member Enumerations
enum	TLocationContext { ELongitudeOnly = 0x1, ELatitudeOnly = 0x2 }

Private Member Enumerations
enum	TLocationType { EDD, EDMM, EDMSD }

Inherited Enumerations
	CCoeControl:TZoomType
	CEikMfne:TFeatureId
	CEikMfne:TFingerSupportParams

Private Attributes
TLocationContext	iContext
CLocationStrings *	iStrings

Inherited Attributes
	CCoeControl::iCoeEnv
	CCoeControl::iPosition
	CCoeControl::iSize
	CEikBorderedControl::iBorder

Constructor & Destructor Documentation

CAknLocationEditor()

IMPORT_C

CAknLocationEditor

(

)

Constructor

~CAknLocationEditor()

IMPORT_C

~CAknLocationEditor

(

)

Destructor

Member Functions Documentation

CAknLocationEditor_ExtensionInterface(TUid)

IMPORT_C void *

CAknLocationEditor_ExtensionInterface

(

TUid

aInterface

)

[protected, virtual]

Parameters

TUid aInterface

CombineDD(TPosition &, TLocationContext, TInt, TInt, TBool, TBool)

void	CombineDD	(	TPosition &	aValue,
			TLocationContext	aContext,
			TInt	aDegrees,
			TInt	aDeciDegrees,
			TBool	aNeg,
			TBool	aNan
		)	[private, static]

Parameters

TPosition & aValue
TLocationContext aContext
TInt aDegrees
TInt aDeciDegrees
TBool aNeg
TBool aNan

CombineDMM(TPosition &, TLocationContext, TInt, TInt, TInt, TBool, TBool)

void	CombineDMM	(	TPosition &	aValue,
			TLocationContext	aContext,
			TInt	aDegrees,
			TInt	aMinutes,
			TInt	aDeciMinutes,
			TBool	aNeg,
			TBool	aNan
		)	[private, static]

Parameters

TPosition & aValue
TLocationContext aContext
TInt aDegrees
TInt aMinutes
TInt aDeciMinutes
TBool aNeg
TBool aNan

CombineDMSD(TPosition &, TLocationContext, TInt, TInt, TInt, TInt, TBool, TBool)

void	CombineDMSD	(	TPosition &	aValue,
			TLocationContext	aContext,
			TInt	aDegrees,
			TInt	aMinutes,
			TInt	aSeconds,
			TInt	aDeciSeconds,
			TBool	aNeg,
			TBool	aNan
		)	[private, static]

Parameters

TPosition & aValue
TLocationContext aContext
TInt aDegrees
TInt aMinutes
TInt aSeconds
TInt aDeciSeconds
TBool aNeg
TBool aNan

ConstructFromResourceL(TResourceReader &)

IMPORT_C void

ConstructFromResourceL

(

TResourceReader &

aResourceReader

)

[virtual]

ConstructFromResourceL Constructs location editor using information from resource files

Parameters

TResourceReader & aResourceReader

resource reader

ConstructL(TPosition &, TLocationContext)

void	ConstructL	(	TPosition &	aValue,
			TLocationContext	aContext
		)	[private]

Parameters

TPosition & aValue
TLocationContext aContext

CreateMfneFieldsL(const TPosition &)

void

CreateMfneFieldsL

(

const TPosition &

aValue

)

Parameters

const TPosition & aValue

DisplayableLocationL(const TPosition &, TLocationContext)

IMPORT_C HBufC *	DisplayableLocationL	(	const TPosition &	aValue,
			TLocationContext	aContext
		)	[static]

DisplayableLocationL() Converts TPosition into displayable descriptor usable for listboxes

Parameters

const TPosition & aValue	value of the location
TLocationContext aContext	which part of the TPosition is used

FieldMapping(const TInt, const TLocationType)

TInt	FieldMapping	(	const TInt	aFieldNumber,
			const TLocationType	aType
		)	const [private]

Maps logical MFNE field order to correct visual order.

Parameters

const TInt aFieldNumber	Field position in logical format.
const TLocationType aType	Used location editor format.

Get(TPosition &)

IMPORT_C void

Get

(

TPosition &

aValue

)

const

Get() Gets either longitude or latitude values of aValue

Parameters

TPosition & aValue

TPosition object that will be modified

HandleCenRepChangedL(TUint32, TInt)

void	HandleCenRepChangedL	(	TUint32	aKey,
			TInt	aValue
		)

Parameters

TUint32 aKey
TInt aValue

LoadStringsL(TInt)

void

LoadStringsL

(

TInt

aResourceId

)

[private]

Parameters

TInt aResourceId

NewL(TPosition &, TLocationContext)

IMPORT_C CAknLocationEditor *	NewL	(	TPosition &	aValue,
			TLocationContext	aContext
		)	[static]

NewL() Creates location editor and initializes it's value to value determined by the aValue parameter.

Parameters

TPosition & aValue	Initial value for location editor.
TLocationContext aContext	Which part of the TPosition is used for this location editor

OfferKeyEventL(const TKeyEvent &, TEventCode)

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

OfferKeyEventL() key event handling of location editor

Parameters

const TKeyEvent & aKeyEvent
TEventCode aType

PrepareForFocusLossL()

IMPORT_C void

PrepareForFocusLossL

(

)

[virtual]

PrepareForFocusLossL() detects focus changes to validate editor contents

RefreshFromLocale()

void

RefreshFromLocale

(

)

[private]

Set(const TPosition &)

IMPORT_C void

Set

(

const TPosition &

aValue

)

Set() Sets either longitude or latitude values of aValue

Parameters

const TPosition & aValue

new value for the editor

SetUninitialised(TBool)

void

SetUninitialised

(

TBool

aInitialised

)

[private]

Parameters

TBool aInitialised

Split(const TPosition &, TLocationContext, TInt &, TInt &, TInt &, TInt &, TInt &, TInt &, TBool &, TBool &)

void	Split	(	const TPosition &	aValue,
			TLocationContext	aContext,
			TInt &	aDegrees,
			TInt &	aDeciDegrees,
			TInt &	aMinutes,
			TInt &	aDeciMinutes,
			TInt &	aSeconds,
			TInt &	aDeciSeconds,
			TBool &	aNeg,
			TBool &	aNan
		)	[private, static]

Parameters

const TPosition & aValue
TLocationContext aContext
TInt & aDegrees
TInt & aDeciDegrees
TInt & aMinutes
TInt & aDeciMinutes
TInt & aSeconds
TInt & aDeciSeconds
TBool & aNeg
TBool & aNan

SplitDD(const TPosition &, TLocationContext, TInt &, TInt &, TBool &, TBool &)

void	SplitDD	(	const TPosition &	aValue,
			TLocationContext	aContext,
			TInt &	aDegrees,
			TInt &	aDeciDegrees,
			TBool &	aNeg,
			TBool &	aNan
		)	[private, static]

Parameters

const TPosition & aValue
TLocationContext aContext
TInt & aDegrees
TInt & aDeciDegrees
TBool & aNeg
TBool & aNan

SplitDMM(const TPosition &, TLocationContext, TInt &, TInt &, TInt &, TBool &, TBool &)

void	SplitDMM	(	const TPosition &	aValue,
			TLocationContext	aContext,
			TInt &	aDegrees,
			TInt &	aMinutes,
			TInt &	aDeciMinutes,
			TBool &	aNeg,
			TBool &	aNan
		)	[private, static]

Parameters

const TPosition & aValue
TLocationContext aContext
TInt & aDegrees
TInt & aMinutes
TInt & aDeciMinutes
TBool & aNeg
TBool & aNan

SplitDMSD(const TPosition &, TLocationContext, TInt &, TInt &, TInt &, TInt &, TBool &, TBool &)

void	SplitDMSD	(	const TPosition &	aValue,
			TLocationContext	aContext,
			TInt &	aDegrees,
			TInt &	aMinutes,
			TInt &	aSeconds,
			TInt &	aDeciSeconds,
			TBool &	aNeg,
			TBool &	aNan
		)	[private, static]

Parameters

const TPosition & aValue
TLocationContext aContext
TInt & aDegrees
TInt & aMinutes
TInt & aSeconds
TInt & aDeciSeconds
TBool & aNeg
TBool & aNan

Type()

TLocationType

Type

(

)

const [private]

Member Enumerations Documentation

Enum TLocationContext

TLocationContext determines what part of TPosition class is used for this editor. ELongitudeOnly means only longitude part of TPosition is used. ELatitudeOnly means only latitude part of TPosition is used.

Enumerators

ELongitudeOnly = 0x1
ELatitudeOnly = 0x2

Enum TLocationType

Enumerators

EDD
EDMM
EDMSD

Member Data Documentation

TLocationContext iContext

TLocationContext

iContext

[private]

CLocationStrings * iStrings

CLocationStrings *

iStrings

[private]