DataObject.EnableVarValueOrder

Prototypes

void EnableVarValueOrder( String sVarName <, boolean bEnable> )

Parameters

String sVarName
The name of the variable whose custom ordering you want to enable or disable.

boolean bEnable
If bEnable is true, the variable's custom ordering is enabled. If bEnable is false, the variable's custom ordering is disabled. Calling this method without specifying the bEnable parameter is equivalent to calling it with bEnable equal to true.

Remarks

This method enables or disables the custom ordering assigned to a variable. When a variable's custom ordering is enabled, the custom ordering flag VVO_ENABLE is set. When a variable's custom ordering is disabled, the custom ordering flag VVO_ENABLE is not set.

For information about custom ordering, see DataObject.SetVarValueOrder.

Example
declare DataObject dobj;
x = { "Low", "Medium", "Medium", "High", "High", "High" };
dobj = DataObject.Create( "Example", "X", x );
values = { "Low", "Medium", "High" };
dobj.SetVarValueOrder( "X", values );
BarChart.Create( dobj, "X" );
pause "Click the Resume button to continue.";
dobj.EnableVarValueOrder( "X", false );
See Also

DataObject.DeleteVarValueOrder
DataObject.GetVarValueOrderFlags
DataObject.IsVarValueOrderEnabled
DataObject.ModifyVarValueOrderFlags
DataObject.SetVarValueOrder