RGB-Funktion (Visual Basic)

Artikel
09/02/2008

Aktualisiert: November 2007

Gibt einen Integer-Wert zurück, der einen RGB-Farbwert aus roten, grünen und blauen Farbanteilen darstellt.

RGB( _
      Red As Integer, _
    Green As Integer, _
      Blue As Integer _
)

Parameter

Red
Erforderlich. Integer im Bereich von 0 (null) bis einschließlich 255, die die Intensität des Rotanteils der Farbe darstellt.
Green
Erforderlich. Integer im Bereich von 0 (null) bis einschließlich 255, die die Intensität des Grünanteils der Farbe darstellt.
Blue
Erforderlich. Integer im Bereich von 0 (null) bis einschließlich 255, die die Intensität des Blauanteils der Farbe darstellt.

Ausnahmen

Ausnahmetyp	Fehlernummer	Bedingung
ArgumentException	5	Green, Blue oder Red befindet sich nicht im Bereich von 0 (null) bis einschließlich 255.

Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die eine unstrukturierte Fehlerbehandlung verwenden. (Sie können die Fehlernummer mit der Number-Eigenschaft (Err-Objekt) vergleichen.) Wenn möglich, sollten Sie jedoch erwägen, eine solche Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.

Hinweise

Anwendungsmethoden und -eigenschaften, die eine Farbspezifikation akzeptieren, erwarten, dass diese eine Zahl ist, die einen RGB-Farbwert darstellt. Ein RGB-Farbwert gibt die relative Intensität von Rot, Grün und Blau an, um eine bestimmte Farbe anzuzeigen.

Wenn der Wert eines Arguments für RGB größer ist als 255, wird 255 verwendet.

In der folgenden Tabelle werden einige Standardfarben mit ihren Rot-, Grün- und Blauwerten aufgeführt.

Farbe	Rotwert	Grünwert	Blauwert
Schwarz	0	0	0
Blau	0	0	255
Grün	0	255	0
Zyan	0	255	255
Rot	255	0	0
Magenta	255	0	255
Gelb	255	255	0
Weiß	255	255	255

Beispiel

In diesem Beispiel wird mit der RGB-Funktion eine ganze Zahl zurückgegeben, die einen RGB-Farbwert darstellt.

Dim red, rgbValue As Integer
Dim i As Integer = 75
' Return the value for red.
red = RGB(255, 0, 0)
' Same as RGB(75, 139, 203).
rgbValue = RGB(i, 64 + i, 128 + i)