formZ SDK | 5.0 API Reference | System | Runtime Library (FZRT) | Graphics

# fzrt_get_color

Description

Displays the Choose color dialog. This will display the default Choose Color dialog. The location of the upper, left corner of the dialog is defined by the where parameter. The initial color displayed in the dialog is defined by the RGB triple, inColor. The selected color is returned in the outColor RGB structure. The outColor value is undefined if the user cancels the dialog, or if an error occurred.

Plugin Prototype

fzrt_boolean fzrt_get_color(

fzrt_point * | where,
const char * | prompt,
const fzrt_rgb_color_td * | inColor,
fzrt_rgb_color_td * | outColor )

Parameters

where [Input, Optional]

pointer to point structure that specifies where the top, left corner of the dialog should be located. NULL or (0,0) Centers on main screen.

prompt [Input]

Text to display as prompt in dialog. C string

inColor [Input]

color to use as starting color in dialog

outColor [Result]

color selected by user. Undefined if user cancels dialog

Returns

- TRUE if user clicks OK, FALSE if user clicks Cancel or error occurs

Availability

5.0.0.0

Function Set

fz_fzrt_graf_fset

Defined in

fzrt_api.h