|
|
|
|
|
|
|
|
|
|
version 2004 (Modified)
SET COLOR ({*; }object; color{; altColor})
| Parameter | Type | Description | |
| * |  | If specified, Object is an Object Name (String) | |
| If omitted, Object is a Field or a Variable | |||
| object | Field or variable | | Object Name (if * is specified), or |
| Field or Variable (if * is omitted) | |||
| color | Number | | New colors for the object |
| altColor | Number | | Alternating colors for a list box |
Description
The SET COLOR command sets the foreground and background colors of the form objects specified by object. If object is a list box, an additional parameter is used to set the foreground and background colors for even-numbered rows (alternating colors).
If you specify the optional * parameter, you indicate an object name (a string) in object. If you omit the optional * parameter, you indicate a field or a variable in object. In this case, you specify a field or variable reference (field or variable objects only) instead of a string. For more information about object names, see the section Object Properties.
altColor is used to specify an alternative color for the even-numbered rows of a list box or a list box column. When this parameter is passed, the color parameter will be applied only to odd-numbered rows. Using alternating colors makes lists easier to read.
If object specifies the list box object, alternating colors are used throughout the entire list box. If object specifies a column, only the column will use the colors set.
The color (as well as altColor) parameter specifies both foreground and background colors. The color is calculated as:
Color:=-(Foreground+(256 * Background))
where foreground and background are color numbers (from 0 to 255) within the color palette.
Color is always a negative number. For example, if the foreground color is to be 20 and the background color is to be 10, then color is – (20 + (256 * 10)) or –2580.
Note: You can see the color palette in the Form Editor's Property List window.
The numbers of the commonly used colors are provided by the following predefined constants, located in the "Colors" theme:
| Constant | Type | Value |
| White | Long Integer | 0 |
| Yellow | Long Integer | 1 |
| Orange | Long Integer | 2 |
| Red | Long Integer | 3 |
| Purple | Long Integer | 4 |
| Dark Blue | Long Integer | 5 |
| Blue | Long Integer | 6 |
| Light Blue | Long Integer | 7 |
| Green | Long Integer | 8 |
| Dark Green | Long Integer | 9 |
| Dark Brown | Long Integer | 10 |
| Dark Grey | Long Integer | 11 |
| Light Grey | Long Integer | 12 |
| Brown | Long Integer | 13 |
| Grey | Long Integer | 14 |
| Black | Long Integer | 15 |
Note: While SET COLOR works with indexed colors within the default 4D color palette, version 6 introduces the command SET RGB COLORS, which allows you to work with any RGB color.
Example
The following example sets the color of the text area shown below in the form editor:
After executing the following statement:
SET COLOR (*;"Mytext"; - (Yellow + (256 * Red)))
... the area appears as follows in User mode:
See Also
|
|
|
|
|
|
|
|
|
|