Skip to content

Latest commit

 

History

History
50 lines (39 loc) · 1.79 KB

GetCustomObjectChoice.md

File metadata and controls

50 lines (39 loc) · 1.79 KB

GetCustomObjectChoice

Description

Function GetCustomObjectChoice returns a choice string of the specified plug-in object popup menu or radio group parameter. These parameters are displayed in the Object Info palette or the plug-in objects' creation dialog.

The string passed into the parameter name argument should use the parameter constant syntax, not the actual parameter name. The string should have the prefix character 'P', and should have all spaces replaced with underscore characters. For example, a parameter Jamb Depth would have a constant declared as PJAMB_DEPTH and therefore the parameter name argument to this function should be the string 'PJAMB_DEPTH'.

The choiceIndex parameter should be passed an integer between 1 and the number of choices, which can be determined by calling the NumCustomObjectChoices function.

FUNCTION GetCustomObjectChoice(
				objectName    : STRING;
				parameterName : STRING;
				choiceIndex   : INTEGER): STRING;
def vs.GetCustomObjectChoice(objectName, parameterName, choiceIndex):
    return STRING

Parameters

Name Type Description
objectName STRING Name of the plugin object.
parameterName STRING String indicating which parameter.
choiceIndex INTEGER Index of desired choice.

Remarks

Call from CustomObject scripts only. Returns a particular choice string for a popup menu or radio group parameter.

Examples

VectorScript

theChoice := GetCustomObjectChoice(objectName, 'PDINNER_MENU', 1);

Python

theChoice = vs.GetCustomObjectChoice(objectName, 'PDINNER_MENU', 1)

See Also

VS Functions: NumCustomObjectChoices

Version

Availability: from VectorWorks8.0

Category