HoleFeatures.CreateLinearPlacementDefinition Method

Parent Object: HoleFeatures

Description

Method that creates a new LinearHolePlacementDefinition object that can be used for defining the placement of Hole features with respect to two linear edges.

Syntax

HoleFeatures.CreateLinearPlacementDefinition( Plane As Object, ReferenceEntityOne As Object, DistanceOne As Variant, ReferenceEntityTwo As Object, DistanceTwo As Variant, BiasPoint As Point ) As LinearHolePlacementDefinition

Parameters

Name Type Description
Plane Object Object that indicates the plane on which to place the hole feature. Valid inputs are Face and WorkPlane objects. The input Face object needs to be planar else an error will occur.
ReferenceEntityOne Object Object that specifies the first entity referenced for dimensioning the placement of the hole. The only valid input is an Edge object and it needs to be linear. An error will occur if the entity is perpendicular to the plane of the input face.
DistanceOne Variant Specifies the distance of the hole center from the first reference entity. This can be either a numeric value or a string. A parameter for this value will be created and the supplied string or value is assigned to the parameter. If a value is input, the units are centimeters. If a string is input, the units can be specified as part of the string or it will default to the current length units of the document.
ReferenceEntityTwo Object Object that specifies the second entity referenced for dimensioning the placement of the hole. The only valid input is an Edge object and it needs to be linear. An error will occur if the entity is perpendicular to the plane of the input face. An error will also occur if the entity is parallel to the first reference entity.
DistanceTwo Variant Specifies the distance of the hole center from the second reference entity. This can be either a numeric value or a string. A parameter for this value will be created and the supplied string or value is assigned to the parameter. If a value is input, the units are centimeters. If a string is input, the units can be specified as part of the string or it will default to the current length units of the document.
BiasPoint Point Object that specifies a point to be used as a bias point. This can simply be the location where the hole needs to be placed and is equivalent to the pick point when creating a hole feature with the linear placement option through the user interface. The true location is decided by the DistanceOne and DistanceTwo arguments. The point must lie on the infinite plane defined by the Plane argument input, else an error will occur.

Samples

Name Description
Hole feature linear placement This sample demonstrates the creation of a hole feature using the linear placement type.

Version

Introduced in version 11