SolidWorksMakroprogrammierung

Objekt · SldWorks

EnumDisplayDimensions-Objekt

Eine Aufzählung der angezeigten Bemaßungen (DisplayDimension) eines Features, die du mit Next Bemaßung für Bemaßung durchgehst.

Deklaration Dim x As SldWorks.EnumDisplayDimensions · in der englischen .NET-Hilfe: IEnumDisplayDimensions

Beschreibung

EnumDisplayDimensions gibt Zugriff auf eine Aufzählung von angezeigten Bemaßungen (DisplayDimension). Eine Aufzählung gibt dir die Elemente nicht als Array, sondern eins nach dem anderen. Seit wann es die Befehle gibt, sagt die Hilfe nicht.

EnumDisplayDimensions ist nur für In-Process-DLLs gedacht. In VBA-Makros nimmst du meist besser die Schleife mit Feature.GetFirstDisplayDimension und Feature.GetNextDisplayDimension.

Alle Bemaßungen holen: Du rufst EnumDisplayDimensions.Next in einer Schleife mit 1 auf. Vor jedem Aufruf setzt du die Variable für das Element auf Nothing. Ist sie danach noch Nothing, ist die Aufzählung zu Ende. Mit EnumDisplayDimensions.Reset fängst du wieder von vorn an.

Zugriff

Beispiel

' Gibt die Bemaßungen des ausgewählten Features aus.
' Vorbedingung: Ein Teil ist offen, ein Feature ist im FeatureManager ausgewählt.
' Ergebnis:     Die Namen der Bemaßungen stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swFeat As SldWorks.Feature
    Dim swEnum As SldWorks.EnumDisplayDimensions
    Dim swDispDim As SldWorks.DisplayDimension
    Dim nGeholt As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
    Set swFeat = swSel
    Set swEnum = swFeat.EnumDisplayDimensions
    If swEnum Is Nothing Then Exit Sub

    Do
        Set swDispDim = Nothing
        swEnum.Next 1, swDispDim, nGeholt
        If swDispDim Is Nothing Then Exit Do
        Debug.Print swFeat.Name & ": " & swDispDim.GetNameForSelection
    Loop
End Sub

Bemerkungen

Next in VBA: Next gibt in Rgelt ein Array mit Celt Elementen zurück. Die VBA-Syntax deklariert Rgelt aber als einzelnes DisplayDimension, deshalb holst du vermutlich immer genau 1 Element. PceltFetched ist kleiner als Celt, wenn weniger Bemaßungen übrig sind, oder NULL, wenn keine mehr da sind. Welchen Wert die Variable dann in VBA hat, sagt die Hilfe nicht. Die Schleife prüft deshalb das Element selbst.

Rückgabe: In VBA sind alle vier Befehle Funktionen mit einem HResult. Was der Wert bedeutet, sagt die Hilfe nicht. Du rufst sie ohne Klammern auf und lässt den Wert weg.

Unter-Features: Bei Feature.EnumDisplayDimensions enthält die Aufzählung alle Bemaßungen des Features und seiner Unter-Features, so wie ein Doppelklick auf das Feature im FeatureManager. Holst du sie von einem Unter-Feature, etwa der Skizze einer Extrusion, kommen nur dessen Bemaßungen.

Bemaßungen einblenden: Die Bemaßungen der Features blendest du vorher mit einer Dokumenteigenschaft ein. Die Hilfe nennt dafür ModelDoc2.SetUserPreferenceToggle, heute ModelDocExtension.SetUserPreferenceToggle, und swDisplayFeatureDimension. In swUserPreferenceToggle_e heißt der Wert swDisplayFeatureDimensions.

Eigenschaften und Methoden

Methoden 4, davon 4 beschrieben

NameBeschreibung
CloneErstellt eine Kopie der Aufzählung der Bemaßungen.
NextHolt die nächste Bemaßung aus der Aufzählung.
ResetSetzt die Aufzählung an den Anfang zurück, sodass Next wieder die erste Bemaßung liefert.
SkipÜberspringt die angegebene Zahl von Bemaßungen in der Aufzählung.

Siehe auch

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

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