ColorDialog

Object List Hierarchy Next Object

Definition:

The ColorDialog is used to obtain a color choice from the user. The dialog presents the user with a palette of predefined choices, as well as an interface to define a custom color.

Specialized Features:

The following tables list and describe the properties and methods added by ColorDialog. There are no added events.

---

Properties Use to...

---

Color Indicate the current value of the selected color

---

Methods Use to...

---

Execute Display a color choice dialog modally.

Copied Features:

Properties Methods Events

Details:

The ColorDialog gives you easy access to the Windows DLL (COMMDLG.DLL) containing information that allows you to quickly create a standard color navigator. When ColorDialog’s Execute method is invoked, the dialog is displayed. The dialog is displayed modally, meaning a user must select a color or dismiss the dialog. The Execute method returns IDOK if the user selects a color, IDCANCEL if the dialog was dismissed without a selection.

If the user pushes the Define Custom Color button, an additional portion of the dialog is exposed. This portion presents an interface that allows the user to modify the palette of custom colors. The user may choose the color by selecting an area within a spectrum, or by specifying any representable color via HSV or RGB. These custom colors will then be displayed by the color dialog on subsequent calls to Execute.