SelectColor (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Functions for Windows management

Various WINDEV functions

BuildAutomationVariant

Calling a DLL written in Visual Basic

Constants for managing the WLanguage types

Constants for sound management

Constants used by ExecutePresetAction

Constants used by the TraceStart function

EndAutomatedProcedure

InAndroidEmulatorMode

InAndroidMode

InAndroidSimulatorMode

InAppleWatchEmulatorMode

InAppleWatchMode

InAppleWatchSimulatorMode

InAutomaticTestMode

InBackgroundMode

InComponentMode

InDelayedProcedureMode

InPocketSimulatorMode

InPrelaunchedSessionMode

InReportsAndQueriesMode

InServiceMode

InSimulatorMode

InStoredProcedureMode

InTSEMode

InTestMode

InUMCMode

InUniversalWindowsAppMode

InUniversalWindowsAppSimulatorMode

InUniversalWindowsPlatformMode

InUniversalWindowsPlatformSimulatorMode

InVGAMode

InWebMode

InWebSocketServerGlobalServiceMode

InWebSocketServerMode

InWindowsPhoneEmulatorMode

InWindowsPhoneMode

InWindowsPhoneSimulatorMode

InWindowsStoreAppMode

InWindowsStoreAppSimulatorMode

Voice commands in your applications

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

SelectColor (Function)

In french: SelectCouleur

Opens the window for color selection while selecting the specified color.

Versions 15 and later

This function is now available for Java applications.

New in version 15

This function is now available for Java applications.

Until version 17, the standard window for color selection of Windows is opened:

From version 18, a more modern window for color selection is displayed (according to the selected options).

Remark: The picker corresponds to the color picker supplied with the JRE.

Example

Value is int
SelectionResult is boolean

Value = RGB(10, 17, 69)
Info("Initial color: " + Value)
SelectionResult = SelectColor(Value, scInit)
Info("Final color: " + Value)

Syntax

<Result> = SelectColor(<Initial value> [, <Options> [, <Custom Colors>]])

<Result>: Boolean

Exit mode from the window for color selection:
True if the OK button was clicked by the user,
False otherwise (Cancel button).

<Initial value>: Integer

Initial color selected in the window for color selection.
Caution: You must not use a color constant directly (LightRed, etc.) or RGB. You can use a variable equal to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a preset color of WLanguage.
Not to do:

SelectionResult is boolean = SelectColor(RGB(10, 17, 69), scInit)

Do:

Value is int = RGB(10, 17, 69)
SelectionResult is boolean = SelectColor(Value, scInit)

When the color selection window is closed, <Initial value> contains the value of the selected color if the user validated the window using the OK button.

<Options>: Optional constant or optional combination of constants

Options for displaying the window for color selection
scHelp Enables the help button.
Window displayed: Standard window for color selection of Windows.
scPersoColor Enables the button for creating custom colors.
Window displayed: Standard window for color selection of Windows.
If <Custom colors> is specified, the Windows standard color selection window is displayed and the button for creating custom colors is enabled.
If <Custom colors> is not specified, the color selection window is displayed.
scSolidColor Only non-hatched colors are allowed.
Window displayed: Window for color selection.
scInit
(Default value) The color selected by default in the window for color selection corresponds to the color passed in parameter to SelectColor.
Window displayed: Window for color selection.
scNotPersoColor The custom color creation button is dimmed.
Window displayed: Standard window for color selection of Windows.
Versions 18 and later
scSystem
New in version 18
scSystem
scSystem Displays the standard window for color selection of Windows.
scAnyColor All the colors are allowed.
Window displayed: Window for color selection.

Versions 18 and later
Remark: When combining constants, the new window for color selection is displayed only if all the requested features are available in this window.
New in version 18
Remark: When combining constants, the new window for color selection is displayed only if all the requested features are available in this window.
Remark: When combining constants, the new window for color selection is displayed only if all the requested features are available in this window.
This parameter is ignored.

<Custom Colors>: Optional address

Address of an array of 16 integers containing the RGB codes of the custom colors. If this parameter is not specified, 16 shades of gray are proposed.
This parameter is ignored.

Business / UI classification : UI Code

Component : wd260std.dll