SolidWorksMakroprogrammierung

Methode · ModelDocExtension

GetPersistReference3-Methode (ModelDocExtension)

Liefert eine dauerhafte ID für ein Objekt, mit der du es später wiederfindest, auch nach Neuaufbau oder Neustart.

Syntax

Function GetPersistReference3( _
   ByVal DispObj As Object _
) As Variant
vId = swModel.Extension.GetPersistReference3(swFace)

Parameter

DispObjObjectByVal
Das Objekt, etwa eine Fläche, Kante oder ein Feature.

Rückgabewert

Array mit der ID (Bytes). Speichern lässt es sich zum Beispiel in einer Datei oder einem Attribut.

Beispiel

' swModel ist das aktive Teil, eine Fläche ist ausgewählt.
Dim swFace As SldWorks.Face2
Dim vId As Variant, nStatus As Long
Set swFace = swModel.SelectionManager.GetSelectedObject6(1, -1)
vId = swModel.Extension.GetPersistReference3(swFace)
swModel.ClearSelection2 True
' ... später, etwa nach einem Neuaufbau ...
Set swFace = swModel.Extension.GetObjectByPersistReference3(vId, nStatus)
If nStatus = swPersistReferencedObject_Ok Then swFace.Select4 False, Nothing

Bemerkungen

Zeiger auf Flächen und Kanten werden beim Neuaufbau ungültig, die ID bleibt gültig. Sie gehört zum Modell. Der Inhalt des Arrays kann sich zwischen SOLIDWORKS-Versionen ändern, das Wiederfinden mit ModelDocExtension.GetObjectByPersistReference3 funktioniert trotzdem. IDs der veralteten Vorgänger (GetPersistReference ohne 3) passen nicht dazu.

Zwei IDs vergleichst du mit ModelDocExtension.IsSamePersistentID, nicht Byte für Byte.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2007 SP03

Englisches Original: IModelDocExtension::GetPersistReference3 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.