NGU-COLOUR-SELECT Dialog

This document covers the following topics:

Natural Object Name

NGUCOSE1

Description

Provides a dialog box for selecting or creating a color.

OPEN DIALOG Parameters

Name/Data Type Explanation
HANDLE OF parent USING clause/Input The parent dialog.
Colour name (I4) WITH clause/Input/Output Input: Name of color to be pre-selected in dialog. If this is set to DEFAULT(0), black will be pre-selected. Output: Name of selected color (if any). See BACKGOUND-COLOUR-NAME for a list of possible color names.
Colour value (B3)

WITH clause/Input /Output
Input: RGB color value to be pre-selected in dialog
(only used if color name is set to CUSTOM (50)).
Output: RGB value of selected color.

Colour selected (L) WITH clause/Output Indicates whether a color has been selected.
Style (A32) WITH clause/Input (optional parameter) Reserved for future use.

Example: 

OPEN DIALOG NGU-COLOUR-SELECT #DLG$WINDOW WITH  
#DLG$WINDOW.BACKGROUND-COLOUR-NAME  
#DLG$WINDOW.BACKGROUND-COLOUR-VALUE  
#COLOUR-SEL