%%PageItemTitle%%

VectorDraw Web Library

JsPropertiesExtractor Send comments on this topic.
rect Method
See Also  Example
vdWebLibrary Namespace > ScriptCommands Class : rect Method
parameters
An array of parameters in the following order, used for no user action. 1.Insertion point in world coordinate system, as an array of 3 numbers(X,Y,Z) 2.Width in drawing units 3.Height in drawing units 4.Rotation angle in radians
callback
A user function of ScriptEntityDelegate type, that will be called when the command finish successfully.It can be ignored.
Add a rect to the document.

Syntax

JScript 
public function rect( 
   parameters : Object[],
   callback : ScriptEntityDelegate
);

Parameters

parameters
An array of parameters in the following order, used for no user action. 1.Insertion point in world coordinate system, as an array of 3 numbers(X,Y,Z) 2.Width in drawing units 3.Height in drawing units 4.Rotation angle in radians
callback
A user function of ScriptEntityDelegate type, that will be called when the command finish successfully.It can be ignored.

Example

C#Copy Code
vdrawobj.scriptCommand.rect(); // begins a user action to draw a rect
C#Copy Code
// draw a rect  using active color , linetype,layer etc properties, with insertion point 2,2  width 3 ,height 4, and rotation angle 45 degrees 
//after this command is finished the object is not drawn on screen. 
//You can call the vdrawObj.redraw after adding an amount of commands 
vdrawobj.scriptCommand.rect([[2,2,0],3.0,4.0, vdgeo.DegreesToRadians(45)]);  
setTimeout(vdrawObj.redraw);//post a redraw command
C#Copy Code
// draw a rect using active color , linetype,layer etc properties,  with insertion point 2,2  width 3 ,height 4, and rotation angle 45 degrees 
//after this command is finished the object is not drawn on screen. 
In order to display it call vdrawObj.DrawEntity and <see cref="M:vdWebLibrary.vdrawObj.Refresh"/>  inside the user define callback .See example. 
 
function actionentityadded(vdraw, entity) { 
   vdraw.DrawEntity(entity); 
   setTimeout(vdraw.Refresh);//post a refresh command 
            } 
vdrawobj.scriptCommand.rect([[2,2,0],3.0,4.0, vdgeo.DegreesToRadians(45)] , actionentityadded);

Remarks

if passed parameters not exist or it is null then start a new user action and prompts the user to draw a rect. If parameters are not null then a new rect is added synchronously depend on the passed parameters. The command add the action to undo history and also to script lines getCommands If parameters are not null and after this command is finished the object is not drawn on screen In order to display it call DrawEntity and Refresh inside the user define callback .See example.

See Also