SolidWorksMakroprogrammierung

Objekt · SldWorks

DisplayDimension-Objekt

Steht für eine angezeigte Bemaßung, im Modell oder in einer Zeichnungsansicht. Den Wert liefert die Dimension dahinter.

Deklaration Dim x As SldWorks.DisplayDimension · in der englischen .NET-Hilfe: IDisplayDimension

Beschreibung

SOLIDWORKS kann dieselbe Bemaßung mehrfach anzeigen. Zum Beispiel kann die Tiefe einer Extrusion in drei Ansichten einer Zeichnung erscheinen. Das sind dann drei DisplayDimension-Objekte, aber nur eine Dimension.

Die DisplayDimension betrifft die Anzeige. Name und Wert stehen in der Dimension, die du mit DisplayDimension.GetDimension2 bekommst. Wer einen Wert lesen oder ändern will, geht fast immer diesen Weg.

Zugriff

Beispiel

' Vergrößert die ausgewählte Bemaßung um 10 mm und baut das Teil neu auf.
' Vorbedingung: In einem Teil ist eine Längenbemaßung angeklickt.
' Ergebnis:     Die Bemaßung ist 10 mm größer.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swDispDim As SldWorks.DisplayDimension
    Dim swDim As SldWorks.Dimension
    Dim vWert As Variant

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSelMgr = swModel.SelectionManager

    If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelDIMENSIONS Then
        swApp.SendMsgToUser2 "Bitte eine Bemaßung anklicken.", swMbWarning, swMbOk
        Exit Sub
    End If

    Set swDispDim = swSelMgr.GetSelectedObject6(1, -1)
    Set swDim = swDispDim.GetDimension2(0)
    vWert = swDim.GetSystemValue3(swThisConfiguration, Empty)
    If swDim.SetSystemValue3(vWert(0) + 0.01, swSetValue_InThisConfiguration, Empty) = swSetValue_Successful Then
        swModel.EditRebuild3
    End If
End Sub

Bemerkungen

Das Beispiel rechnet in Metern mit Dimension.GetSystemValue3 und Dimension.SetSystemValue3. So stimmen die 10 mm auch dann, wenn das Dokument in Zoll eingestellt ist. Bei einer Winkelbemaßung würde dasselbe Makro 0,01 (im Bogenmaß) addieren.

SOLIDWORKS speichert viele Eigenschaften einer Bemaßung in der Dimension, nicht in der DisplayDimension. Auf der DisplayDimension liegen vor allem Befehle für die Darstellung, etwa für Text und Toleranzanzeige.

Eigenschaften und Methoden

Eigenschaften 39, davon 38 beschrieben, 1 veraltet

NameBeschreibung
ArcExtensionLineOrOppositeSideLiefert oder setzt, ob die Maßlinie einer Radiusbemaßung an der Bogenverlängerung ansetzt oder zur anderen Seite des Bogens verlängert wird.
ArrowSideLiefert oder setzt, ob die Maßpfeile innen, außen oder automatisch zwischen den Maßhilfslinien stehen.
BrokenLeaderOhne Beschreibung in der Hilfe. Dem Namen nach: ob die Maßlinie für den Maßtext unterbrochen ist.
CenterTextLiefert oder setzt, ob der Maßtext automatisch mittig steht.
ChamferPrecisionLiefert oder setzt die Nachkommastellen von Länge oder Winkel einer Fasenbemaßung.
ChamferTextStyleLiefert oder setzt, wie der Text einer Fasenbemaßung aufgebaut ist, etwa „Abstand x Winkel“.
DiametricLiefert oder setzt, ob eine Bemaßung als Durchmesser (doppelter Abstand) oder als Radius (einfacher Abstand) erscheint.
DimensionToInsideLiefert oder setzt, ob eine Radiusbemaßung immer zur Innenseite des Bogens zeigt.
DisplayAsChainLiefert oder setzt, ob die Maßhilfslinien einer Koordinaten- oder Winkelkettenbemaßung verbunden sind.
DisplayAsLinearLiefert oder setzt, ob eine Durchmesserbemaßung als lineare Bemaßung erscheint.
ElevationLiefert oder setzt, ob am Ende der Maßhilfslinien einer Koordinatenbemaßung ein Höhensymbol erscheint.
EndSymbolLiefert oder setzt das Endsymbol einer Koordinatenbemaßung.
ExtensionLineExtendsFromCenterOfSetOhne Beschreibung in der Hilfe. Dem Namen nach: ob die Maßhilfslinien von der Mitte eines Satzes ausgehen.
ExtensionLineSameAsLeaderStyleLiefert oder setzt, ob die Maßhilfslinien denselben Linienstil wie die Maßlinien haben.
ExtensionLineUseDocumentDisplayLiefert oder setzt, ob die Maßhilfslinien die Einstellungen des Dokuments nutzen.
ForeshortenedLiefert oder setzt, ob eine Längenbemaßung in einer Zeichnung verkürzt dargestellt wird.
GridBubbleLiefert oder setzt, ob am Ende der Maßhilfslinien einer Koordinatenbemaßung ein Rasterkreis (Grid Bubble) erscheint.
HorizontalJustificationLiefert oder setzt die waagerechte Ausrichtung des Maßtexts.
InspectionLiefert oder setzt, ob der Maßtext über der Maßlinie als Prüfmaß (im Oval) erscheint.
IsLinkedLiefert, ob mit einer Bemaßung Text verknüpft ist.
JoggedLiefert oder setzt, ob eine Koordinaten- oder Winkelkettenbemaßung geknickt ist.
LeaderVisibilityLiefert oder setzt, welche Maßlinien einer Bemaßung sichtbar sind.
LowerInspectionLiefert oder setzt, ob der Maßtext unter der Maßlinie als Prüfmaß (im Oval) erscheint.
MarkedForDrawingLiefert oder setzt, ob eine Bemaßung für die Übernahme in Zeichnungen markiert ist.
MaxWitnessLineLengthLiefert oder setzt die größte Länge der Maßhilfslinien.
OffsetTextLiefert oder setzt, ob der Maßtext frei an einer Bezugslinie hängt, statt auf der Maßlinie zu stehen.
RunBidirectionallyLiefert oder setzt, ob eine Winkelkettenbemaßung in beide Richtungen von der Basis aus misst.
Scale2Liefert oder setzt einen Faktor, mit dem eine nicht assoziative Abstandsbemaßung ihren Wert multipliziert.
ShortenedRadiusLiefert oder setzt, ob eine Radiusbemaßung verkürzt erscheint: Die Maßlinie endet kurz vor dem Mittelpunkt.
ShowDimensionValueLiefert oder setzt, ob der Maßwert im Maßtext erscheint.
ShowLowerParenthesisLiefert oder setzt, ob der Text unter der Maßlinie in Klammern steht.
ShowParenthesisLiefert oder setzt, ob der Text über der Maßlinie in Klammern steht, etwa für Hilfsmaße.
ShowTolParenthesisveraltet ersetzt durch DisplayDimension.ShowParenthesis
SmartWitnessLiefert oder setzt die intelligente Darstellung der Maßhilfslinien.
SolidLeaderLiefert oder setzt, ob Bogen- und Radiusbemaßungen eine durchgehende Maßlinie haben.
SplitLiefert oder setzt, ob eine Doppelbemaßung (zwei Einheiten) über und unter einer durchgehenden Maßlinie steht.
Type2Liefert die Art einer Bemaßung, etwa linear, Winkel, Radius oder Durchmesser.
VerticalJustificationLiefert die senkrechte Ausrichtung des Maßtexts.
WitnessVisibilityLiefert oder setzt, welche Maßhilfslinien sichtbar sind.

Methoden 93, davon 72 beschrieben, 21 veraltet

NameBeschreibung
AddDisplayEntZeichnet vorübergehend eigene Grafik (Linie, Bogen, Kreis, Fläche) an Stelle der Bemaßung.
AddDisplayTextZeigt vorübergehend eigenen Text an Stelle des Maßtexts.
AlignToEdgeRichtet eine Längenbemaßung an einer Kante aus.
AutoJogOrdinateKnickt eine Koordinatenbemaßung automatisch, damit sich Texte nicht überlappen.
ExplementaryAngleKlappt eine Winkelbemaßung auf den Ergänzungswinkel zu 360° um.
GetAlternatePrecisionveraltet ersetzt durch DisplayDimension.GetAlternatePrecision2
GetAlternatePrecision2Liefert die Nachkommastellen des zweiten Werts einer Doppelbemaßung.
GetAlternateTolPrecisionveraltet ersetzt durch DisplayDimension.GetAlternateTolPrecision2
GetAlternateTolPrecision2Liefert die Nachkommastellen der Toleranz beim zweiten Wert einer Doppelbemaßung.
GetAnnotationLiefert die Annotation einer Bemaßung, mit der du etwa Position, Sichtbarkeit oder Layer bearbeitest.
GetArcLengthLeaderLiefert die Art der Maßlinien einer Bogenlängenbemaßung: parallel oder radial.
GetArrowHeadStyleveraltet ersetzt durch DisplayDimension.GetArrowHeadStyle2
GetArrowHeadStyle2Liefert die Pfeilart der beiden Maßpfeile.
GetAutoArcLengthLeaderLiefert, ob SOLIDWORKS die Art der Maßlinien einer Bogenlängenbemaßung selbst wählt.
GetBentLeaderLengthLiefert die Länge der geknickten Maßlinie.
GetBrokenLeader2Liefert, ob die Maßlinie für den Text unterbrochen ist und wie der Text steht.
GetChamferUnitsLiefert die eigenen Einheiten von Länge und Winkel einer Fasenbemaßung.
GetDefinitionTransformLiefert die Transformation einer Bemaßung.
GetDimensionveraltet ersetzt durch DisplayDimension.GetDimension2
GetDimension2Liefert die Bemaßung mit Name und Wert, die hinter einer angezeigten Bemaßung steht.
GetDisplayDataLiefert die Darstellungsdaten einer Bemaßung: Linien, Bögen, Pfeile und Texte, so wie sie gezeichnet werden.
GetExtensionLineAsCenterlineLiefert, ob eine Maßhilfslinie als Mittellinie dargestellt ist.
GetFractionBaseLiefert, ob eine Bemaßung als Dezimalzahl oder als Bruch erscheint.
GetFractionValueLiefert den größten Nenner, mit dem eine Bemaßung als Bruch erscheint, etwa 32 für 1/32.
GetHoleCalloutVariablesLiefert die Variablen einer Bohrungsbeschreibung, etwa Durchmesser und Tiefe.
GetJogParametersLiefert, ob und wie eine Maßhilfslinie einer Längenbemaßung geknickt ist.
GetLinkedTextLiefert den Namen, über den eine Bemaßung mit anderen verknüpft ist.
GetLowerTextLiefert den Text unter der Maßlinie.
GetNameForSelectionLiefert den Namen einer Bemaßung so, wie SelectByID2 ihn erwartet.
GetNextveraltet ersetzt durch DisplayDimension.GetNext5
GetNext2veraltet ersetzt durch DisplayDimension.GetNext5
GetNext3veraltet ersetzt durch DisplayDimension.GetNext5
GetNext4veraltet ersetzt durch DisplayDimension.GetNext5
GetNext5Liefert die nächste Bemaßung in einer Zeichenansicht.
GetOrdinateDimensionArrowSizeLiefert den Durchmesser des Kreises am Nullpunkt einer Koordinatenbemaßung (Norm DIN).
GetOverrideLiefert, ob eine Bemaßung einen festen Ersatzwert statt des echten Werts zeigt.
GetOverrideValueLiefert den Ersatzwert, den eine Bemaßung statt des echten Werts zeigt.
GetPrimaryPrecisionveraltet ersetzt durch DisplayDimension.GetPrimaryPrecision2
GetPrimaryPrecision2Liefert die Nachkommastellen des Maßwerts.
GetPrimaryTolPrecisionveraltet ersetzt durch DisplayDimension.GetPrimaryTolPrecision2
GetPrimaryTolPrecision2Liefert die Nachkommastellen der Toleranz.
GetRoundToFractionLiefert, ob der Maßwert auf einen darstellbaren Bruch gerundet wird.
GetSecondArrowLiefert, ob eine Durchmesserbemaßung den zweiten äußeren Pfeil zeigt.
GetSupportsGenericTextLiefert, ob eine Bemaßung mit SOLIDWORKS 2011 oder neuer angelegt wurde und ihr Text deshalb „generischer Text“ ist.
GetTextLiefert einen Teil des Maßtexts, etwa den Text vor oder nach dem Wert.
GetTextFormatveraltet ersetzt durch Annotation.GetTextFormat
GetTextFormatItemsLiefert die Platzhalter eines Textteils, etwa <DIM>, und ihre ausgewerteten Werte.
GetTypeveraltet ersetzt durch DisplayDimension.Type2
GetUnitsLiefert die eigene Einheit einer Bemaßung.
GetUseDocArrowHeadStyleLiefert, ob eine Bemaßung die Pfeilart des Dokuments nutzt.
GetUseDocBentLeaderLengthLiefert, ob eine Bemaßung die Knicklänge des Dokuments nutzt.
GetUseDocBrokenLeaderLiefert, ob eine Bemaßung die Einstellung des Dokuments für unterbrochene Maßlinien nutzt.
GetUseDocDualLiefert, ob die Doppelbemaßung so liegt (oben, unten, rechts, links) wie im Dokument eingestellt.
GetUseDocPrecisionveraltet
GetUseDocSecondArrowLiefert, ob eine Durchmesserbemaßung für den zweiten Pfeil die Einstellung des Dokuments nutzt.
GetUseDocTextFormatveraltet ersetzt durch Annotation.GetUseDocTextFormat
GetUseDocUnitsLiefert, ob eine Bemaßung die Einheiten des Dokuments nutzt.
GetWitnessLineGapLiefert den Abstand einer Maßhilfslinie zum bemaßten Element.
IsDimXpertveraltet ersetzt durch Annotation.IsDimXpert
IsHoleCalloutLiefert, ob eine Bemaßung eine Bohrungsbeschreibung ist.
IsReferenceDimLiefert, ob eine Bemaßung eine Referenzbemaßung ist.
ResetExtensionLineStyleSetzt den Stil einer Maßhilfslinie zurück, etwa nachdem sie zur Mittellinie gemacht wurde.
SetArcLengthLeaderLegt fest, ob die Maßlinien einer Bogenlängenbemaßung parallel oder radial sind.
SetArrowHeadStyleveraltet ersetzt durch DisplayDimension.SetArrowHeadStyle2
SetArrowHeadStyle2Legt die Pfeilart der beiden Maßpfeile fest.
SetBentLeaderLengthLegt die Länge der geknickten Maßlinie fest.
SetBrokenLeader2Legt fest, ob die Maßlinie für den Text unterbrochen ist und wie der Text steht.
SetDualveraltet ersetzt durch DisplayDimension.SetDual2
SetDual2Legt die Lage einer Doppelbemaßung und die Rundung ihrer Toleranzen fest.
SetExtensionLineAsCenterlineStellt eine Maßhilfslinie als Mittellinie dar oder wieder normal.
SetHorizontalStellt eine Längenbemaßung waagerecht.
SetJogParametersKnickt eine Maßhilfslinie einer Längenbemaßung.
SetLineFontDimensionStyleLegt die Linienart der Maßlinien einer Bemaßung fest.
SetLineFontDimensionThicknessLegt die Linienstärke der Maßlinien einer Bemaßung fest.
SetLineFontExtensionStyleLegt die Linienart der Maßhilfslinien einer Bemaßung fest.
SetLineFontExtensionThicknessLegt die Linienstärke der Maßhilfslinien einer Bemaßung fest.
SetLinkedTextVerknüpft eine Bemaßung über einen gemeinsamen Namen mit anderen Bemaßungen.
SetLowerTextSetzt den Text unter der Maßlinie.
SetOrdinateDimensionArrowSizeSetzt den Durchmesser des Kreises am Nullpunkt einer Koordinatenbemaßung (Norm DIN).
SetOverrideLässt eine Bemaßung in einer Zeichnung einen festen Ersatzwert statt des echten Werts zeigen.
SetPrecisionveraltet ersetzt durch DisplayDimension.SetPrecision3
SetPrecision2veraltet ersetzt durch DisplayDimension.SetPrecision3
SetPrecision3Legt die Nachkommastellen von Maßwert, zweitem Wert und Toleranzen fest.
SetSecondArrowSchaltet den zweiten äußeren Pfeil einer Durchmesserbemaßung ein oder aus.
SetTextSetzt einen Teil des Maßtexts, etwa den Text vor oder nach dem Wert.
SetTextFormatveraltet ersetzt durch Annotation.SetTextFormat
SetUnitsveraltet ersetzt durch DisplayDimension.SetUnits2
SetUnits2Legt Einheit, Bruch- oder Dezimaldarstellung und Rundung einer Bemaßung fest.
SetVerticalStellt eine Längenbemaßung senkrecht.
SetWitnessLineGapSetzt den Abstand einer Maßhilfslinie zum bemaßten Element.
SupplementaryAngleÄndert eine Winkelbemaßung auf den Nebenwinkel: innen wird außen und umgekehrt.
UnlinkLöst die Verknüpfung einer Bemaßung mit anderen.
VerticallyOppositeAngleKlappt eine Winkelbemaßung auf den Scheitelwinkel um.

Nicht aufgeführt sind 10 C++-Varianten (Namen mit I davor, zum Beispiel IAddDisplayEnt). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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