TEComResolverParams Class Reference

class TEComResolverParams

Used to pass values to a Resolver to aid in the filtering of Interface Implementation plugins. These values are considered match characteristics used during resolution of these Interface Implementation. It is a class used in the ECOM API provided by the REComSession class. This class DOES NOT own the descriptor data iDataType points to and so it will not release the data on descruction. This is the responsibility of the user of this class.

REComSession

Constructor & Destructor Documentation

TEComResolverParams()

TEComResolverParams()[inline]

Member Functions Documentation

DataType()

const TDesC8 &DataType()const [inline]

Provides read access to the Interface Implementation plugin 'datatype' match pattern. Note, since TEComResolveParams has a default constructor this data member may be an invalid descriptor which implies 'default matching'.

The read only 'datatype' match pattern.

The object is constructed

IsGenericMatch()

TBool IsGenericMatch()const [inline]

Check if 'generic' matching is allowed.

ETrue if generic matching is allowed, EFalse otherwise.

The object is constructed

IsWildcardMatch()

TBool IsWildcardMatch()const [inline]

SetDataType(const TDesC8 &)

voidSetDataType(const TDesC8 &aDataType)[inline]

Set the Interface Implementation plugin 'datatype' match pattern.

The object is constructed

iDataType equals aDataType.

Parameters

const TDesC8 & aDataTypeThe 'datatype' match pattern to be stored.

SetGenericMatch(TBool)

voidSetGenericMatch(TBoolaGenericMatch)[inline]

Indicates that a 'generic' match is required.

Either allow Interface Implementation plugins that are specific (use no wildcards in their registry file) or generic (use wildcards in their registry file).

In any case the user of a should NOT use wildcards in the datatype string that is passed into this object.

Rationale: The client that sets up the resolver is expected to know what type of data it is handling.

Use Case: "I have this gif to convert, but I'd prefer only gif-specific plugins" or "I have this gif to convert, but I'm happy with some generic image conversion plugin".

NOT: "I have this image I want some plugin to convert, but I don't know the type of the image".

The object is constructed

iGenericMatch equals aGenericMatch.

Parameters

TBool aGenericMatchETrue if a generic match is required, EFalse if not.

SetWildcardMatch(TBool)

voidSetWildcardMatch(TBoolaWildcardMatch)[inline]

Parameters

TBool aWildcardMatch

Member Data Documentation

TPtrC8 iDataType

TPtrC8 iDataType[private]

The Interface Implementation plugin 'datatype' match descriptor.

TBool iGenericMatch

TBool iGenericMatch[private]

The flag to show if generic matching is enabled