PrevNextUpHome SophiaFramework UNIVERSE 5.3
SFBvProperty
Wrapper Class for the IvProperty interface.
#include <SFBvProperty.h.hpp>
class SFBvProperty : public SFBvObject;
SFMTYPEDEFWRAPPER(SFBvProperty)

Inheritance diagram

 Inheritance diagram of SFBvPropertyClass

Version

BREW 2.0 BREW 2.1 BREW 3.1 BREW 4.0
X X O O

Reference

BREW API IvProperty

Member

Public Functions
SFCError AddParm( SFBvParmSmpConstRef param )
Add a parameter to a SFBvProperty object.
SFCError GetGroupName( ACharPtr buffer , SInt32 size , SInt32Ptr sizereq )
Get the property group-name if it belongs to some group.
SFCError GetGroupName( SFXAnsiStringPtr name )
Get the property group-name if it belongs to some group.
SFCError GetId( AEEVProperty * propertyId )
Get the property Identifier.
SFCError GetNumberOfParms( AEEVParameter paramId , SInt32Ptr num )
Retrieve the number of parameters based on the parameter ID passed in.
SFCError GetParmAtIndex( AEEVParameter paramId , SInt32 index , SFBvParmSmpPtr param )
Retrieve the SFBvParm object specified by parameter ID and index.
SFCError GetPropertyName( ACharPtr buffer , SInt32 size , SInt32Ptr sizereq )
Get the property name.
SFCError GetPropertyName( SFXAnsiStringPtr name )
Get the property name.
SFCError InitProperty( AEEVProperty propertyId , ACharPtr name , Bool parsed , VoidPtr value , SInt32 size , ACharPtr group )
Initialize a property object, with a given ID or name and value.
SFCError InitProperty( AEEVProperty propertyId , SFXAnsiStringConstRef name , Bool parsed , SFXBufferConstRef value , SFXAnsiStringConstRef group )
Initialize a property object, with a given ID or name and value.
static
SFBvPropertySmp
NewInstance( SFCErrorPtr exception = null )
Create a new SFBvProperty instance.
static
SFBvPropertySmp
NewInstance( AEECLSID id , SFCErrorPtr exception = null )
Create a new SFBvProperty instance.
SFCError ParseValue( Bool parsed , VoidPtr buffer , SInt32 size , SInt32Ptr sizereq )
Parse the value of property into predefined data types.
SFCError ParseValue( Bool parsed , SFXBufferPtr buffer )
Parse the value of property into predefined data types.
SFCError RemoveParm( SFBvParmSmpConstRef param )
Delete the provided parameter object.
SFCError GetObjectType( AEECLSID * type ) (inherits from SFBvObject)
Return the AEECLSID of the current object type.
SFCError QueryInterface( AEECLSID clsid , VoidHandle handle ) (inherits from SFBQuery)
Ask an object for another API contract from the object in question.
SFCError QueryInterface( AEECLSID clsid , SFBBaseSmpPtr handle ) (inherits from SFBQuery)
Ask an object for another API contract from the object in question.
SFBBaseSmp QueryInterface( AEECLSID clsid ) (inherits from SFBQuery)
Ask an object for another API contract from the object in question.
Void Self( AEECLSID clsidReq , SFBQuerySmpPtr clone , AEECLSID clsidImp ) (inherits from SFBQuery)
Helper macro for those implementing an object with a single interface.
SFBQuerySmp Self( AEECLSID clsidReq , AEECLSID clsidImp ) (inherits from SFBQuery)
Helper macro for those implementing an object with a single interface.
Protected Functions
static
SFBBaseSmp
FactoryByCreate( AEECLSID id , SFCErrorPtr exception = null ) (inherits from SFBBase)
Create the instance for the specified ClassID's interface.
static
SFBBaseSmp
FactoryByQuery( SFBQuerySmpConstRef query , AEECLSID id , SFCErrorPtr exception = null ) (inherits from SFBBase)
Create the instance for the specified ClassID's interface using the SFBQuery instance.

SFBvProperty::AddParm
Add a parameter to a SFBvProperty object.
[ public ]
SFCError AddParm(
    SFBvParmSmpConstRef param   // the paramter to be added to the property
);

Reference

BREW API IvProperty_AddParm | SFBvParm


SFBvProperty::GetGroupName
Get the property group-name if it belongs to some group.
[ public ]
SFCError GetGroupName(
    ACharPtr buffer     // pointer to the buffer where group name will be stored
    SInt32 size         // size of buffer
    SInt32Ptr sizereq   // If buffer is null, the size required is returned
);
[ public ]
SFCError GetGroupName(
    SFXAnsiStringPtr name   // group name
);

Reference

BREW API IvProperty_GetGroupName


SFBvProperty::GetId
Get the property Identifier.
[ public ]
SFCError GetId(
    AEEVProperty * propertyId   // upon return contains the property ID
);

Reference

BREW API IvProperty_GetId


SFBvProperty::GetNumberOfParms
Retrieve the number of parameters based on the parameter ID passed in.
[ public ]
SFCError GetNumberOfParms(
    AEEVParameter paramId   // parameter ID for which the objects cnt has to be retrieved
    SInt32Ptr num           // holds the number of SFBvParm objects with the specified id
);

Reference

BREW API IvProperty_GetNumberOfParms


SFBvProperty::GetParmAtIndex
Retrieve the SFBvParm object specified by parameter ID and index.
[ public ]
SFCError GetParmAtIndex(
    AEEVParameter paramId   // parameter ID for which the object has to be retrieved
    SInt32 index            // the index at which the object has to be retrieved, the index is zero based
    SFBvParmSmpPtr param    // holds a pointer to the returned SFBvParm object
);

Reference

BREW API IvProperty_GetParmAtIndex | SFBvParm


SFBvProperty::GetPropertyName
Get the property name.
[ public ]
SFCError GetPropertyName(
    ACharPtr buffer     // pointer to the buffer where the name will be stored
    SInt32 size         // size of buffer
    SInt32Ptr sizereq   // If buffer is null, the size required is returned
);
[ public ]
SFCError GetPropertyName(
    SFXAnsiStringPtr name   // property name
);

Reference

BREW API IvProperty_GetPropertyName


SFBvProperty::InitProperty
Initialize a property object, with a given ID or name and value.
[ public ]
SFCError InitProperty(
    AEEVProperty propertyId   // property ID, with which this object has to be initialised
    ACharPtr name             // property name, with which the user wants to initialize
    Bool parsed               // indicates whether the passed in value pValue is according to the data types mentioned, or a raw buffer, if raw buffer then it has to be encoded in UTF-8 charset
    VoidPtr value             // property value
    SInt32 size               // size of the property value
    ACharPtr group            // null-terminated property group name (optional)
);
[ public ]
SFCError InitProperty(
    AEEVProperty propertyId       // property ID, with which this object has to be initialised
    SFXAnsiStringConstRef name    // property name, with which the user wants to initialize
    Bool parsed                   // indicates whether the passed in value pValue is according to the data types mentioned, or a raw buffer, if raw buffer then it has to be encoded in UTF-8 charset
    SFXBufferConstRef value       // property value
    SFXAnsiStringConstRef group   // group name
);

Reference

BREW API IvProperty_InitProperty


SFBvProperty::NewInstance
Create a new SFBvProperty instance.
[ public, static ]
SFBvPropertySmp NewInstance(
    SFCErrorPtr exception = null   // Error
);
[ public, static ]
SFBvPropertySmp NewInstance(
    AEECLSID id                    // Class ID
    SFCErrorPtr exception = null   // Error
);

SFBvProperty::ParseValue
Parse the value of property into predefined data types.
[ public ]
SFCError ParseValue(
    Bool parsed         // indicates whether user wants a raw data buffer or parsed
    VoidPtr buffer      // pointer to the buffer where parsed property value will be stored
    SInt32 size         // size of buffer
    SInt32Ptr sizereq   // If buffer is null, the size required is returned, ignored, otherwise
);
[ public ]
SFCError ParseValue(
    Bool parsed           // indicates whether user wants a raw data buffer or parsed
    SFXBufferPtr buffer   // pointer to the buffer where parsed property value will be stored
);

Reference

BREW API IvProperty_ParseValue


SFBvProperty::RemoveParm
Delete the provided parameter object.
[ public ]
SFCError RemoveParm(
    SFBvParmSmpConstRef param   // the parameter object that has to be removed
);

Reference

BREW API IvProperty_RemoveParm | SFBvParm