SolidWorksMakroprogrammierung

Enumeration · SwConst

swSceneBackgroundType_e-Enumeration

Art des Hintergrunds einer Szene: keiner, einfarbig, Farbverlauf, Bild oder das Umgebungsbild der Szene.

Bibliothek SwConst · 6 Werte · im Code direkt mit Namen verwendbar, zum Beispiel swBackgroundType_None

Syntax

Enum swSceneBackgroundType_e
    swBackgroundType_None           = 0
    swBackgroundType_Plain          = 1
    swBackgroundType_Graduated      = 2
    swBackgroundType_Image          = 3
    swBackgroundType_UseEnvironment = 4
    swBackgroundType_Color          = 5
End Enum

Werte

KonstanteWertBedeutung
swBackgroundType_None0Kein Hintergrund.
swBackgroundType_Plain1Eine einzige Farbe. Du setzt sie mit SWScene.BackgroundTopGradientColor.
swBackgroundType_Graduated2Farbverlauf. Die obere Farbe setzt du mit SWScene.BackgroundTopGradientColor, die untere mit SWScene.BackgroundBottomGradientColor.
swBackgroundType_Image3Bilddatei aus SWScene.BackgroundImage. Mit SWScene.FitToSWWindow streckst du das Bild auf die Größe des Fensters.
swBackgroundType_UseEnvironment4Das Umgebungsbild der Szene aus SWScene.BackgroundEnvImage.
swBackgroundType_Color5Dem Namen nach eine Hintergrundfarbe. Die Hilfe sagt nicht, worin sich der Wert von swBackgroundType_Plain unterscheidet.

Beispiel

' swModel ist das aktive Dokument (ModelDoc2).
Dim swConfig As SldWorks.Configuration
Dim swScene As SldWorks.SWScene
Set swConfig = swModel.ConfigurationManager.ActiveConfiguration
Set swScene = swConfig.GetScene
swScene.BackgroundType = swBackgroundType_Graduated
swScene.BackgroundTopGradientColor = RGB(255, 255, 255)
swScene.BackgroundBottomGradientColor = RGB(150, 170, 200)

Bemerkungen

Den Wert liest und setzt du mit SWScene.BackgroundType. Die Szene einer Konfiguration liefert Configuration.GetScene. Viele Eigenschaften von SWScene gelten nur bei bestimmten Hintergrundarten: SWScene.BackgroundImage und SWScene.FitToSWWindow nur bei swBackgroundType_Image, SWScene.BackgroundEnvImage und SWScene.FlattenFloor nur bei swBackgroundType_UseEnvironment, SWScene.BackgroundBrightness bei allen außer swBackgroundType_None.

SWScene.KeepBackground (Hintergrund beim Wechsel der Szene behalten) gilt nur bei swBackgroundType_Image, swBackgroundType_Graduated und swBackgroundType_Plain. Die Hilfe beschreibt die Werte nur mit ihrem Namen.

Verwendet von

Siehe auch

Englisches Original: swSceneBackgroundType_e in der SOLIDWORKS API-Hilfe ↗

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