| **Navigation:**  [[introduction.htm|Language Reference]] > 9 -  Window and Report Attributes > Window and Report Attributes >====== COLOR (set color) ====== | [[cnt  set total count .htm|{{btn_prev_n.gif|Previous page}}]][[introduction.htm|{{btn_home_n.gif|Return to chapter overview}}]][[column  set list box highlight bar .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

**COLOR(**// color //[, //selected fore //] [,// selected back //]// //**)**

{{blk2blue.jpg|blk2blue.jpg}}

| **COLOR** | Specifies display or print color. |
| //color// | Specifies the background color (PROP:Background or PROP:FillColor, equivalent to {PROP:Color,1}). Foreground color is specified in the FONT attribute. See also [[fill  set fill color .htm|PROP:FILL]] |
| //selected fore// | Specifies the default foreground color for the selected text on a control that can receive focus (PROP:SelectedColor, equivalent to {PROP:Color,2}). Not valid in a REPORT. |
| //selected back// | Specifies the default background color for the selected text on a control that can receive focus (PROP:SelectedFillColor, equivalent to {PROP:Color,3}). Not valid in a REPORT. |

The **COLOR** attribute (PROP:COLOR) specifies the default background and selected foreground and background colors. This attribute is valid in Clarion Win32 Windows, and also for REPORT structures in both Clarion Win32 and Clarion#.

The color values in each of the three parameters are constants which contain the red, green, and blue components to create the color in the three low-order bytes of a LONG value (bytes 0, 1, and 2: Red = 000000FFh, Green = 0000FF00h, and Blue = 00FF0000h), or EQUATEs for a standard Windows color value (which are all negative values). EQUATEs for Windows' standard colors are contained in the [[commonly used equates.htm#colorequates|EQUATES.CLW]] file. Each of the runtime properties returns COLOR:None if the associated parameter is absent. When COLOR:None is set, the runtime library uses the brush color in use by the parent container.

Windows automatically finds the closest match to the specified color value for the hardware on which the program is run. Windows standard colors may be reconfigured by the user in the Windows Control Panel. Any control using a Windows standard color is automatically repainted with the new color when this occurs.

**WINDOW and TOOLBAR Usage**

{{black.jpg|black.jpg}}

On a WINDOW or TOOLBAR, the COLOR attribute specifies the background display color of the WINDOW or TOOLBAR and the default background and selected foreground and background colors for all controls in the WINDOW or TOOLBAR without their own COLOR attribute.

{{notebox.jpg|NoteBox.jpg}}

A Sheet/Tab is a fully manifested control, so its color comes from the users OS settings. The COLOR attribute (or use of PROP:Color) is ignored in this case. If you want a colored tab with a manifest active, place a Box control on it and set the color, or simply use an Image control.

**Window Control Usage**

{{black.jpg|black.jpg}}

The COLOR attribute specifies the display color of a LINE control. On a BOX, ELLIPSE, or REGION control, the //color// parameter specifies the color used for the control's border. On all other controls, the //color// parameter specifies the background control color, overriding the user's standard Windows color scheme for that control type.

For most of those controls that can receive focus, the //selected fore// and //selected back// parameters specify the foreground and background colors of the selected text or item.

**Report Usage**

{{black.jpg|black.jpg}}

On a REPORT statement, the COLOR attribute specifies the background print color of the REPORT and the default background color for all DETAIL, HEADER, FOOTER, or FORM in the REPORT without a COLOR attribute.

The COLOR attribute specifies the background print color of the DETAIL, HEADER, FOOTER, or FORM on which it is placed, and the default background color for all controls in the DETAIL, HEADER, FOOTER, or FORM without a COLOR attribute.

The COLOR attribute specifies the print color of a LINE control, specifies the border color of a BOX or ELLIPSE control, or the background color of any other control.

**Example:**

**WinOne WINDOW,AT(0,0,160,400),COLOR(00FF0000h,0000FF00h,000000FFh)**

**       !Blue background, Green selected foreground, Red selected background**

**        TOOLBAR,COLOR(00FF0000h,0000FF00h,000000FFh)**

**       !Blue background, Green selected foreground, Red selected background**

**         BOX,AT(20,20,20,20),COLOR(COLOR:ACTIVEBORDER) !Windows' active border color**

**        END**

**        BOX,AT(100,100,20,20),COLOR(00FF0000h)         !Blue**

**        BOX,AT(140,140,20,20),COLOR(0000FF00h)         !Green**

**        BOX,AT(180,180,20,20),COLOR(000000FFh)         !Red**

**       END**

**CustRpt    REPORT,AT(1000,1000,6500,9000),THOUS,COLOR(00FF0000h)   !Blue background**

**CustDetail  DETAIL,AT(0,0,6500,1000)**

**             ELLIPSE,AT(60,60,200,200),COLOR(COLOR:ACTIVEBORDER)   !Color EQUATE**

**             BOX,AT(360,60,200,200),COLOR(00FF0000h)               !Pure Red**

**            END**

**           END**

**RptOne REPORT,AT(0,0,160,400),COLOR(00FF0000h)    !Blue default background**

**        HEADER,COLOR(0000FF00h)                   !Green page header background**

**        !structure elements  **

**        END    **

**CustD1  DETAIL                                    !uses the default background color**

**        !structure elements  **

**        END**

**        FOOTER,COLOR(000000FFh)                   !Red page footer background**

**        !structure elements  **

**        END    **

**       END**

**See Also:**

[[font  set default font .htm|FONT]]