RGB Function (Visual Basic)

Returns an Integer value representing an RGB color value from a set of red, green and blue color components.

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

Parameters

  • Red
    Required. Integer in the range 0–255, inclusive, that represents the intensity of the red component of the color.

  • Green
    Required. Integer in the range 0–255, inclusive, that represents the intensity of the green component of the color.

  • Blue
    Required. Integer in the range 0–255, inclusive, that represents the intensity of the blue component of the color.

Exceptions

Exception type

Error number

Condition

ArgumentException

5

Green, Blue, or Red outside of range 0 and 255, inclusive.

See the "Error number" column if you are upgrading Visual Basic 6.0 applications that use unstructured error handling. (You can compare the error number against the Number Property (Err Object).) However, when possible, you should consider replacing such error control with Structured Exception Handling Overview for Visual Basic.

Remarks

Application methods and properties that accept a color specification expect that specification to be a number representing an RGB color value. An RGB color value specifies the relative intensity of red, green, and blue to cause a specific color to be displayed.

If the value for any argument to RGB is greater than 255, 255 is used.

The following table lists some standard colors and the red, green, and blue values they include.

Color

Red value

Green value

Blue value

Black

0

0

0

Blue

0

0

255

Green

0

255

0

Cyan

0

255

255

Red

255

0

0

Magenta

255

0

255

Yellow

255

255

0

White

255

255

255

Example

This example shows how the RGB function is used to return a whole number representing an RGB color value.

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)

Requirements

Namespace: Microsoft.VisualBasic

**Module:**Information

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

See Also

Reference

QBColor Function

ArgumentException