Objekt · SldWorks
DisplayDimension-Objekt
Steht für eine angezeigte Bemaßung, im Modell oder in einer Zeichnungsansicht. Den Wert liefert die Dimension dahinter.
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
SelectionMgr.GetSelectedObject6: eine angeklickte Bemaßung, TypswSelDIMENSIONSFeature.GetFirstDisplayDimensionundFeature.GetNextDisplayDimension: alle Bemaßungen eines Features- Befehle, die eine Bemaßung erzeugen, etwa
ModelDoc2.AddVerticalDimension2oderModelDoc2.AddHorizontalDimension2
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| ArcExtensionLineOrOppositeSide | Liefert oder setzt, ob die Maßlinie einer Radiusbemaßung an der Bogenverlängerung ansetzt oder zur anderen Seite des Bogens verlängert wird. |
| ArrowSide | Liefert oder setzt, ob die Maßpfeile innen, außen oder automatisch zwischen den Maßhilfslinien stehen. |
| BrokenLeader | Ohne Beschreibung in der Hilfe. Dem Namen nach: ob die Maßlinie für den Maßtext unterbrochen ist. |
| CenterText | Liefert oder setzt, ob der Maßtext automatisch mittig steht. |
| ChamferPrecision | Liefert oder setzt die Nachkommastellen von Länge oder Winkel einer Fasenbemaßung. |
| ChamferTextStyle | Liefert oder setzt, wie der Text einer Fasenbemaßung aufgebaut ist, etwa „Abstand x Winkel“. |
| Diametric | Liefert oder setzt, ob eine Bemaßung als Durchmesser (doppelter Abstand) oder als Radius (einfacher Abstand) erscheint. |
| DimensionToInside | Liefert oder setzt, ob eine Radiusbemaßung immer zur Innenseite des Bogens zeigt. |
| DisplayAsChain | Liefert oder setzt, ob die Maßhilfslinien einer Koordinaten- oder Winkelkettenbemaßung verbunden sind. |
| DisplayAsLinear | Liefert oder setzt, ob eine Durchmesserbemaßung als lineare Bemaßung erscheint. |
| Elevation | Liefert oder setzt, ob am Ende der Maßhilfslinien einer Koordinatenbemaßung ein Höhensymbol erscheint. |
| EndSymbol | Liefert oder setzt das Endsymbol einer Koordinatenbemaßung. |
| ExtensionLineExtendsFromCenterOfSet | Ohne Beschreibung in der Hilfe. Dem Namen nach: ob die Maßhilfslinien von der Mitte eines Satzes ausgehen. |
| ExtensionLineSameAsLeaderStyle | Liefert oder setzt, ob die Maßhilfslinien denselben Linienstil wie die Maßlinien haben. |
| ExtensionLineUseDocumentDisplay | Liefert oder setzt, ob die Maßhilfslinien die Einstellungen des Dokuments nutzen. |
| Foreshortened | Liefert oder setzt, ob eine Längenbemaßung in einer Zeichnung verkürzt dargestellt wird. |
| GridBubble | Liefert oder setzt, ob am Ende der Maßhilfslinien einer Koordinatenbemaßung ein Rasterkreis (Grid Bubble) erscheint. |
| HorizontalJustification | Liefert oder setzt die waagerechte Ausrichtung des Maßtexts. |
| Inspection | Liefert oder setzt, ob der Maßtext über der Maßlinie als Prüfmaß (im Oval) erscheint. |
| IsLinked | Liefert, ob mit einer Bemaßung Text verknüpft ist. |
| Jogged | Liefert oder setzt, ob eine Koordinaten- oder Winkelkettenbemaßung geknickt ist. |
| LeaderVisibility | Liefert oder setzt, welche Maßlinien einer Bemaßung sichtbar sind. |
| LowerInspection | Liefert oder setzt, ob der Maßtext unter der Maßlinie als Prüfmaß (im Oval) erscheint. |
| MarkedForDrawing | Liefert oder setzt, ob eine Bemaßung für die Übernahme in Zeichnungen markiert ist. |
| MaxWitnessLineLength | Liefert oder setzt die größte Länge der Maßhilfslinien. |
| OffsetText | Liefert oder setzt, ob der Maßtext frei an einer Bezugslinie hängt, statt auf der Maßlinie zu stehen. |
| RunBidirectionally | Liefert oder setzt, ob eine Winkelkettenbemaßung in beide Richtungen von der Basis aus misst. |
| Scale2 | Liefert oder setzt einen Faktor, mit dem eine nicht assoziative Abstandsbemaßung ihren Wert multipliziert. |
| ShortenedRadius | Liefert oder setzt, ob eine Radiusbemaßung verkürzt erscheint: Die Maßlinie endet kurz vor dem Mittelpunkt. |
| ShowDimensionValue | Liefert oder setzt, ob der Maßwert im Maßtext erscheint. |
| ShowLowerParenthesis | Liefert oder setzt, ob der Text unter der Maßlinie in Klammern steht. |
| ShowParenthesis | Liefert oder setzt, ob der Text über der Maßlinie in Klammern steht, etwa für Hilfsmaße. |
| ShowTolParenthesis | veraltet ersetzt durch DisplayDimension.ShowParenthesis |
| SmartWitness | Liefert oder setzt die intelligente Darstellung der Maßhilfslinien. |
| SolidLeader | Liefert oder setzt, ob Bogen- und Radiusbemaßungen eine durchgehende Maßlinie haben. |
| Split | Liefert oder setzt, ob eine Doppelbemaßung (zwei Einheiten) über und unter einer durchgehenden Maßlinie steht. |
| Type2 | Liefert die Art einer Bemaßung, etwa linear, Winkel, Radius oder Durchmesser. |
| VerticalJustification | Liefert die senkrechte Ausrichtung des Maßtexts. |
| WitnessVisibility | Liefert oder setzt, welche Maßhilfslinien sichtbar sind. |
Methoden 93, davon 72 beschrieben, 21 veraltet
| Name | Beschreibung |
|---|---|
| AddDisplayEnt | Zeichnet vorübergehend eigene Grafik (Linie, Bogen, Kreis, Fläche) an Stelle der Bemaßung. |
| AddDisplayText | Zeigt vorübergehend eigenen Text an Stelle des Maßtexts. |
| AlignToEdge | Richtet eine Längenbemaßung an einer Kante aus. |
| AutoJogOrdinate | Knickt eine Koordinatenbemaßung automatisch, damit sich Texte nicht überlappen. |
| ExplementaryAngle | Klappt eine Winkelbemaßung auf den Ergänzungswinkel zu 360° um. |
| GetAlternatePrecision | veraltet ersetzt durch DisplayDimension.GetAlternatePrecision2 |
| GetAlternatePrecision2 | Liefert die Nachkommastellen des zweiten Werts einer Doppelbemaßung. |
| GetAlternateTolPrecision | veraltet ersetzt durch DisplayDimension.GetAlternateTolPrecision2 |
| GetAlternateTolPrecision2 | Liefert die Nachkommastellen der Toleranz beim zweiten Wert einer Doppelbemaßung. |
| GetAnnotation | Liefert die Annotation einer Bemaßung, mit der du etwa Position, Sichtbarkeit oder Layer bearbeitest. |
| GetArcLengthLeader | Liefert die Art der Maßlinien einer Bogenlängenbemaßung: parallel oder radial. |
| GetArrowHeadStyle | veraltet ersetzt durch DisplayDimension.GetArrowHeadStyle2 |
| GetArrowHeadStyle2 | Liefert die Pfeilart der beiden Maßpfeile. |
| GetAutoArcLengthLeader | Liefert, ob SOLIDWORKS die Art der Maßlinien einer Bogenlängenbemaßung selbst wählt. |
| GetBentLeaderLength | Liefert die Länge der geknickten Maßlinie. |
| GetBrokenLeader2 | Liefert, ob die Maßlinie für den Text unterbrochen ist und wie der Text steht. |
| GetChamferUnits | Liefert die eigenen Einheiten von Länge und Winkel einer Fasenbemaßung. |
| GetDefinitionTransform | Liefert die Transformation einer Bemaßung. |
| GetDimension | veraltet ersetzt durch DisplayDimension.GetDimension2 |
| GetDimension2 | Liefert die Bemaßung mit Name und Wert, die hinter einer angezeigten Bemaßung steht. |
| GetDisplayData | Liefert die Darstellungsdaten einer Bemaßung: Linien, Bögen, Pfeile und Texte, so wie sie gezeichnet werden. |
| GetExtensionLineAsCenterline | Liefert, ob eine Maßhilfslinie als Mittellinie dargestellt ist. |
| GetFractionBase | Liefert, ob eine Bemaßung als Dezimalzahl oder als Bruch erscheint. |
| GetFractionValue | Liefert den größten Nenner, mit dem eine Bemaßung als Bruch erscheint, etwa 32 für 1/32. |
| GetHoleCalloutVariables | Liefert die Variablen einer Bohrungsbeschreibung, etwa Durchmesser und Tiefe. |
| GetJogParameters | Liefert, ob und wie eine Maßhilfslinie einer Längenbemaßung geknickt ist. |
| GetLinkedText | Liefert den Namen, über den eine Bemaßung mit anderen verknüpft ist. |
| GetLowerText | Liefert den Text unter der Maßlinie. |
| GetNameForSelection | Liefert den Namen einer Bemaßung so, wie SelectByID2 ihn erwartet. |
| GetNext | veraltet ersetzt durch DisplayDimension.GetNext5 |
| GetNext2 | veraltet ersetzt durch DisplayDimension.GetNext5 |
| GetNext3 | veraltet ersetzt durch DisplayDimension.GetNext5 |
| GetNext4 | veraltet ersetzt durch DisplayDimension.GetNext5 |
| GetNext5 | Liefert die nächste Bemaßung in einer Zeichenansicht. |
| GetOrdinateDimensionArrowSize | Liefert den Durchmesser des Kreises am Nullpunkt einer Koordinatenbemaßung (Norm DIN). |
| GetOverride | Liefert, ob eine Bemaßung einen festen Ersatzwert statt des echten Werts zeigt. |
| GetOverrideValue | Liefert den Ersatzwert, den eine Bemaßung statt des echten Werts zeigt. |
| GetPrimaryPrecision | veraltet ersetzt durch DisplayDimension.GetPrimaryPrecision2 |
| GetPrimaryPrecision2 | Liefert die Nachkommastellen des Maßwerts. |
| GetPrimaryTolPrecision | veraltet ersetzt durch DisplayDimension.GetPrimaryTolPrecision2 |
| GetPrimaryTolPrecision2 | Liefert die Nachkommastellen der Toleranz. |
| GetRoundToFraction | Liefert, ob der Maßwert auf einen darstellbaren Bruch gerundet wird. |
| GetSecondArrow | Liefert, ob eine Durchmesserbemaßung den zweiten äußeren Pfeil zeigt. |
| GetSupportsGenericText | Liefert, ob eine Bemaßung mit SOLIDWORKS 2011 oder neuer angelegt wurde und ihr Text deshalb „generischer Text“ ist. |
| GetText | Liefert einen Teil des Maßtexts, etwa den Text vor oder nach dem Wert. |
| GetTextFormat | veraltet ersetzt durch Annotation.GetTextFormat |
| GetTextFormatItems | Liefert die Platzhalter eines Textteils, etwa <DIM>, und ihre ausgewerteten Werte. |
| GetType | veraltet ersetzt durch DisplayDimension.Type2 |
| GetUnits | Liefert die eigene Einheit einer Bemaßung. |
| GetUseDocArrowHeadStyle | Liefert, ob eine Bemaßung die Pfeilart des Dokuments nutzt. |
| GetUseDocBentLeaderLength | Liefert, ob eine Bemaßung die Knicklänge des Dokuments nutzt. |
| GetUseDocBrokenLeader | Liefert, ob eine Bemaßung die Einstellung des Dokuments für unterbrochene Maßlinien nutzt. |
| GetUseDocDual | Liefert, ob die Doppelbemaßung so liegt (oben, unten, rechts, links) wie im Dokument eingestellt. |
| GetUseDocPrecision | veraltet |
| GetUseDocSecondArrow | Liefert, ob eine Durchmesserbemaßung für den zweiten Pfeil die Einstellung des Dokuments nutzt. |
| GetUseDocTextFormat | veraltet ersetzt durch Annotation.GetUseDocTextFormat |
| GetUseDocUnits | Liefert, ob eine Bemaßung die Einheiten des Dokuments nutzt. |
| GetWitnessLineGap | Liefert den Abstand einer Maßhilfslinie zum bemaßten Element. |
| IsDimXpert | veraltet ersetzt durch Annotation.IsDimXpert |
| IsHoleCallout | Liefert, ob eine Bemaßung eine Bohrungsbeschreibung ist. |
| IsReferenceDim | Liefert, ob eine Bemaßung eine Referenzbemaßung ist. |
| ResetExtensionLineStyle | Setzt den Stil einer Maßhilfslinie zurück, etwa nachdem sie zur Mittellinie gemacht wurde. |
| SetArcLengthLeader | Legt fest, ob die Maßlinien einer Bogenlängenbemaßung parallel oder radial sind. |
| SetArrowHeadStyle | veraltet ersetzt durch DisplayDimension.SetArrowHeadStyle2 |
| SetArrowHeadStyle2 | Legt die Pfeilart der beiden Maßpfeile fest. |
| SetBentLeaderLength | Legt die Länge der geknickten Maßlinie fest. |
| SetBrokenLeader2 | Legt fest, ob die Maßlinie für den Text unterbrochen ist und wie der Text steht. |
| SetDual | veraltet ersetzt durch DisplayDimension.SetDual2 |
| SetDual2 | Legt die Lage einer Doppelbemaßung und die Rundung ihrer Toleranzen fest. |
| SetExtensionLineAsCenterline | Stellt eine Maßhilfslinie als Mittellinie dar oder wieder normal. |
| SetHorizontal | Stellt eine Längenbemaßung waagerecht. |
| SetJogParameters | Knickt eine Maßhilfslinie einer Längenbemaßung. |
| SetLineFontDimensionStyle | Legt die Linienart der Maßlinien einer Bemaßung fest. |
| SetLineFontDimensionThickness | Legt die Linienstärke der Maßlinien einer Bemaßung fest. |
| SetLineFontExtensionStyle | Legt die Linienart der Maßhilfslinien einer Bemaßung fest. |
| SetLineFontExtensionThickness | Legt die Linienstärke der Maßhilfslinien einer Bemaßung fest. |
| SetLinkedText | Verknüpft eine Bemaßung über einen gemeinsamen Namen mit anderen Bemaßungen. |
| SetLowerText | Setzt den Text unter der Maßlinie. |
| SetOrdinateDimensionArrowSize | Setzt den Durchmesser des Kreises am Nullpunkt einer Koordinatenbemaßung (Norm DIN). |
| SetOverride | Lässt eine Bemaßung in einer Zeichnung einen festen Ersatzwert statt des echten Werts zeigen. |
| SetPrecision | veraltet ersetzt durch DisplayDimension.SetPrecision3 |
| SetPrecision2 | veraltet ersetzt durch DisplayDimension.SetPrecision3 |
| SetPrecision3 | Legt die Nachkommastellen von Maßwert, zweitem Wert und Toleranzen fest. |
| SetSecondArrow | Schaltet den zweiten äußeren Pfeil einer Durchmesserbemaßung ein oder aus. |
| SetText | Setzt einen Teil des Maßtexts, etwa den Text vor oder nach dem Wert. |
| SetTextFormat | veraltet ersetzt durch Annotation.SetTextFormat |
| SetUnits | veraltet ersetzt durch DisplayDimension.SetUnits2 |
| SetUnits2 | Legt Einheit, Bruch- oder Dezimaldarstellung und Rundung einer Bemaßung fest. |
| SetVertical | Stellt eine Längenbemaßung senkrecht. |
| SetWitnessLineGap | Setzt den Abstand einer Maßhilfslinie zum bemaßten Element. |
| SupplementaryAngle | Ändert eine Winkelbemaßung auf den Nebenwinkel: innen wird außen und umgekehrt. |
| Unlink | Löst die Verknüpfung einer Bemaßung mit anderen. |
| VerticallyOppositeAngle | Klappt 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.