Provides information for a single parameter of an IlvUserAccessor
.
More...
#include <ilviews/protos/useracc.h>
Public Member Functions | |
IlvAccessorParameter (IlUInt count,...) | |
Constructor. More... | |
virtual const char ** | getChoices (IlvAccessorHolder *object, const char **params, IlUInt paramIndex, IlBoolean matchType, const IlvValueTypeClass *&type, IlUInt &count) |
Returns the possible choices for this accessor parameter. More... | |
virtual const IlvValueTypeClass * | getType (IlvAccessorHolder *object, const char **params, IlUInt paramIndex, const IlvValueTypeClass *myType) |
Returns the "preferred" type of this accessor parameter. More... | |
Provides information for a single parameter of an IlvUserAccessor
.
Library: ilvproto
This class is used with the IlvAccessorDescriptor
class. For every parameter of an IlvUserAccessor
subclass, you must provide the address of a pointer to an instance of an IlvAccessorParameter
subclass. The class has a constructor that lets you directly specify the possible values of an enumerated parameter. You can also use predefined instances of subclasses of IlvAccessorParameter
for various types of parameters (for more information, see IlvAccessorDescriptor
).
IlvAccessorDescriptor
, IlvRegisterUserAccessorClass()
, IlvUserAccessor
, IlvUnknownAccessorParameterType
, IlvStringParameterType
, IlvNodeNameParameterType
, IlvNodeNameOrAllParameterType
, IlvOutputAccessorParameterType
, IlvNodeAccessorParameterType
, IlvSubAccessorParameterType
, IlvValueParameterType
. IlvAccessorParameter::IlvAccessorParameter | ( | IlUInt | count, |
... | |||
) |
Constructor.
Initializes an accessor parameter type for a parameter that can have a number of fixed values.
count | The number of possible values. It is followed by arguments of type const char* , which represent possible parameter values. |
|
virtual |
Returns the possible choices for this accessor parameter.
The object parameter is the object to which the accessor is attached (usually an object of the type IlvPrototype
). The params parameter represents the current values of the parameters given the contextual information provided in the object and params parameters. paramIndex specifies the parameter number. If matchType is IlTrue
, this method should only return the choices that match the preferred type of this parameter (the preferred type is determined by the getType()
method). The type argument is initialized with the type of the accessor (as specified in the "Type" field of the Prototype Inspector), and it can be changed by the method. In this case, the new type will be used as the preferred type by Studio (see the getType()
method). The number of strings returned is stored in count. The returned array is allocated using the new[]
operator and it will be released when it is no longer needed, by using the delete[]
operator.
|
virtual |
Returns the "preferred" type of this accessor parameter.
The preferred type is used for two purposes:
Color
). The preferred type can be fixed for this parameter, or it can vary at run-time depending on the values of other parameters. object is the object to which the accessor is attached (usually an object of the type IlvPrototype
). params are the parameter values that have already been entered by the user in the matrix. paramIndex specifies the row of the parameter in the matrix. type is the accessor type (as specified in the "Type" field of the Prototype Inspector).