SolidWorksMakroprogrammierung

Methode · DrSection

SetLabel2-Methode (DrSection)

Setzt die Bezeichnung der Schnittansicht, etwa „B“, und meldet, ob sie schon vergeben ist.

Syntax

Function SetLabel2( _
   ByVal Label As String _
) As Long
nStatus = swSchnitt.SetLabel2("B")

Parameter

LabelStringByVal
Die neue Bezeichnung der Schnittansicht.

Rückgabewert

Ein Wert aus swSetSectionLabelStatus_e, siehe Bemerkungen.

Beispiel

' swSchnitt ist eine Schnittlinie (DrSection), etwa aus View.GetSection.
Dim nStatus As Long
nStatus = swSchnitt.SetLabel2("B")
If nStatus < 0 Then
    Debug.Print "Bezeichnung nicht gesetzt (" & nStatus & ")"
ElseIf nStatus = swSetSectionLabel_DuplicateLabelWarning Then
    Debug.Print "Bezeichnung gesetzt, ist aber doppelt: " & swSchnitt.GetLabel
Else
    Debug.Print "Neue Bezeichnung: " & swSchnitt.GetLabel
End If

Bemerkungen

Der Rückgabewert bedeutet:

  • kleiner 0: fehlgeschlagen
  • 0: gesetzt
  • größer 0: gesetzt, aber mit Warnung

Den Wert 1 (swSetSectionLabel_DuplicateLabelWarning) gibt es, wenn die Bezeichnung schon an einer anderen Schnittansicht vergeben ist. Die Bezeichnung wird trotzdem geändert. Die Hilfe schreibt dazu „the drawing standard does allow duplicate section labels“. Gemeint ist dem Zusammenhang nach eine Norm, die doppelte Bezeichnungen nicht erlaubt, denn erlaubt die Norm sie, ist der Wert nach Angabe der Hilfe 0.

Das Hilfebeispiel „Create Section View and Get Some Data“ setzt so die Bezeichnung „ABCD“ und liest sie mit DrSection.GetLabel zurück.

Ersetzt DrSection.SetLabel, das nur True oder False lieferte.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2003 SP02

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

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