# RGB Function

office 365 dev account|Last Updated: 6/12/2017
|
1 Contributor

Returns a Long whole number representing an RGB color value. SyntaxRGB( red, green, blue ) The RGB function syntax has thesenamed arguments:

PartDescription
redRequired; Variant ( Integer ). Number in the range 0-255, inclusive, that represents the red component of the color.
greenRequired; Variant ( Integer ). Number in the range 0-255, inclusive, that represents the green component of the color.
blueRequired; Variant ( Integer ). Number in the range 0-255, inclusive, that represents the blue component of the color.

Remarks Application methods andproperties 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. The value for any argument to RGB that exceeds 255 is assumed to be 255. The following table lists some standard colors and the red, green, and blue values they include:

ColorRed ValueGreen ValueBlue Value
Black000
Blue00255
Green02550
Cyan0255255
Red25500
Magenta2550255
Yellow2552550
White255255255

The RGB color values returned by this function are incompatible with those used by the Macintosh operating system. They may be used within the context of Microsoft applications for the Macintosh, but should not be used when communicating color changes directly to the Macintosh operating system.

## Example

This example shows how the RGB function is used to return a whole number representing an RGB color value. It is used for those application methods and properties that accept a color specification. The object `MyObject` and its property are used for illustration purposes only. If `MyObject` does not exist, or if it does not have a Color property, an error occurs.

``````Dim RED, I, RGBValue, MyObject
Red = RGB(255, 0, 0)    ' Return the value for Red.
I = 75    ' Initialize offset.
RGBValue = RGB(I, 64 + I, 128 + I)     ' Same as RGB(75, 139, 203).
MyObject.Color = RGB(255, 0, 0)    ' Set the Color property of
' MyObject to Red.
``````