SolidWorksMakroprogrammierung

Enumeration · SwConst

swColorsBackgroundAppearance_e-Enumeration

Hintergrund des Grafikbereichs: Szene des Dokuments, einfarbig, Farbverlauf oder Bilddatei (Systemoption Farben).

Bibliothek SwConst · 4 Werte · im Code direkt mit Namen verwendbar, zum Beispiel swColorsBackgroundAppearance_Plain

Syntax

Enum swColorsBackgroundAppearance_e
    swColorsBackgroundAppearance_Plain         = 0
    swColorsBackgroundAppearance_Gradient      = 1
    swColorsBackgroundAppearance_Image         = 2
    swColorsBackgroundAppearance_DocumentScene = 3
End Enum

Werte

KonstanteWertBedeutung
swColorsBackgroundAppearance_Plain0Systemoption: Farben › Hintergrunddarstellung. Einfarbig in der Farbe für den Hintergrund des Ansichtsfensters (swSystemColorsViewportBackground).
swColorsBackgroundAppearance_Gradient1Systemoption: Farben › Hintergrunddarstellung. Farbverlauf zwischen der oberen und unteren Verlaufsfarbe (swSystemColorsTopGradientColor, swSystemColorsBottomGradientColor).
swColorsBackgroundAppearance_Image2Systemoption: Farben › Hintergrunddarstellung. Ein Bild aus einer Datei, die du mit swColorsBackgroundImageFile aus swUserPreferenceStringValue_e angibst.
swColorsBackgroundAppearance_DocumentScene3Systemoption: Farben › Hintergrunddarstellung. Der Hintergrund der Szene des Dokuments.

Beispiel

' swApp ist die SOLIDWORKS-Anwendung.
Dim bOk As Boolean
If swApp.GetUserPreferenceIntegerValue(swColorsBackgroundAppearance) <> swColorsBackgroundAppearance_Image Then
    bOk = swApp.SetUserPreferenceStringValue(swColorsBackgroundImageFile, "C:\Bilder\Hintergrund.png")
    bOk = swApp.SetUserPreferenceIntegerValue(swColorsBackgroundAppearance, swColorsBackgroundAppearance_Image)
End If

Bemerkungen

Die Darstellung liest und setzt du mit SldWorks.GetUserPreferenceIntegerValue und SldWorks.SetUserPreferenceIntegerValue und swColorsBackgroundAppearance aus swUserPreferenceIntegerValue_e. Die Farben für swColorsBackgroundAppearance_Plain und swColorsBackgroundAppearance_Gradient sind eigene Optionen in swUserPreferenceIntegerValue_e und erwarten COLORREF-Werte.

Für swColorsBackgroundAppearance_Image setzt du den Dateinamen mit SldWorks.SetUserPreferenceStringValue. Lässt du den Pfad weg, sucht SOLIDWORKS im Ordner \data\Images\textures\background der Installation.

Die ältere Option swColorsGradientPartBackground ist veraltet und durch diese Werte ersetzt.

Siehe auch

Englisches Original: swColorsBackgroundAppearance_e in der SOLIDWORKS API-Hilfe ↗

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