CIP C++ documentation for class "wfcWModel"

Class wfcWModel

# include <wfcModel.h> class wfcWModel : public virtual wfcWParameterOwner, : public virtual wfcWRelationOwner, : public virtual pfcModel { xaideclare(wfcWModel) ... };

Description

Adds more functionality to pfcModel.

Manual References:: Family Tables: Operations on Family Table Instances, Overview of Creo Object TOOLKIT C++: Casting of Creo Object TOOLKIT C++ pfc Classes to wfc Classes

Direct Known Subclasses:: wfcWDiagram, wfcWMFG, wfcWMarkup, wfcWModel2D, wfcSection, wfcWDrawingFormat, wfcWSolid

Method Summary


`void`	`AddAnnotationPlaneToGallery (xrstring AnnotPlaneName)`
	Add annotation plane with specified name to gallery.

`xbool`	`CanCreateSectionFeature ()`
	Determines if Cross Section can be created as feature in specified model

`wfcParamTablesets_ptr`	`CollectParamTablesets ()`
	Obtains all table sets that are available for use in the given model. This includes all sets that are loaded from files setup in this session, and any sets that were previously stored in the model.

`pfcSelections_ptr`	`ComputeRayIntersections (xreal ApertureRadius, wfcRay_ptr Ray)`
	Returns a list of ray intersections with a model. The function computes the intersection points of both the original ray and its "negative" with the geometry of the model. The output array is sorted in order of increasing signed distance.

`void`	`ConvertOldXSectionsToNew ()`
	Convert all legacy cross sections to features

`void`	`CopyLayerRules (xrstring LayerName, pfcModel_ptr RefModel)`
	Copy the rules of a layer LayerName in ReferenceModel into a layer LayerName in CurrentModel, overwriting any rules <p><b>Note: </b>This function copies both the rules definitions and the rules options set interactively (including option "Associative")

`wfcGTol_ptr`	`CreateGTol (wfcGTolType Type, wfcGTolAttach_ptr GtolAttach, xrstring Value)`
	Creates new Gtol with specified placement and value string

`wfcSetDatumTag_ptr`	`CreateSetDatumTag (pfcSelection_ptr Selection, xrstring Label, optional wfcAnnotationPlane_ptr Plane)`
	LICENSE: 222 Create a new datum feature symbol annotation.

`wfcSurfaceFinish_ptr`	`CreateSurfaceFinish (pfcDetailSymbolInstInstructions_ptr SymbolInstructions, wfcAnnotationPlane_ptr AnnotPlane)`
	LICENSE: 222 Create a surface finish in the specified model. wfcSurfaceFinish::Show() should be called after creating the surface finish in order for the surface finish to be displayed.

`pfcUnit_ptr`	`CreateUnitByExpression (xrstring UnitName, xrstring UnitExpression)`
	Creates a derived unit.

`void`	`DesignateSymbol (xrstring SymbolName)`


`void`	`ExecuteLayerRules ()`
	Execute the layer rules on the CurrentModel if rules are enabled.

`optional pfcSelections_ptr`	`GenerateSelectionsFromCollection (wfcCollection_ptr Collection)`
	Generates selections based on instructions and rules insided the specified collection object

`wfcAnnotationPlane_ptr`	`GetActiveAnnotationPlane ()`
	Get last used Annotation plane in the specified model.

`optional wfcAnnotationPlane_ptr`	`GetAnnotationPlaneByName (xrstring AnnotPlaneName)`
	Get Annotation plane from specified name.

`optional xstringsequence_ptr`	`GetAnnotationPlanes ()`
	Collect the names of all the named annotation planes in the model.

`optional xstringsequence_ptr`	`GetAnnotationPlanesFromGallery ()`
	Collect the names of all annotation planes in gallery.

`xstring`	`GetDefaultName ()`
	Returns the next available default name for given object type.

`wfcLayerItem_ptr`	`GetLayerItem (wfcLayerType LayerType, xint LayerId)`
	Initializes the layer item structure.

`wfcMdlfileDescriptor_ptr`	`GetMdlfileDescriptor ()`
	Creates a filetype descriptor from the model and returns it.

`wfcModelSubType`	`GetSubType ()`
	Returns the subtype of a model.

`wfcTIMInfo_ptr`	`GetTIMInfo ()`
	Gets the TIM related information of the model

`xbool`	`IsDesignatedSymbol (xrstring SymbolName)`


`xbool`	`IsStandardLocation ()`
	Returns true if the model was loaded from a local folder.

`xbool`	`IsVariantFeatModel ()`
	Identifies if a model pointer is from an inheritance feature or flexible component.

`pfcLayers_ptr`	`ListLayers ()`
	Collects an array containing the layers in the model.

`void`	`MarkATBModelAsOutOfDate (optional xintsequence_ptr FeatIds)`
	Mark the ATB model/feature as out of date.

`void`	`MarkForSaving (xrstring marker)`


`xbool`	`MatchLayerRules (xrstring LayerName, pfcModel_ptr RefModel)`
	Compare the rules of a layer LayerName in ReferenceModel to the rules in layer LayerName in CurrentModel.

`void`	`RefreshMdlTree ()`
	Refreshes the display of the model tree.

`void`	`RelinkATB (xrstring MasterModelPath, optional xint FeatId)`
	Relink the model/feature that have lost the link to the master model. Relinking a model here will represent searching for the master model (using the master model name) in the location specified in the 'MasterModelPath' argument. If the master model with the same name is found, the Creo Parametric TIM model is linked to that master model.

`void`	`RemoveAnnotationPlaneFromGallery (xrstring AnnotPlaneName)`
	Remove annotation plane with specified name from gallery.

`void`	`SaveLayerDisplayStatus ()`
	Permanently saves all the changes to the display status of all layers in the owner, and all its submodels (and views, for drawings).

`void`	`UndesignateSymbol (xrstring SymbolName)`


`void`	`UpdateATB (optional xintsequence_ptr FeatIds, optional xstringsequence_ptr SearchPaths)`
	Update the ATB model(s)/feature(s).

`wfcATBVerificationResults_ptr`	`VerifyATB (optional xintsequence_ptr FeatIds, optional xstringsequence_ptr SearchPaths)`
	To Verify if the ATB models are out of date. This function will first check to see if the model specified is a TIM (of some master model). If model is not a TIM, it will check to see if the model contains one or more features which are TIM representations.

`wfcStatus`	`VisitDetailItems (wfcVisitingClient_ptr visitingClient, pfcDetailType detailType, xint Sheet)`


`wfcStatus`	`VisitItems (wfcVisitingClient_ptr visitingClient, pfcModelItemType itemType)`

Methods Inherited from Class pfcActionSource:: AddActionListener, RemoveActionListener, AddActionListenerWithType

Methods Inherited from Class pfcParent:: GetChild

Methods Inherited from Class pfcParameterOwner:: GetParam, CreateParam, ListParams, SelectParam, CreateParamWithUnits, SelectParameters

Methods Inherited from Class wfcWParameterOwner:: ExportParameterTable, ApplyParameterTableset

Methods Inherited from Class pfcRelationOwner:: DeleteRelations, GetRelations, SetRelations, RegenerateRelations, EvaluateExpression

Methods Inherited from Class wfcWRelationOwner:: GetRelationConstraints, UnitsUsed, UseUnits, EvaluateExpressionWithUnits

Methods Inherited from Class pfcModelItemOwner:: GetItemByName, GetItemById, ListItems

Methods Inherited from Class pfcViewOwner:: RetrieveView, GetView, SaveView, GetCurrentViewTransform, SetCurrentViewTransform, CurrentViewRotate, ListViews, GetCurrentView

Methods Inherited from Class pfcChild:: GetDBParent, GetOId

Methods Inherited from Class pfcModel:: GetDescr, GetRelationId, GetIsModified, GetVersionStamp, GetRevision, GetVersion, GetBranch, GetReleaseLevel, GetCommonName, SetCommonName, IsCommonNameModifiable, GetFullName, GetInstanceName, GetGenericName, GetType, GetFileName, Backup, Copy, CopyAndRetrieve, Rename, Save, Erase, EraseWithDependencies, Delete, Display, DisplayInNewWindow, ListDependencies, ListDeclaredModels, CreateLayer, Export, Import, AccessExternalData, TerminateExternalData, CheckIsSaveAllowed, CheckIsModifiable, GetOrigin, GetPostRegenerationRelations, SetPostRegenerationRelations, RegeneratePostRegenerationRelations, DeletePostRegenerationRelations, CleanupDependencies, IsNativeModel, ExportIntf3D, SetIntf3DLayerSetupFile, IsIntf3DLayerSetupFileIgnored, IsIntf3DCsysIgnored, ClearIntf3DModelData

Method Detail

wfcATBVerificationResults_ptr VerifyATB (optional xintsequence_ptr FeatIds, optional xstringsequence_ptr SearchPaths)

To Verify if the ATB models are out of date. This function will first check to see if the model specified is a TIM (of some master model). If model is not a TIM, it will check to see if the model contains one or more features which are TIM representations.

Exceptions thrown (but not limited to):

pfcXToolkitNoChange - The function successfully verified the model and didn't find any ATB models out of date nor any models of old version nor any models with broken link.

pfcXToolkitNotValid - The function successfully verified the model, found ONE or more models of older version and found no ATB models out of date.

pfcXToolkitBadContext - The function successfully verified the model, found ONE or more models with broken link and found no ATB models out of date and no ATB models of older version

pfcXToolkitUnsupported - The input model is Multi-CAD model.

Manual References:: Interface: Associative Topology Bus Enabled Models and Features, Interface: Associative Topology Bus Enabled Models and Features

Parameters:

FeatIds
SearchPaths

Returns:: ATB verification results object

void MarkATBModelAsOutOfDate (optional xintsequence_ptr FeatIds)

Mark the ATB model/feature as out of date.

Exceptions thrown (but not limited to):

pfcXToolkitUnsupported - The input model is Multi-CAD model.

Manual References:: Interface: Associative Topology Bus Enabled Models and Features, Interface: Associative Topology Bus Enabled Models and Features

Parameters:

FeatIds

Returns:

void UpdateATB (optional xintsequence_ptr FeatIds, optional xstringsequence_ptr SearchPaths)

Update the ATB model(s)/feature(s).

Exceptions thrown (but not limited to):

pfcXToolkitNoChange - The function runs successfully and found no ATB models out of date.

pfcXToolkitCantModify - During ATB update the regeneration failed.

pfcXToolkitBadContext - There are non-displayed models in the session.

pfcXToolkitNotDisplayed - The input model is not displayed.

pfcXToolkitAmbiguous - Both: there are non-displayed models in the session AND the input model is not displayed.

pfcXToolkitUnsupported - The input model is Multi-CAD model.

Manual References:: Interface: Associative Topology Bus Enabled Models and Features, Interface: Associative Topology Bus Enabled Models and Features

Parameters:

FeatIds
SearchPaths

Returns:

void RelinkATB (xrstring MasterModelPath, optional xint FeatId)

Relink the model/feature that have lost the link to the master model. Relinking a model here will represent searching for the master model (using the master model name) in the location specified in the 'MasterModelPath' argument. If the master model with the same name is found, the Creo Parametric TIM model is linked to that master model.

Exceptions thrown (but not limited to):

pfcXToolkitUnsupported - The input model is Multi-CAD model.

Manual References:: Interface: Associative Topology Bus Enabled Models and Features

Parameters:

MasterModelPath
FeatId

Returns:

optional xstringsequence_ptr GetAnnotationPlanesFromGallery ()

Collect the names of all annotation planes in gallery.

Manual References:: Annotations: Annotation Features and Annotations: Annotation Orientation, Annotations: Annotation Features and Annotations: Annotation Orientation

Returns:: Names of annotation planes in the gallery

optional xstringsequence_ptr GetAnnotationPlanes ()

Collect the names of all the named annotation planes in the model.

Manual References:: Annotations: Annotation Features and Annotations: Annotation Orientation, Annotations: Annotation Features and Annotations: Annotation Orientation

Returns:: Names of annotation planes in the model

optional wfcAnnotationPlane_ptr GetAnnotationPlaneByName (xrstring AnnotPlaneName)

Get Annotation plane from specified name.

Manual References:: Annotations: Annotation Features and Annotations: Annotation Orientation, Annotations: Annotation Features and Annotations: Annotation Orientation

Parameters:

AnnotPlaneName: Name of wanted Annotation Plane

Returns:: Annotation plane with specified name.

void AddAnnotationPlaneToGallery (xrstring AnnotPlaneName)

Add annotation plane with specified name to gallery.

Exceptions thrown (but not limited to):

<reference 4 to unknown entity pfcExceptions::pfcXToolkitNotFound> - No annotation plane exists with specified name.

<reference 4 to unknown entity pfcExceptions::pfcXToolkitFound> - Annotation plane with same name already exist in the gallery.

Manual References:: Annotations: Annotation Features and Annotations: Annotation Orientation, Annotations: Annotation Features and Annotations: Annotation Orientation

Parameters:

AnnotPlaneName: Name of the valid annotation plane

Returns:

void RemoveAnnotationPlaneFromGallery (xrstring AnnotPlaneName)

Remove annotation plane with specified name from gallery.

Exceptions thrown (but not limited to):

<reference 4 to unknown entity pfcExceptions::pfcXToolkitNotFound> - No annotation plane exists with specified name.

Manual References:: Annotations: Annotation Features and Annotations: Annotation Orientation, Annotations: Annotation Features and Annotations: Annotation Orientation

Parameters:

AnnotPlaneName: Name of the valid annotation plane

Returns:

wfcAnnotationPlane_ptr GetActiveAnnotationPlane ()

Get last used Annotation plane in the specified model.

Manual References:: Annotations: Annotation Features and Annotations: Annotation Orientation

Returns:: Returns wfcAnnotationPlane_ptr

wfcTIMInfo_ptr GetTIMInfo ()

Gets the TIM related information of the model

Manual References:: Interface: Associative Topology Bus Enabled Models and Features, Interface: Associative Topology Bus Enabled Models and Features

Returns:: The TIM information object

void ConvertOldXSectionsToNew ()

Convert all legacy cross sections to features

Manual References:: Cross Sections: Creating and Modifying Cross Sections, Cross Sections: Creating and Modifying Cross Sections

Returns:

xbool CanCreateSectionFeature ()

Determines if Cross Section can be created as feature in specified model

Manual References:: Cross Sections: Creating and Modifying Cross Sections, Cross Sections: Creating and Modifying Cross Sections

Returns:: true if Cross Section can be created as feature in specified model

pfcLayers_ptr ListLayers ()

Collects an array containing the layers in the model.

Exceptions thrown (but not limited to):

pfcXToolkitNotFound - No layers were found and collected.

Manual References:: ModelItem: Layer State, ModelItem: Layer State

Returns:

void SaveLayerDisplayStatus ()

Permanently saves all the changes to the display status of all layers in the owner, and all its submodels (and views, for drawings).

Exceptions thrown (but not limited to):

pfcXToolkitNoChange - No layers have been changed since the last save.

Manual References:: ModelItem: Layer State, ModelItem: Layer State

Returns:

wfcLayerItem_ptr GetLayerItem (wfcLayerType LayerType, xint LayerId)

Initializes the layer item structure.

Exceptions thrown (but not limited to):

pfcXToolkitNotExist - Item with such identifier and type does not exist.

Manual References:: ModelItem: Layer State, ModelItem: Layer State

Parameters:

LayerType
LayerId

Returns:

wfcModelSubType GetSubType ()

Returns the subtype of a model.

Exceptions thrown (but not limited to):

pfcXToolkitBadContext - The model has no subtype.

Manual References:: Models: Model Information

Returns:: subtype of the model

xstring GetDefaultName ()

Returns the next available default name for given object type.

Exceptions thrown (but not limited to):

pfcXToolkitUnsupported - the type is not supported.

Manual References:: Models: Model Information, Models: Model Information

Returns:: The default Name.

xbool IsVariantFeatModel ()

Identifies if a model pointer is from an inheritance feature or flexible component.

Manual References:: Assemblies and Components: Variant Feature Model

Returns:: xtrue if model pointer is inheritance feature otherwise false.

pfcUnit_ptr CreateUnitByExpression (xrstring UnitName, xrstring UnitExpression)

Creates a derived unit.

Exceptions thrown (but not limited to):

pfcXToolkitNotFound - The reference unit was not found in the model.

Manual References:: Solid: Accessing Individual Units, Solid: Accessing Individual Units

Parameters:

UnitName: The unit name.
UnitExpression: The unit expression.

Returns:

pfcSelections_ptr ComputeRayIntersections (xreal ApertureRadius, wfcRay_ptr Ray)

Returns a list of ray intersections with a model. The function computes the intersection points of both the original ray and its "negative" with the geometry of the model. The output array is sorted in order of increasing signed distance.

Exceptions thrown (but not limited to):

pfcXToolkitNotFound - No objects were found in the workspace.

Manual References:: Geometry Evaluation: Tracing a Ray, Geometry Evaluation: Tracing a Ray

Parameters:

ApertureRadius: The value of aperture_radius.
Ray: The starting point of the ray.

Returns:

wfcParamTablesets_ptr CollectParamTablesets ()

Obtains all table sets that are available for use in the given model. This includes all sets that are loaded from files setup in this session, and any sets that were previously stored in the model.

Exceptions thrown (but not limited to):

pfcXToolkitNotFound - No parameter table sets are available for this model.

Returns:: The wfcModelItem::ParamTablesets object

optional pfcSelections_ptr GenerateSelectionsFromCollection (wfcCollection_ptr Collection)

Generates selections based on instructions and rules insided the specified collection object

Exceptions thrown (but not limited to):

pfcXToolkitOutOfMemory - There was a memory error.

pfcXToolkitAmbiguous - The curve collection chain cannot be regenerated because there is an ambiguity which could not be resolved.

pfcXToolkitNotFound - The curve collection chain cannot be regenerated because a reference could not be found while collecting edges/curves/points.

pfcXToolkitNotValid - The checking of the curve collection failed.

Manual References:: Curve and Surface Collection: The wfcCollection Interface

Parameters:

Collection

Returns:: A sequence of selection objects

void MarkForSaving (xrstring marker)

Exceptions thrown (but not limited to):

pfcXExternalDataTKError - The function failed.

pfcXExternalDataInvalidObject - The specified model or class name is invalid.

pfcXExternalDataClassOrSlotExists - The specified class name already exists.

pfcXExternalDataNamesTooLong - The specified class name exceeds the length 32 Chars.

Parameters:

marker

Returns:

void RefreshMdlTree ()

Refreshes the display of the model tree.

Exceptions thrown (but not limited to):

pfcXToolkitNotFound - The model tree is not present.

Returns:

wfcMdlfileDescriptor_ptr GetMdlfileDescriptor ()

Creates a filetype descriptor from the model and returns it.

The created descriptor has no information about the initial descriptor used to create this model. It contains the model name stripped of its extension, version and location.

Exceptions thrown (but not limited to):

pfcXToolkitInvalidPtr - the model argument does not represent a correct model.

Returns:

xbool IsStandardLocation ()

Returns true if the model was loaded from a local folder.

Exceptions thrown (but not limited to):

pfcXBadArgument - the model is null.

Manual References:: Models: Model Operations

Returns:

void DesignateSymbol (xrstring SymbolName)

Exceptions thrown (but not limited to):

pfcXToolkitNoChange - The symbol is already designated.

Manual References:: Annotations: Annotation Features and Annotations: Designating Dimensions and Symbols, Annotations: Annotation Features and Annotations: Designating Dimensions and Symbols

Parameters:

SymbolName

Returns:

void UndesignateSymbol (xrstring SymbolName)

Exceptions thrown (but not limited to):

pfcXToolkitNoChange - The symbol is not currently designated.

Manual References:: Annotations: Annotation Features and Annotations: Designating Dimensions and Symbols

Parameters:

SymbolName

Returns:

xbool IsDesignatedSymbol (xrstring SymbolName)

Manual References:: Annotations: Annotation Features and Annotations: Designating Dimensions and Symbols, Annotations: Annotation Features and Annotations: Designating Dimensions and Symbols

Parameters:

SymbolName

Returns:

wfcStatus VisitItems (wfcVisitingClient_ptr visitingClient, pfcModelItemType itemType)

Exceptions thrown (but not limited to):

pfcXToolkitNotFound - Either no supported items exist, or they were all filtered out by the filter function.

Manual References:: Overview of Creo Object TOOLKIT C++: Visit Methods, Overview of Creo Object TOOLKIT C++: Visit Methods

Parameters:

visitingClient
itemType

Returns:

wfcStatus VisitDetailItems (wfcVisitingClient_ptr visitingClient, pfcDetailType detailType, xint Sheet)

Exceptions thrown (but not limited to):

pfcXToolkitNotFound - Either no supported items exist, or they were all filtered out by the filter function.

Manual References:: Overview of Creo Object TOOLKIT C++: Visit Methods

Parameters:

visitingClient
detailType
Sheet

Returns:

wfcSurfaceFinish_ptr CreateSurfaceFinish (pfcDetailSymbolInstInstructions_ptr SymbolInstructions, wfcAnnotationPlane_ptr AnnotPlane)

LICENSE: 222

Create a surface finish in the specified model. wfcSurfaceFinish::Show() should be called after creating the surface finish in order for the surface finish to be displayed.

Exceptions thrown (but not limited to):

pfcXToolkitInvalidType - Invalid type of leader or attachment for creation of a surface finish.

pfcXToolkitFound - Leader or attachment to surface which already has a surface finish.

pfcXToolkitNoLicense - License check failure

Manual References:: Annotations: Annotation Features and Annotations: Surface Finish Annotations

Parameters:

SymbolInstructions

The symbol instance instructions. This data must contain:

Zero or more leaders pointing to model surfaces, or, a model surface used for the attachment point.

An annotation plane (for solid owned surface finishes).

Optionally, variant texts for the surface finish.

Consult the Creo Parametric TOOLKIT user's guide for information about how to find the standard surface finish symbols in order to use them during creation.

AnnotPlane

Returns:: The created surface finish.

wfcGTol_ptr CreateGTol (wfcGTolType Type, wfcGTolAttach_ptr GtolAttach, xrstring Value)

Creates new Gtol with specified placement and value string

Parameters:

Type: Type of GTol to create
GtolAttach: The GTol Attachment
Value: The GTol value text

Returns:: The Created GTol

wfcSetDatumTag_ptr CreateSetDatumTag (pfcSelection_ptr Selection, xrstring Label, optional wfcAnnotationPlane_ptr Plane)

LICENSE: 222

Create a new datum feature symbol annotation.

Manual References:: Annotations: Annotation Features and Annotations: Accessing Set Datum Tags, Annotations: Annotation Features and Annotations: Accessing Set Datum Tags

Parameters:

Selection
Label
Plane

Returns:: Returns wfcSetDatumTag_ptr

xbool MatchLayerRules (xrstring LayerName, pfcModel_ptr RefModel)

Compare the rules of a layer LayerName in ReferenceModel to the rules in layer LayerName in CurrentModel.

Manual References:: ModelItem: Layer Operations, ModelItem: Layer Operations

Parameters:

LayerName: Layer Name
RefModel: Reference Model with which rule will be matched

Returns:: return description

void CopyLayerRules (xrstring LayerName, pfcModel_ptr RefModel)

Copy the rules of a layer LayerName in ReferenceModel into a layer LayerName in CurrentModel, overwriting any rules <p><b>Note: </b>This function copies both the rules definitions and the rules options set interactively (including option "Associative")

Manual References:: ModelItem: Layer Operations, ModelItem: Layer Operations

Parameters:

LayerName: Layer Name
RefModel: Reference Model from which rule will be copied

Returns:

void ExecuteLayerRules ()

Execute the layer rules on the CurrentModel if rules are enabled.

Manual References:: ModelItem: Layer Operations, ModelItem: Layer Operations

Returns: