setMultiValue()

Sets any number of graphics attributes of any number of graphics elements.

Synopsis

int setMultiValue (string shapeA, string attributeA_1, <typeA_1_1> parA_1_1 [...] [,string shapeB, string attributeB_1, <typeB_1_1> parB_1_1]]);

Parameters

Parameter	Meaning
shapeA, shapeB, ...	Graphics element
attributeA_1, attributeB_1	Attributes to be modified
parA_1_1, parB_1_1	Parameters for the attributes

Return value

0, if unsuccessful -1

Errors

missing/incorrect arguments

Description

The function setMultiValue() sets any number of graphics objects of any number of graphics elements. It works like the function setValue(). Particularly where graphics properties of objects that overlap are to be modified together, this can be done quicker by a setMultiValue() than with an appropriate number of setValue() instructions, as fewer redraws are required.

Example

Setting the border color of the own object to red-green blinking, with a clock rate of ¼ second. Setting the background color of the object "circle" to blue.

	main()
{
...
setMultiValue("", "foreCol", "<[100,0,0],2,[0,100,0],2,[0,0,0],0,[0,0,0],0,[0,0,0],0,[0,0,0],0>", "circle", "backCol", "[0,0,100]");
...
}

Relates to

Graphics

Availability