SolidWorksMakroprogrammierung

Objekt · SldWorks

ColorTable-Objekt

Die Farbtabelle von SOLIDWORKS: die Farben der Oberfläche mit Namen sowie Grund- und eigene Farben, als COLORREF-Werte.

Deklaration Dim x As SldWorks.ColorTable · in der englischen .NET-Hilfe: IColorTable

Beschreibung

ColorTable gibt Zugriff auf die Farbdefinitionen, die SOLIDWORKS verwendet. Das Hilfebeispiel liest damit die Farben der Oberfläche, etwa für Bemaßungen, Hintergründe, Zeichnungsblatt, Skizzenstatus und Beschriftungen. Alle Farben sind COLORREF-Werte vom Typ Long.

Zugriff

Beispiel

' Gibt Name und Farbe jedes benannten Standardeintrags der Farbtabelle aus,
' die Farbe als Rot, Grün und Blau.
' Vorbedingung: SOLIDWORKS läuft.
' Ergebnis:     Die Liste steht im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swColorTable As SldWorks.ColorTable
    Dim sName As String
    Dim nFarbe As Long
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swColorTable = swApp.GetColorTable
    If swColorTable Is Nothing Then Exit Sub

    Debug.Print swColorTable.GetCount & " Farben, " & swColorTable.GetStandardCount & " Standardfarben"
    For i = 0 To swColorTable.GetStandardCount - 1
        sName = swColorTable.GetNameAtIndex(i)
        If sName <> "" Then                                   ' Einträge ohne Namen überspringen
            nFarbe = swColorTable.GetColorRefAtIndex(i)
            Debug.Print i & " " & sName & ": " & (nFarbe And &HFF) & ", " & _
                        ((nFarbe \ &H100) And &HFF) & ", " & ((nFarbe \ &H10000) And &HFF)
        End If
    Next i
End Sub

Bemerkungen

COLORREF: COLORREF-Werte sind vom Typ Long, für Einzelheiten verweist die Hilfe auf die Microsoft-Dokumentation. Rot steht im niedrigsten Byte, dann folgen Grün und Blau. In VBA bildest du solche Werte mit RGB.

Arten von Farben: Die Hilfe unterscheidet Standardfarben, Grundfarben (basic colors) und eigene Farben (custom colors), erklärt den Unterschied aber nicht. Das Hilfebeispiel „Get COLORREF Values of Standard User-interface Elements“ zeigt nur, dass die Standardfarben die Farben der Oberfläche mit Namen sind.

Ändern: Ob Änderungen mit ColorTable.SetColorRefAtIndex dauerhaft in den Systemoptionen landen, sagt die Hilfe nicht. Einzelne Systemfarben setzt du sonst über die Werte swSystemColors… aus swUserPreferenceIntegerValue_e.

In SOLIDWORKS 2024 mit deutscher Oberfläche gibt das Beispiel „109 Farben, 93 Standardfarben“ und danach die benannten Einträge aus, etwa „3 Skizze, Überdefiniert: 255, 0, 0“ und „10 Hintergrund: 195, 200, 210“. Die Namen kommen in der Sprache der Oberfläche, etwa „Hintergrund“ (Stelle 10) oder „Skizze, Voll definiert“ (Stelle 4).

Eigenschaften und Methoden

Methoden 10, davon 10 beschrieben

NameBeschreibung
GetBasicColorCountLiefert die Zahl der Grundfarben (basic colors) in der Farbtabelle.
GetBasicColorsLiefert die Grundfarben (basic colors) der Farbtabelle.
GetColorRefAtIndexLiefert die Farbe an einer Stelle der Farbtabelle als COLORREF-Wert.
GetCountLiefert die Zahl aller Farben in der Farbtabelle, Standard- und eigene Farben zusammen.
GetCustomColorCountLiefert die Zahl der eigenen Farben (custom colors) in der Farbtabelle.
GetCustomColorsLiefert die eigenen Farben (custom colors) der Farbtabelle.
GetNameAtIndexLiefert den Namen des Eintrags an einer Stelle der Farbtabelle, etwa eines Elements der Oberfläche.
GetStandardCountLiefert die Zahl der Standardfarben in der Farbtabelle.
SetColorRefAtIndexSetzt die Farbe an einer Stelle der Farbtabelle.
SetCustomColorSetzt eine der eigenen Farben (custom colors) der Farbtabelle.

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

Siehe auch

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

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