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 |
---|---|---|
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)