IsNamedColor Eine Funktion zur Prüfung, ob eine ARGB-Farbe in der KnownColor-Auflistung (System.Drawing) enthalten ist. Der Vergleich erfolgt durch die RGB-Komponenten
Autor:   Manfred Bohn	Bewertung:     [ Jetzt bewerten ]	Views:  12.757
ohne Homepage	System:  WinXP, Win7, Win8, Win10, Win11	kein Beispielprojekt

Geben Sie hier Ihre persönliche Bewertung ab! Bisher wurde noch keine Bewertung abgegeben.

sehr gut     gut     nützlich     mittelmäßig     mangelhaft

Im Namespace 'System.Drawing' ist die Struktur 'Color' verfügbar, die u.a. zahlreiche ARGB-Farben durch Bezeichnungen definiert. Die Enumeration 'KnownColor' listet diese Farb-Namen auf. Zusätzlich sind darin die System-Farbkonstanten aufgeführt.

Die Eigenschaft 'IsKnownColor' informiert darüber, ob eine bestimmte Farbe in dieser Liste enthalten ist. Allerdings mit einer erheblichen Einschränkung. Die Überprüfung erfolgt nicht anhand der A-R-G-B-Komponenten einer Farbe, sondern nur aufgrund ihrer Erstellungsmethode ('FromName' oder 'FromKnownColor'). Hat man die Farbe durch die 'FromARGB'-Methode erstellt, ist diese Funktion unbrauchbar. Sie liefert stets 'False'.

Die hier vorgeschlagene Funktion 'IsNamedColor' überprüft statt dessen durch den Vergleich der Farbkomponenten, ob eine Farbe "bekannt" (= benannt) ist (Rückgabe: true).

Der Parameter 'UseAlpha' bestimmt, ob neben den R-G-B-Komponenten auch die Alpha-Komponente verglichen wird. (Die benannten Farben besitzen alle die Alpha-Komponente 255).

Der optionale Rückgabe-Parameter 'ColorName' enthält die Bezeichnung der Farbe, falls eine gefunden werden konnte.

Die Funktion erstellt beim ersten Aufruf eine STATIC-Liste der 'KnownColor'-Einträge und verwendet dabei als Schlüssel den Integer-Wert der Farbe (gebildet von 'ToArgb'). Die Systemfarb-Konstanten und 'Transparent' werden dabei ausgefiltert. Einige Farben sind doppelt benannt. Diese Doubletten werden ausgesondert. Zur Auflistung der KnownColor-Enumeration wird die Funktion "Enum_GetMembers" verwendet (VBARCHIV-Tipp: Enumerationen auflisten).

In der Funktion erfolgt die Überprüfung einer Farbe (nach deren ToARGB-Konvertierung) durch die Abfrage, ob ein entsprechender Schlüssel in der Liste vorliegt ('ContainsKey').

''' <summary>Handelt es sich um eine benannte VB-Farbe?</summary>
''' <param name="color">zu beurteilende ARGB-Farbe</param>
''' <param name="UseAlpha">Sollen Alpha-Unterschiede 
''' beachtet werden?</param>
''' <param name="ColorName">Name der Farbe (oder Empty)</param>
''' <returns>Benannte Farbe?</returns>
Public Function IsNamedColor(ByVal color As Drawing.Color, _
  Optional ByVal UseAlpha As Boolean = False, _
  Optional ByRef ColorName As String = Nothing) As Boolean
 
  ' Liste der KnownColors-Benennungen 
  Static NamedColors As Collections.Generic.Dictionary(Of Integer, String)
 
  If NamedColors Is Nothing Then
    ' Liste benannter Farben erstellen
    ' (KnownColor-Enumeration auflisten)
    Dim ColorDict As Collections.Generic.Dictionary(Of Integer, String) = _
      Enum_GetMembers(Of Drawing.KnownColor, Integer)()
 
    ' gefilterte Liste benannter Farben speichern (STATIC) 
    NamedColors = New Collections.Generic.Dictionary(Of Integer, String)
 
    ' Liste füllen
    Dim key_integer As Integer
 
    For Each kvp As Collections.Generic.KeyValuePair(Of Integer, String) In ColorDict
      If kvp.Value.ToUpper <> "TRANSPARENT" Then
        ' Systemfarb-Konstanten in der Enumeration ausfiltern
        If Not Drawing.Color.FromName(kvp.Value).IsSystemColor Then
          ' Farb-Bezeichnung erhält ToArgb-Wert als Schlüssel 
          key_integer = Drawing.Color.FromName(kvp.Value).ToArgb
          ' Doppelte Farb-Benennungen ggf. filtern
          If Not NamedColors.ContainsKey(key_integer) Then
            NamedColors.Add(key_integer, kvp.Value)
          End If
        End If
      End If
    Next kvp
  End If
 
  ' Die übergebene Farbe in den ARGB-Integer transformieren
  Dim color_integer As Integer
  If UseAlpha Then
    ' Alpha-Komponente der Farbe bleibt unverändert
    color_integer = color.ToArgb
  Else
    ' Alpha-Komponente der Farbe auf 255 setzen
    color_integer = Drawing.Color.FromArgb(255, color.R, color.G, color.B).ToArgb
  End If
 
  ' Prüfen, ob die Farbe in der Liste enthalten ist
  With NamedColors
    If .ContainsKey(color_integer) Then
      ' Farb-Bezeichnung zurückgeben
      ColorName = .Item(color_integer)
      Return True
    Else
      ' Keine benannte Farbe ...
      ColorName = String.Empty
      Return False
    End If
  End With
End Function