Collapse all Symbian^3 Product Developer Library

CMediaFetchImplementation Class Reference

class CMediaFetchImplementation : public CBase

ECom interface for Media Fetch plug-in implementation.

Plug-in implementation used for Media Fetch API functionality is selected based on plug-ins' implementation information.

Media types supported by the plug-in are defined in plug-in resource's default_data. The value must be in hexadecimal format:

LTEXT8 default_data;

Example: default_data = "00000003" if both image (0x00000001) and video (0x00000002) fetchers are supported by the plug-in.

See MediaFileTypes.hrh for supported media types.

If multiple plug-ins support the same media type(s) then the plug-in with the highest version number is selected.

BYTE version_no;

See registryinfov2.rh for ECom resource structure information.

n/a

Since: S60 v3.2

Inherits from

CMediaFetchImplementation
- CBase

Public Member Functions
	~CMediaFetchImplementation()
void	GetCancelerL(MMGFetchCanceler *&)
TBool	LaunchL(CDesCArray &, TMediaFileType)
CMediaFetchImplementation *	NewL(const TUid &)
void	SetHeadingL(const TDesC &)
void	SetMimeTypesL(const MDesCArray &)
void	SetMultiSelectionL(TBool)
void	SetSelectionSoftkeyL(const TDesC &)
void	SetVerifierL(MMGFetchVerifier &)

Inherited Functions
	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()

Private Attributes
TUid	iDtor_ID_Key

Constructor & Destructor Documentation

~CMediaFetchImplementation()

~CMediaFetchImplementation

(

)

[inline, virtual]

Member Functions Documentation

GetCancelerL(MMGFetchCanceler *&)

void

GetCancelerL

(

MMGFetchCanceler *&

aCanceler

)

[pure virtual]

Optional feature. Plug-in should return canceler interface.

Since: S60 v3.2

Parameters

MMGFetchCanceler *& aCanceler

See MMGFetchCanceler.h

LaunchL(CDesCArray &, TMediaFileType)

TBool	LaunchL	(	CDesCArray &	aSelectedFiles,
			TMediaFileType	aMediaType
		)	[pure virtual]

Plug-in should launch fetcher popup for given media type.

Since: S60 v3.2

Parameters

CDesCArray & aSelectedFiles	plug-in appends selected files to this array
TMediaFileType aMediaType	plug-in should display only files with this media type return ETrue if user selected file(s), EFalse if use cancelled.

NewL(const TUid &)

CMediaFetchImplementation *

NewL

(

const TUid &

aImplementationUid

)

[static, inline]

Parameters

const TUid & aImplementationUid

SetHeadingL(const TDesC &)

void

SetHeadingL

(

const TDesC &

aHeading

)

[pure virtual]

Optional feature Plug-in should use given text as heading

Since: S60 v3.2

Parameters

const TDesC & aHeading

Custom heading text for fetcher

SetMimeTypesL(const MDesCArray &)

void

SetMimeTypesL

(

const MDesCArray &

aMimeTypes

)

[pure virtual]

Optional feature.

Since: S60 v3.2

Parameters

const MDesCArray & aMimeTypes

plug-in should show only files with given Mime types

SetMultiSelectionL(TBool)

void

SetMultiSelectionL

(

TBool

aMultiSelect

)

[pure virtual]

Optional feature. By default fetcher is single selection fetcher. If multi-selection is enabled then plug-in should display a multi-selection fetcher and allow user to select several items.

Since: S60 v3.2

Parameters

TBool aMultiSelect

if ETrue then multiselection fetcher is enabled

SetSelectionSoftkeyL(const TDesC &)

void

SetSelectionSoftkeyL

(

const TDesC &

aSelectionSoftkey

)

[pure virtual]

Optional feature. Plug-in should use given text as selection key (SK1) label

Since: S60 v3.2

Parameters

const TDesC & aSelectionSoftkey

Custom selection softkey label

SetVerifierL(MMGFetchVerifier &)

void

SetVerifierL

(

MMGFetchVerifier &

aVerifier

)

[pure virtual]

Optional feature. Plug-in should call this interface before selection is done. if MMGFetchVerifier::VerifySelectionL() returns ETrue then the user's selection should be accepted and the fetcher closed. If EFalse is returned then user should change the current selection before it can be accepted and the fetcher closed.

Since: S60 v3.2

Parameters

MMGFetchVerifier & aVerifier

See MMGFetchVerifier.h

Member Data Documentation

TUid iDtor_ID_Key

TUid

iDtor_ID_Key

[private]