SolidWorksMakroprogrammierung

Methode · View

GetDimensionDisplayString5-Methode (View)

Liefert alle Texte der Bemaßungen einer Zeichenansicht oder eines Blatts, getrennt nach Wert, Abweichungen, Präfix, Suffix und Zusatztexten.

Syntax

Function GetDimensionDisplayString5( _
   ByRef DimensionSize As Long _
) As Variant
vTexte = swView.GetDimensionDisplayString5(lProBemassung)

Parameter

DimensionSizeLongByRef · Rückgabe
Hier schreibt SOLIDWORKS hinein, wie viele Texte im Array zu jeder Bemaßung gehören. Nach dem Aufbau unten sind es 11. Rechne trotzdem mit dem gelieferten Wert.

Rückgabewert

Array mit String-Werten, DimensionSize Texte für jede Bemaßung, eine Bemaßung nach der anderen. Die Texte einer Bemaßung, gezählt ab 0:

  • 0: Hauptwert der Bemaßung
  • 1 und 2: obere und untere Abweichung zum Hauptwert
  • 3: zweiter Wert bei doppelter Bemaßung
  • 4 und 5: obere und untere Abweichung zum zweiten Wert
  • 6: Präfix, der Text vor dem Wert
  • 7: Suffix, der Text nach dem Wert
  • 8: Text über Präfix, Wert und Suffix
  • 9: Text darunter
  • 10: Text ganz unten, unter Text 9

Was eine Bemaßung nicht benutzt, kommt als leerer Text "". Die Texte 6 bis 9 gibst du im PropertyManager der Bemaßung im ersten Feld für den Bemaßungstext ein, Text 10 im zweiten.

Beispiel

' swView ist eine Zeichenansicht (View), etwa aus DrawingDoc.ActiveDrawingView oder der Auswahl.
Dim vTexte As Variant
Dim lProBemassung As Long
Dim i As Long
vTexte = swView.GetDimensionDisplayString5(lProBemassung)
If IsArray(vTexte) And lProBemassung > 0 Then
    For i = 0 To UBound(vTexte) Step lProBemassung
        Debug.Print vTexte(i + 6) & vTexte(i) & vTexte(i + 7) & "   Abweichung " & vTexte(i + 1) & " / " & vTexte(i + 2)
    Next i
End If

Bemerkungen

Hängende Bemaßungen liefert der Befehl mit, ohne sie zu kennzeichnen. Der veraltete View.GetDimensionDisplayString2 hat sie erkannt und weggelassen. Ob eine einzelne Bemaßung hängt, prüfst du mit Annotation.IsDangling.

Bohrungsbeschreibungen unterstützt der Befehl nicht. Die Hilfe nennt das aktuelle Blatt oder die aktuelle Zeichenansicht, gemeint ist vermutlich also das View-Objekt, für das du ihn aufrufst. Die Texte einer einzelnen Bemaßung liefert DisplayDimension.GetText.

Ersetzt View.GetDimensionDisplayString4. Der lieferte 10 Texte pro Bemaßung, ohne den Text ganz unten.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2024 SP02

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

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