SolidWorksMakroprogrammierung

Methode · Annotation

SetName-Methode (Annotation)

Gibt einer Beschriftung einen neuen Namen. Der Name muss eindeutig sein.

Syntax

Function SetName( _
   ByVal NameIn As String _
) As Boolean
bErfolg = swAnn.SetName(NameIn)

Parameter

NameInStringByVal
Der neue Name, eindeutig im Dokument.

Rückgabewert

True, wenn der Name geändert wurde, sonst False.

Beispiel

' swAnn ist die Beschriftung (Annotation) einer Notiz, etwa aus der Auswahl.
If swAnn.SetName("Prüfhinweis") Then
    Debug.Print "Neuer Name: " & swAnn.GetName
Else
    Debug.Print "Name schon vergeben oder nicht erlaubt"
End If

Bemerkungen

Der Befehl prüft vor dem Umbenennen, ob der Name eindeutig ist. Gibt es ihn schon, liefert er False. Die Hilfe hat dazu das Beispiel „Get and Set Name of Note“.

Eindeutig sein muss der Name nur innerhalb von Blatt oder Ansicht: Eine Notiz auf dem Blatt darf so heißen wie eine Bemaßung in einer Zeichenansicht. Vorsicht bei Modellbemaßungen in einer Zeichnung: Der neue Name gilt auch im Modell.

Siehe auch

Verfügbarkeit

SOLIDWORKS 99

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

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