colorwheel statement

colorwheel

PROMPT

COLOR

The colorwheel statement allows the user to pick a color using the operating systems standard color picker dialog

Parameters

This statement has two parameters:

prompt – is a message that will be displayed in the color picker dialog. The prompt should be a text item like “Background Color” or “Negative Highlight Color”. Note: This parameter is currently not supported, the specified text is not displayed in the dialog.

color – must be a variable or binary field. The color the user picks (a binary data value) will be placed into the field or variable. Note: If this field or variable already contains a color, that color will be the initial color displayed in the dialog. Otherwise the default color is white.

Description

This statement displays the color picker dialog. The user can pick a color, then press the Ok or Cancel buttons (the procedure can tell what button was pressed by using the info(“dialogtrigger”) function.

The procedure below lets the user pick a color, then changes the color of foreground objects to that color. (Note: For this example, foreground objects are defined as objects that contain the word foreground in the object name.)

local foreColor
colorwheel "Foreground Color",foreColor
if info("dialogtrigger") contains "Cancel"
    stop
endif
selectobjects objectinfo("name") contains "Foreground"
changeobjects "color",foreColor
selectnoobjects

See Also

alpha( -- extracts the alpha (opacity) from a color.
black( -- returns black as a Panorama color value (see Colors).
blue( -- extracts the blue intensity from a color.
brightness( -- extracts the brightness from a color.
Colors -- Using colors in Panorama formulas and procedures.
formcolor -- changes the background color of the current form.
getwebcolor( -- calculates an RGB color from a Netscape style web color.
gray( -- returns a shade of gray as a Panorama color value (see Colors).
green( -- extracts the green intensity from a color.
hsb( -- creates a color by combining hue, saturation, and brightness components. See Colors.
htmlcolor( -- converts a color name into a hex HTML color (RRGGBB format).
htmlcolorarray( -- generates a text array of HTML colors that gradually transition from one color to another.
htmlrgb( -- converts text formatted as an HTML color into a Panorama color value (see Colors).
htmlrgbstr( -- converts a color to text formatted as an HTML color.
hue( -- extracts the hue from a color.
info("colornames") -- returns a list of color names that can be used as a text object background and with the htmlcolor( function.
info("formcolor") -- returns the background color of the current form.
red( -- extracts the red intensity from a color.
rgb( -- creates a color by combining red, green, and blue primary colors. See Colors.
rgbstr( -- converts a color into text in the format *red,green,blue*.
saturation( -- extracts the saturation from a color.
white( -- returns white as a Panorama color value (see Colors).

History

Version	Status	Notes
10.0	Updated	Carried over from Panorama 6.0, but does not display prompt text, and allows program to specify the initial color.