SET-AUX-COLOR Action

#### Search Results

Search

# SET-AUX-COLOR Action

This document covers the following topics:

- Description

- Parameters

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

### On this page

- Description
- Parameters