Category 3D drawings and annotations, Object ProDimension

Function ProDimensionLocationGet


Description
Returns a structure containing the location of elements making up a solid model/drawing dimension or reference dimension. NOTE: In a solid model, dimension location values will always be extracted by this function with respect to the indicated model orientation. The locations and values will be different for the same dimension when that model has a different orientation and scaling factor applied. This does not apply for drawings. NOTE: In the event of a PRO_TK_NOT_DISPLAYED error, the argument "data" still contains location information.
Synopsis
#include <ProDimension.h>
ProErrorProDimensionLocationGet(
ProDimension* dim
/* (In)
The dimension handle.
*/
ProView view
/* (In)
The orientation of the model that will be applied before calculating the locations. Pass NULL to use the current model view, if the model is current, or a default model orientation otherwise. Pass NULL if using a drawing.
*/
ProDrawing drawing
/* (In)
The drawing handle. Pass NULL if not using a drawing.
*/
ProDimlocation* data
/* (Out)
The dimension location data.
*/
)
Returns
PRO_TK_NO_ERRORThe function succeeded.
PRO_TK_NOT_DISPLAYEDThe function succeeded, but only after internally selecting a default orientation where one was not supplied, for a dimension which could have different locations given different views. This error can only occur if both drawing and view are NULL.
PRO_TK_BAD_INPUTSOne or more arguments is invalid. For example, if drawing != NULL && view != NULL.
PRO_TK_E_NOT_FOUNDThis dimension is not displayable.
PRO_TK_NOT_VALIDA drawing view was passed with a drawing.

Manual References:

  1. Assembly: Data Sharing Features: Accessing Properties of Variant Features
  2. Annotations: Annotation Features and Annotations: Dimension Location
  3. Annotations: Annotation Features and Annotations: Dimension Location
  4. Annotations: Annotation Features and Annotations: Dimension Location

Sample Code References:

  1. pt_userguide ( UgDimLocationUtils.c )