Function: choosecolor( )
Function: choosecolor( )choosecolor {<title>}
numeric
Enables the operator to select a color via an interactive "Color Select" window. When this function is invoked, a popup dialog window is displayed and the user configure colors and choose one.
A successful color selection will return 3 numeric values, the red, green and blue components of the selected color, all in the range 0 through 100.
This function is currently available on Windows systems only.
<title>
A string value providing a title for the color selection dialog window.
If this is omitted, the text Color Selection will be used. Note that
this directive may be disregarded on some systems.
The values returned by this function are the red, green and blue components of the selected color, suitable for the subsequent definition of a Fire color. The color is selected by pressing the 'OK' or 'Select' button in the popup window.
Pressing the 'Cancel' button will abort the operation and return 3 zero numeric values.
The contents of the dialog window are machine architecture-dependent and may display color components in the range 0 through 255. Despite this, returned values are always in the range 0 through 100.
The position of the dialog window is determined by the value of
menu_position.
No action is done to the selected color. This is the responsibility of the caller. Typically an appplication would create a Fire color from the result.
The system numeric identifier found is set by this function. It gets set to true on a successful color selection, or false on dialog cancel or error.
numeric col[] = choosecolor
unless (funcerr) {
color mycol,fname,col[1],col[2],col[3]
}