Color_GetFromDialog()

The Color_GetFromDialog() function opens a color selection dialog that allows the user to pick a color.

Syntax

Color_GetFromDialog(color_value {,color_mode}{,custom_colors[]})

Parameters

• color_value – A long integer field or variable containing a color value. If you supply an initial value for this parameter, that color will be the default selection in the color selection dialog. If the user clicks OK in the color selection dialog, the color value selected will be returned. If the user clicks Cancel, the value -1 will be returned.

• color_mode – This optional parameter specifies what type of color will be returned. Use one of the following constants:

If you don’t supply this parameter, an exact color will be returned from the color selection dialog.

• custom_colors[] – An optional array of 16 long integer color values used to define the custom colors that appear in the Custom colors section of the color selection dialog. If you supply initial values for each of these array elements, those colors will appear in the color selection dialog. When the color selection dialog is closed, the custom color values defined in the dialog will be returned to this array. If you don’t supply this parameter, the 16 colors in the Custom colors section of the color selection dialog will be white.

Return value

A boolean indicating which buttons was clicked. True is indicates that OK was clicked, while false indiates that Cancel was clicked.

Comments

You can use the following constants when specifying solid colors:

Documentation Feedback

---