Adds a new custom parameter to the custom property. This version
is a simplified version of CustomProperty.AddParameter2.
The most commonly-used siCapabilities flags, siAnimatable and
siReadOnly, are exposed directly as optional arguments.
Most parameters can be specified with this method. However you
should consider using CustomProperty.AddParameter
or CustomProperty.AddParameter2
if the parameter needs a UI range, specific classification flags,
or a user name.
oReturn = CustomProperty.AddParameter3( ScriptName, ValueType, [DefaultValue], [Min], [Max], [Animatable], [ReadOnly] ); |
The newly created Parameter object.
| Parameter | Type | Description |
|---|---|---|
| ScriptName | String | Name of the custom parameter. This argument specifies both the Parameter.ScriptName and SIObject.Name. It should not contain spaces. |
| ValueType | siVariantType | Type of the custom parameter. The recommended types are siString, siBool, siInt4, siUByte, and siFloat. (See Parameter.ValueType) |
| DefaultValue | Variant | Default value of the custom parameter. A default value for a numerical values including boolean is 0, the string default is "". (See Parameter.Default) |
| Min | Variant | Minimum value of the custom parameter. siString and siBool types do not require a Min value. For all other numerical type the default will be minimum value possible for the type for example all unsigned values will have a min=0. (See Parameter.Min) |
| Max | Variant | Maximum value of the custom parameter. siString and siBool types do not require a Max value. For all other numerical type the default will be minimum value possible for the type for example the maximum value for siUByte is 255. (See Parameter.Max) |
| Animatable | Boolean | Specify that the parameter should support animation. This
argument is ignored for string parameters, which do not support
animation. It is possible to override this setting on a particular
instance of a parameter via Parameter.Animatable.
Default Value: true |
| ReadOnly | Boolean | Specify that the user cannot change the value of this
Parameter. A read-only parameter can still be changed via scripting
(see Parameter.Value) It is
possible to override this setting on a particular instance of a
parameter via Parameter.ReadOnly.
Default Value: false |