Category Solids and parts, Object ProSolid

Function ProSolidDimensionVisit


Description
Visits all dimensions stored in the specified solid. i.e. all dimensions whose default names are of the form "d#", "rd#" or "ad#". This includes dimensions created in drawing mode when the config.pro option "create_drawing_dims_only" was set to NO (the default).
Replacement in Object TOOLKIT: pfcModel2D::ListShownDimensions
Synopsis
#include <ProSolid.h>
ProErrorProSolidDimensionVisit(
ProSolid solid
/* (In)
Handle of the solid (part or assembly) whose dimensions are to be visited.
*/
ProBoolean refdim
/* (In)
TRUE if the reference dimensions are to be visited, FALSE for standard dimensions.
*/
ProDimensionVisitAction action
/* (In)
the function that gets called for each solid dimension being visited.
*/
ProDimensionFilterAction filter
/* (In)
the function that gets called for each solid dimension. This function decides whether the dimension should be visited or skipped. If NULL, all dimensions are visited using the action function.
*/
ProAppData data
/* (In)
caller-specified data that gets passed to the action and filter functions.
*/
)
Returns
PRO_TK_NO_ERRORThe function successfully visited all the model's dimensions.
PRO_TK_BAD_INPUTSThe function failed because one or more of the input arguments are invalid.
PRO_TK_E_NOT_FOUNDNo model dimensions were visited.
PRO_TK_GENERAL_ERRORAn error occurred while locating the dimensions.
otherVisiting was stopped by the caller supplied functions with this error return.

Manual References:

  1. Assembly: Data Sharing Features: Accessing Properties of Variant Features
  2. Annotations: Annotation Features and Annotations: Visiting Dimensions
  3. Annotations: Annotation Features and Annotations: Visiting Dimensions
  4. Annotations: Annotation Features and Annotations: Driving Dimension Annotation Elements

Sample Code References:

  1. pt_examples ( UtilCollect.c )
  2. pt_userguide ( UgDimLocationUtils.c )