CIP Visual Basic.NET documentation for interface "IpfcBaseDimension"

Interface IpfcBaseDimension

Description

This class defines a base dimension, which can be a dimension or reference dimension.

The dimension types are as follows:

DIM_LINEAR
DIM_RADIAL
DIM_DIAMETER
DIM_ANGULAR

Direct Parent Classes:: IpfcBaseParameter, IpfcModelItem

Direct Known Subclasses:: IpfcDimension, IpfcRefDimension, IpfcUDFDimension, IpfcDimension2D

Property Summary


`Property`	`DimType`	`as IpfcDimensionType`
	The dimension type

`Property`	`DimValue`	`as Double`
	The value of the dimension.

`Property`	`ExtendsInNegativeDirection`	`as Boolean`
	Identifies if the dimension is currently considered to have a negative "sign" in generating its direction. If the dimension has a negative sign then the dimension is oriented in the opposite manner to the default for the feature.

`Property`	`Symbol`	`as String`
	The dimension name or symbol

`Property`	`Texts`	`as Istringseq`
	The dimension text

Method Summary


`Sub`	`Erase ()`

`DEPRECATED: since Creo 4`
`SUCCESSOR(S): Drawing.EraseDimension`
Erases the dimension from a model or drawing.

`Sub`	`Show (Instructions as IpfcDimensionShowInstructions [optional])`
	Forces the display of the dimension in a model.

Property Detail

Property DimType as IpfcDimensionType

The dimension type

Property DimValue as Double

The value of the dimension.

This is always positive if the model is fully regenerated. Use the property IpfcBaseDimension.ExtendsInNegativeDirection to detect if the dimension direction is oriented opposite to the feature default. When setting this property, if a negative number is passed, this will flip the direction of the dimension.

Exceptions thrown (but not limited to):

IpfcXToolkitBadContext - The input dimension is reference.

Property ExtendsInNegativeDirection as Boolean

Identifies if the dimension is currently considered to have a negative "sign" in generating its direction. If the dimension has a negative sign then the dimension is oriented in the opposite manner to the default for the feature.

Property Symbol as String

The dimension name or symbol

Exceptions thrown (but not limited to):

IpfcXToolkitNoChange - The function could not set the symbol to new value as the new symbol name already exists for other dimension in the model.

Property Texts as Istringseq

The dimension text

Exceptions thrown (but not limited to):

IpfcXToolkitNotFound - Dimension text is not found.

Method Detail

Sub Erase ()

DEPRECATED: since Creo 4

SUCCESSOR(S): Drawing.EraseDimension

Erases the dimension from a model or drawing.

If called on a IpfcDimension2D object, this temporarily erases the displayed dimension from the drawing. For a permanent erase please use IpfcDimension2D.EraseFromModel2D().

Sub Show (Instructions as IpfcDimensionShowInstructions [optional])

Forces the display of the dimension in a model.

Exceptions thrown (but not limited to):

IpfcXToolkitNoChange - The annotation is already shown in the target model.

IpfcXToolkitInvalidMatrix - The annotation cannot be shown due to orientation conflicts in the view.

IpfcXToolkitNoLicense - License check failure.

IpfcXToolkitNotDisplayed - Annotation is present on hidden or blank layer and so can't be shown.

See Also:: IpfcComponentDimensionShowInstructions.Create(), IpfcDrawingDimensionShowInstructions.Create()

Parameters:

Instructions

Specifies the location where the dimension should be shown:

Pass null to show the dimension in the top level part or assembly.
Pass an instance of IpfcComponentDimensionShowInstructions to show the dimension contained in an assembly component in a top level assembly.
Pass an instance of IpfcDrawingDimensionShowInstructions to show the dimension in a drawing view.