Purpose |
Display a color selection dialog to return the user's choice. | ||||||
Syntax |
DISPLAY COLOR [hParent], [xpos], [ypos], firstcolor, custcolors, flags TO color& | ||||||
hParent |
Handle of the parent window or dialog. If there is no parent, use zero (0) or %HWND_DESKTOP. | ||||||
xpos |
Horizontal position, in pixels, relative to the parent window. If omitted, PowerBASIC selects the position (offset from the parent, or centered if no parent). | ||||||
ypos |
Vertical position, in pixels, relative to the parent window. If missing, PowerBASIC selects the position (offset from the parent, or centered if no parent). | ||||||
firstcolor |
Specifies the RGB color which is initially selected when the dialog box is created. | ||||||
custcolors |
User-Defined Type variable which is used to initialize and return 16 custom colors on the dialog. The UDT must have 16 members, each of which is a long integer or dword. They may be scalar members, or a member array. | ||||||
flags |
The style attributes of the COLOR Dialog. The following values may be used alone or combined, and are predefined in the PowerBASIC compiler:
| ||||||
color& |
The RGB value of the selected color. If the user fails to make a color selection, or chooses CANCEL, the value -1 is assigned to the color& variable. | ||||||
Remarks |
If you offer the user the ability to create custom colors, it is suggested you retain the custcolors UDT variable without change. It may then be used again on a later invocation of DISPLAY COLOR with the user's custom colors intact. | ||||||
See also |
DISPLAY BROWSE, DISPLAY FONT, DISPLAY OPENFILE, DISPLAY SAVEFILE, RGB |