Objekt · SldWorks
ColorTable-Objekt
Die Farbtabelle von SOLIDWORKS: die Farben der Oberfläche mit Namen sowie Grund- und eigene Farben, als COLORREF-Werte.
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
SldWorks.GetColorTable: die Farbtabelle von SOLIDWORKS
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| GetBasicColorCount | Liefert die Zahl der Grundfarben (basic colors) in der Farbtabelle. |
| GetBasicColors | Liefert die Grundfarben (basic colors) der Farbtabelle. |
| GetColorRefAtIndex | Liefert die Farbe an einer Stelle der Farbtabelle als COLORREF-Wert. |
| GetCount | Liefert die Zahl aller Farben in der Farbtabelle, Standard- und eigene Farben zusammen. |
| GetCustomColorCount | Liefert die Zahl der eigenen Farben (custom colors) in der Farbtabelle. |
| GetCustomColors | Liefert die eigenen Farben (custom colors) der Farbtabelle. |
| GetNameAtIndex | Liefert den Namen des Eintrags an einer Stelle der Farbtabelle, etwa eines Elements der Oberfläche. |
| GetStandardCount | Liefert die Zahl der Standardfarben in der Farbtabelle. |
| SetColorRefAtIndex | Setzt die Farbe an einer Stelle der Farbtabelle. |
| SetCustomColor | Setzt 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.