Objekt · SldWorks
DisplayStateSetting-Objekt
Legt fest, für welche Komponenten und Anzeigezustände eine Anzeigeeinstellung gilt: Darstellungsart, Transparenz, Sichtbarkeit oder Erscheinungsbild.
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:
ModelDocExtension.DisplayMode: Darstellungsart, etwa schattiert oder DrahtmodellModelDocExtension.Transparency: TransparenzModelDocExtension.Visibility: SichtbarkeitModelDocExtension.DisplayStateSpecMaterialPropertyValues: Erscheinungsbilder alsAppearanceSetting
Zugriff
ModelDocExtension.GetDisplayStateSetting: ein neues DisplayStateSetting mit dem Bereich, den du übergibst
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Entities | Liest oder setzt die Komponenten, für die ein DisplayStateSetting gilt. |
| Names | Liest oder setzt die Namen der Anzeigezustände, für die ein DisplayStateSetting gilt. |
| Option | Liest oder setzt, für welche Anzeigezustände ein DisplayStateSetting gilt: den aktiven, alle oder die in Names genannten. |
| PartLevel | Liest oder setzt, ob ein Erscheinungsbild auf Ebene des Teils statt der Baugruppe gesetzt wird. |
| RemoveAppearance | Liest oder setzt, ob die Erscheinungsbilder für ein DisplayStateSetting entfernt werden. |
Methoden 2, davon 2 beschrieben
| Name | Beschreibung |
|---|---|
| GetEntityCount | Liefert die Zahl der Komponenten eines DisplayStateSetting. |
| GetNameCount | Liefert 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.