Scale Property

A Double type property. Gets or sets the drawing scale in the document. The drawing scale is the ratio of the dimensions in the drawing to the actual size of the objects represented by shapes in a ConceptDraw drawing.

Applies to: Document object

Syntax

[[Let] scaleRet =] object.Scale

[Let] object.Scale = scaleSet

The Scale property syntax has these parts:

Part Description
object Required. An expression that returns a Document object.
scaleRet Optional. A Double type variable.
scaleSet Required. An expression that returns a Double value.

Remarks

The Scale property can only have positive values, because a drawing scale can't be negative or zero. You can also modify Scale from within ConceptDraw, using the "File->Document Properties->Settings" dialog. Note, that modifying the Scale property sets the document scale "Custom Scale" and automatically re-calculates the two components of the document scale: the ConceptDraw units of measure and the real units of measure of the shapes in the document.

Example

This example contains an application-level script. It draws a rectangle, which has a formula associated with Scale property of the document. Then Scale is changed from 0.001 to 1.000. The changes are immediately reflected in the shape.

' Declare variables
Dim shp As Shape

' Draw a rectangle
Set shp = thisDoc.ActivePage.DrawRect( 100,100,1000,500 )

' Assign text to rectangle
shp.Text = " "
' Set font size for rectangle's text
shp.SetCharSize(1,1,22)
' Set the DocScale formula
' for the Text property of the rectangle
shp.SetPropertyFormula( "DocScale", CDPT_TEXT )

MsgBox("Let's Start!")

' Change the document scale from 0.001 to 1.000
for i=0.001 to 1.001 Step 0.001
    thisDoc.Scale = i
next i

 

See Also

SnapSensitivity property, SplineSmooth property