SET-AUX-COLOR Action

This document covers the following topics:


Description

Sets an auxilliary color for a dialog element.

An auxilliary color is an additional color to those that can be selected via the standard BACKGROUND-COLOUR-NAME, BACKGROUND-COLOUR-VALUE, FOREGROUND-COLOUR-NAME and FOREGROUND-COLOUR-VALUE attributes (if available).

Parameters

Name/Data Type Explanation
Control

(HANDLE OF GUI)

Input

Handle of dialog element to which the color is to be applied.

Part (I4) Input

Defines the part of the dialog element to be colored. The interpretation is specific to the type of dialog element (see below).

Color (I4) Input

Color name (one of the color constants defined in the local data area NGULKEY1).

Value (B3) Input (optional parameter)

Color value. Only used if color name is set to CUSTOM (=50, as defined in the local data area NGULKEY1).

Response (I4) Output

Natural error (if applicable).

The following auxilliary colors are currently available:

Dialog Element Type Part Interpretation
Date/Time Picker 1 Background color displayed between months in the drop-down month calendar (if present).
  2 Color used to display text within a month in the drop-down month calendar.
  3 Background color displayed in the drop-down month calendar's title.
  4 Color used to display text within the drop-down month calendar's title.
  5 Background color displayed within the month in the drop-down month calendar.
  6 Color used to display header day and trailing day text in the drop-down month calendar (if present).

Header and trailing days are the days displayed that belong to the previous and following months, respectively.

Example:

 
/* Set date/time picker's title background to red
PROCESS GUI ACTION SET-AUX-COLOR WITH
  #DTP-1 3 RED GIVING *ERROR