This browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Download Microsoft Edge
More info about Internet Explorer and Microsoft Edge
Returns a
Long
whole number representing an RGB color value.
Syntax
RGB
(
red
,
green
,
blue
)
The
RGB
function syntax has these
named arguments
:
Description
Required;
Variant
(
Integer
). Number in the range 0–255, inclusive, that represents the red component of the color.
green
Required;
Variant
(
Integer
). Number in the range 0–255, inclusive, that represents the green component of the color.
Required;
Variant
(
Integer
). Number in the range 0–255, inclusive, that represents the blue component of the color.
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.
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:
Color
Red value
Green value
Blue value
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's 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.
See also
Color constants
Functions (Visual Basic for Applications)
Support and feedback
Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.
