SolidWorksMakroprogrammierung

Methode · ColorTable

SetColorRefAtIndex-Methode (ColorTable)

Setzt die Farbe an einer Stelle der Farbtabelle.

Syntax

Sub SetColorRefAtIndex( _
   ByVal Index As Long, _
   ByVal ColorRef As Long, _
   ByVal ApplyTo As Integer _
)
swColorTable.SetColorRefAtIndex 0, RGB(255, 0, 0), 0

Parameter

IndexLongByVal
Die Stelle in der Farbtabelle, die du ändern willst.
ColorRefLongByVal
Die Farbe als COLORREF-Wert, etwa aus RGB.
ApplyToIntegerByVal
Nicht benutzt. Übergib 0.

Beispiel

' swColorTable ist die Farbtabelle (ColorTable), etwa aus SldWorks.GetColorTable.
Dim i As Long
For i = 0 To swColorTable.GetStandardCount - 1
    If swColorTable.GetNameAtIndex(i) = "Hintergrund" Then          ' Name in der Sprache der Oberfläche
        swColorTable.SetColorRefAtIndex i, RGB(240, 240, 240), 0
        Exit For
    End If
Next i

Bemerkungen

Ob die Änderung dauerhaft in den Systemoptionen landet und wann sie im Grafikbereich sichtbar wird, sagt die Hilfe nicht. Auch die Namen der Einträge nennt sie nicht. Der Name im Beispiel ist angenommen, die tatsächlichen Namen liefert ColorTable.GetNameAtIndex. Systemfarben setzt du sonst auch über die Werte swSystemColors… aus swUserPreferenceIntegerValue_e.

In einer deutschen Oberfläche gibt es den Namen „Viewport Background“ aus der Hilfe nicht, die Namen kommen in der Sprache der Oberfläche, etwa „Hintergrund“ (Stelle 10) oder „Skizze, Voll definiert“ (Stelle 4). Das Beispiel sucht darum jetzt nach „Hintergrund“; in einer englischen Oberfläche passt der englische Name.

Siehe auch

Verfügbarkeit

SOLIDWORKS 99

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

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