COLOR (set color)

Top  Previous  Next

 

 

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

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 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 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

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.

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

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

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