GETCOLOR( )

Topic group Related topics Example

Calls a dialog box in which you can define a custom color or select a color from the color palette. Returns a character string containing the red, green, and blue values for the color selected.

Syntax

GETCOLOR([<title expC>])

<title expC>

A character string to appear as the title of the dialog box.

Description

Use GETCOLOR( ) to open a dialog box in which you can choose a color from a palette of predefined colors or create a customized color. In this dialog box, you choose and create colors in the same way you do if you use the Color Palette available when you choose Color in the Windows Control Panel.

GETCOLOR( ) returns a string in the format "red value, green value, blue value", with each color value ranging from 0 to 255; for example "115,180,40". If you cancel the color dialog, GETCOLOR( ) returns an empty string.

You can use the string returned by GETCOLOR( ) in a related command, DEFINE COLOR, to use a specific color in a program.