SolidWorksMakroprogrammierung

Methode · PartDoc

SetEntityName-Methode (PartDoc)

Gibt einer Fläche, Kante oder Ecke einen Namen, wenn sie noch keinen hat.

Syntax

Function SetEntityName( _
   ByVal Entity As Object, _
   ByVal StringValue As String _
) As Boolean
bErfolg = swPart.SetEntityName(swFace, "Dichtflaeche")

Parameter

EntityObjectByVal
Fläche, Kante oder Ecke.
StringValueStringByVal
Der Name, eindeutig im Teil.

Rückgabewert

True, wenn gesetzt. False, wenn das Element schon einen Namen hat oder der Name nicht eindeutig ist.

Beispiel

' swPart ist das PartDoc, etwa per Set swPart = swModel.
' swFace ist eine Fläche des Teils.
If swPart.GetEntityName(swFace) = "" Then
    If False = swPart.SetEntityName(swFace, "Dichtflaeche") Then Debug.Print "Name schon vergeben"
End If

Bemerkungen

Der Befehl ändert keinen vorhandenen Namen, damit Verweise nicht versehentlich brechen. Prüfe deshalb vorher, ob es schon einen Namen gibt, und nutze ihn. Die Namen von Flächen, Kanten und Eckpunkten gehören zum Teil. Baugruppen können über diese Namen auf das Teil verweisen, etwa bei Verknüpfungen. Ändern oder löschen von Namen kann solche Verweise zerstören.

Siehe auch

Verfügbarkeit

SOLIDWORKS 99

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

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