SolidWorksMakroprogrammierung

Objekt · SldWorks

DisplayStateSetting-Objekt

Legt fest, für welche Komponenten und Anzeigezustände eine Anzeigeeinstellung gilt: Darstellungsart, Transparenz, Sichtbarkeit oder Erscheinungsbild.

Deklaration Dim x As SldWorks.DisplayStateSetting · in der englischen .NET-Hilfe: IDisplayStateSetting

Beschreibung

Einstellungen wie Darstellungsart, Transparenz, Sichtbarkeit oder Farbe einer Komponente gelten je Anzeigezustand. Ein DisplayStateSetting sagt, für welche Komponenten (DisplayStateSetting.Entities) und welche Anzeigezustände (DisplayStateSetting.Names, DisplayStateSetting.Option) du sie liest oder setzt. Du übergibst es an diese Befehle:

Zugriff

Beispiel

' Gibt für die ausgewählte Komponente in jedem Anzeigezustand der aktiven Konfiguration
' Darstellungsart, Transparenz und Sichtbarkeit aus.
' Vorbedingung: Eine Baugruppe ist offen, eine Komponente ist ausgewählt.
' Ergebnis:     Eine Zeile je Anzeigezustand im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swExt As SldWorks.ModelDocExtension
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swDSS As SldWorks.DisplayStateSetting
    Dim aKomp(0) As SldWorks.Component2
    Dim vNamen As Variant, vArt As Variant, vTransp As Variant, vSicht As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocASSEMBLY Then Exit Sub
    Set swExt = swModel.Extension
    Set swSelMgr = swModel.SelectionManager
    If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelCOMPONENTS Then Exit Sub
    Set aKomp(0) = swSelMgr.GetSelectedObject6(1, -1)

    vNamen = swModel.ConfigurationManager.ActiveConfiguration.GetDisplayStates
    Set swDSS = swExt.GetDisplayStateSetting(swThisDisplayState)
    swDSS.Option = swSpecifyDisplayState
    swDSS.Names = vNamen
    swDSS.Entities = aKomp

    vArt = swExt.DisplayMode(swDSS)
    vTransp = swExt.Transparency(swDSS)
    vSicht = swExt.Visibility(swDSS)
    For i = 0 To swDSS.GetNameCount - 1
        Debug.Print vNamen(i) & ": Darstellung " & vArt(i) & ", Transparenz " & vTransp(i) & ", Sichtbarkeit " & vSicht(i)
    Next i
End Sub

Bemerkungen

Ablauf: Nach dem Holen legst du die Anzeigezustände (Names), die Komponenten (Entities) und den Bereich (Option) fest. Dann liest oder setzt du einen der Befehle oben. Für ein Erscheinungsbild holst du vorher mit ModelDocExtension.GetAppearanceSetting ein AppearanceSetting und setzt dessen Werte. Das Beispiel folgt dem Hilfebeispiel „Get Display State Settings“.

Reihenfolge der Werte: DisplayMode, Transparency und Visibility liefern einen Wert je Komponente und Anzeigezustand. Erst kommen alle Anzeigezustände der ersten Komponente, dann die der zweiten. Bei einer Komponente wie im Beispiel ist das ein Wert je Anzeigezustand.

Werte: Darstellungsart nach swDisplayMode_e, Transparenz nach swTransparencyState_e, Sichtbarkeit nach swVisibilityState_e.

Eigenschaften und Methoden

Eigenschaften 5, davon 5 beschrieben

NameBeschreibung
EntitiesLiest oder setzt die Komponenten, für die ein DisplayStateSetting gilt.
NamesLiest oder setzt die Namen der Anzeigezustände, für die ein DisplayStateSetting gilt.
OptionLiest oder setzt, für welche Anzeigezustände ein DisplayStateSetting gilt: den aktiven, alle oder die in Names genannten.
PartLevelLiest oder setzt, ob ein Erscheinungsbild auf Ebene des Teils statt der Baugruppe gesetzt wird.
RemoveAppearanceLiest oder setzt, ob die Erscheinungsbilder für ein DisplayStateSetting entfernt werden.

Methoden 2, davon 2 beschrieben

NameBeschreibung
GetEntityCountLiefert die Zahl der Komponenten eines DisplayStateSetting.
GetNameCountLiefert die Zahl der Anzeigezustände eines DisplayStateSetting.

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

Siehe auch

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

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