Layer.CreateLinearDimension method - Developer Area

API Documentation > CorelDRAW > 2023-v24.3 > Layer > IVGLayer

Layer.CreateLinearDimension method

Creates a linear dimension

Syntax:

Function CreateLinearDimension(ByVal Type As cdrLinearDimensionType, ByVal Point1 As SnapPoint, ByVal Point2 As SnapPoint, Optional ByVal TextCentered As Boolean = True, Optional ByVal TextX As Double = 0, Optional ByVal TextY As Double = 0, Optional ByVal Style As cdrDimensionStyle = cdrDimensionStyleDecimal, Optional ByVal Precision As Long = 2, Optional ByVal ShowUnits As Boolean = True, Optional ByVal Units As cdrDimensionLinearUnits = cdrDimensionUnitMM, Optional ByVal Placement As cdrDimensionPlacement = cdrDimensionWithinLine, Optional ByVal HorizontalText As Boolean = False, Optional ByVal BoxedText As Boolean = False, Optional ByVal LeadingZero As Boolean = True, Optional ByVal Prefix As String, Optional ByVal Suffix As String, Optional ByVal OutlineWidth As Double = -1, Optional ByVal Arrows As ArrowHead = Nothing, Optional ByVal OutlineColor As Color = Nothing, Optional ByVal TextFont As String, Optional ByVal TextSize As Double = 0, Optional ByVal TextColor As Color = Nothing) As Shape

Parameters:

Name	Type	Description
Type	cdrLinearDimensionType	Specifies the type of linear dimension that is created
Point1	SnapPoint	Specifies a snap point that represents one endpoint of the linear dimension
Point2	SnapPoint	Specifies a snap point that represents one endpoint of the linear dimension
TextCentered	Boolean	Specifies whether to center the text on the dimension line. True centers the text, while False leaves the text at the specified coordinates.
TextX	Double	Specifies the horizontal position of the text label.
TextY	Double	Specifies the vertical position of the text label.
Style	cdrDimensionStyle	Specifies the number-formatting style for the dimension value of the text label.
Precision	Long	Specifies the number of significant digits for the dimension label to display after the decimal point, if using a decimal format for the dimension value.
ShowUnits	Boolean	Specifies whether to display the unit of measurement in the label.
Units	cdrDimensionLinearUnits	Specifies the unit of measurement for the dimension value.
Placement	cdrDimensionPlacement	Specifies the placement of the text label relative to its dimension line.
HorizontalText	Boolean	Specifies how to position dimension text. True rotates the dimension text horizontally, while False leaves the dimension text parallel to the dimension line.
BoxedText	Boolean	Specifies whether the dimension value has a visible border with the same properties as the dimension line - that is, whether the dimension label is enclosed by a rectangle.
LeadingZero	Boolean	Specifies whether the text value displays a leading zero for numbers that are less than 1.0 and for which a decimal format is used.
Prefix	String	Specifies the prefix for the dimension label (that is, the text displayed before the dimension value).
Suffix	String	Specifies the suffix for the dimension label (that is, the text displayed after the dimension value).
OutlineWidth	Double	Specifies the outline width.
Arrows	ArrowHead	Specifies the desired arrowheads.
OutlineColor	Color	Specifies the outline color.
TextFont	String	Specifies the text font.
TextSize	Double	Specifies the text size.
TextColor	Color	Specifies the text color.

Remarks:

The CreateLinearDimension method creates a linear dimension at a specified location on a layer.

Version Information:

CorelDRAW:	X7.4, X7, X7.6, X8, 2017, 2018, 2019, 2019.2, 2020, 2021, 2020.1, 2021.5, 2022-v24, 2022-v24.1, 2022-v24.2, 2023-v24.3, 2023-v24.5, 2024-v25
Corel DESIGNER:	X7, 2017.1, 20.1, 2019.2, 2020.1, 2021.5, 2022-v24, 2022-v24.1, 2022-v24.2, 2023-v24.3, 2023-v24.5, 2024-v25