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 LongnStatus = 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 IfBemerkungen
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.