Definition

Represents a common dialog box that displays available colors along with controls that enable the user to define custom colors.

Header: #include <xtd/forms/color_dialog>

Namespace: xtd::forms

Library: xtd.forms

Remarks: The inherited member show_dialog must be invoked to create this specific common dialog box. hook_proc can be overridden to implement specific dialog box hook functionality. Use color to retrieve the color selected by the user.; When you create an instance of color_dialog, some of the read/write properties are set to initial values. For a list of these values, see the color_dialog constructor.

Appearance

	Windows	macOS	Gnome
Light	html dialog_color_dialog_m.png html dialog_color_dialog_g.png
Dark	html dialog_color_dialog_md.png html dialog_color_dialog_gd.png

Examples: The following code example demonstrates the use of color_dialog dialog.
#include <xtd/drawing/system_colors>
#include <xtd/forms/application>
#include <xtd/forms/button>
#include <xtd/forms/color_dialog>
#include <xtd/forms/form>
using namespace xtd;
using namespace xtd::drawing;
using namespace xtd::forms;
class form1 : public form {
public:
form1() {
text("Color dialog example");
controls().push_back(button1);

button1.location({10, 10});
button1.text("Color...");
button1.click += [&] {
auto dialog = color_dialog {};
dialog.color(back_color());
dialog.custom_colors(custom_colors);
if (dialog.show_dialog(*this) == forms::dialog_result::ok)
back_color(dialog.color());
custom_colors = dialog.custom_colors();
};
}

private:
button button1;
color_dialog::colors custom_colors = {color::red, color::green, color::blue, color::yellow, system_colors::control()};
};
auto main()->int {
application::run(form1 {});
}

Examples:: color_dialog.cpp, and demo.cpp.

Public Types
using	colors = std::vector< xtd::drawing::color >
	@ brief Represents an xtd::drawing::color array. More...

Constructors
	color_dialog ()
	Initializes a new instance of the color_dialog class. More...

Properties
bool	alpha_color () const noexcept
	Gets a value indicating whether the dialog box shows alpha values and an opacity selector (slider). More...

color_dialog &	alpha_color (bool alpha_color)
	Sets a value indicating whether the user can use the dialog box to define custom colors. More...

bool	allow_full_open () const noexcept
	Gets a value indicating whether the user can use the dialog box to define custom colors. More...

color_dialog &	allow_full_open (bool allow_full_open)
	Sets a value indicating whether the user can use the dialog box to define custom colors. More...

bool	any_color () const noexcept
	Gets a value indicating whether the dialog box displays all available colors in the set of basic colors. More...

color_dialog &	any_color (bool any_color)
	Sets a value indicating whether the dialog box displays all available colors in the set of basic colors. More...

drawing::color	color () const noexcept
	Gets the color selected by the user. More...

color_dialog &	color (const drawing::color &color)
	Sets the color selected by the user. More...

const colors &	custom_colors () const noexcept
	Gets the set of custom colors shown in the dialog box. More...

color_dialog &	custom_colors (const colors &custom_colors)
	Sets the set of custom colors shown in the dialog box. More...

bool	full_open () const noexcept
	Gets a value indicating whether the controls used to create custom colors are visible when the dialog box is opened. More...

color_dialog &	full_open (bool full_open)
	Sets a value indicating whether the controls used to create custom colors are visible when the dialog box is opened. More...

size_t	options () const noexcept
	Gets values to initialize the color_dialog. More...

bool	show_help () const noexcept
	Gets a value indicating whether a Help button appears in the color dialog box. More...

color_dialog &	show_help (bool show_help)
	Sets a value indicating whether a Help button appears in the color dialog box. More...

bool	solid_color_only () const noexcept
	Gets a value indicating whether the dialog box will restrict users to selecting solid colors only. More...

color_dialog &	solid_color_only (bool solid_color_only)
	Sets a value indicating whether the dialog box will restrict users to selecting solid colors only. More...

virtual const xtd::ustring &	title () const noexcept
	Gets the color dialog box title. More...

virtual color_dialog &	title (const xtd::ustring &value)
	Sets the color dialog box title. More...

Methods
void	reset () noexcept override
	Resets all options to their default values, the last selected color to black, and the custom colors to their default values. More...

Protected methods
bool	run_dialog (intptr owner) override
	When overridden in a derived class, specifies a common dialog box. More...

void	run_sheet (intptr owner) override
	When overridden in a derived class, specifies a common dialog box. More...

Additional Inherited Members
Public Attributes inherited from xtd::forms::common_dialog
event< common_dialog, help_event_handler >	help_request
	Occurs when the user clicks the Help button on a common dialog box. More...

event< common_dialog, dialog_closed_event_handler >	dialog_closed
	Occurs when the user close a common dialog box with dialog close button or other dialog buttons. More...

Public Member Functions inherited from xtd::forms::common_dialog
	common_dialog ()
	Initializes a new instance of the common_dialog class. More...

xtd::forms::dialog_result	dialog_result () const noexcept
	Gets async dialog_result result after dialog box is closing. More...

std::any	tag () const noexcept
	Gets an object that contains data about the control. More...

common_dialog &	tag (const std::any &tag)
	Sets an object that contains data about the control. More...

xtd::forms::dialog_result	show_dialog ()
	Runs a common dialog box with a default owner. More...

xtd::forms::dialog_result	show_dialog (const iwin32_window &owner)
	Runs a common dialog box with the specified owner. More...

void	show_sheet (const iwin32_window &owner)
	Runs a common dialog box with the specified owner. More...

xtd::forms::dialog_result	show_sheet_dialog (const iwin32_window &owner)
	Runs a common dialog box with the specified owner. More...

Public Member Functions inherited from xtd::object
	object ()=default
	Create a new instance of the ultimate base class object. More...

bool	equals (const object &obj) const noexcept
	Determines whether the specified object is equal to the current object. More...

virtual size_t	get_hash_code () const noexcept
	Serves as a hash function for a particular type. More...

virtual type_object	get_type () const noexcept
	Gets the type of the current instance. More...

template<typename object_t >
std::unique_ptr< object_t >	memberwise_clone () const noexcept
	Creates a shallow copy of the current object. More...

virtual xtd::ustring	to_string () const noexcept
	Returns a sxd::ustring that represents the current object. More...

Static Public Member Functions inherited from xtd::object
static bool	equals (const object &object_a, const object &object_b) noexcept
	Determines whether the specified object instances are considered equal. More...

static bool	reference_equals (const object &object_a, const object &object_b) noexcept
	Determines whether the specified object instances are the same instance. More...

Protected Member Functions inherited from xtd::forms::common_dialog
virtual void	on_dialog_closed (const dialog_closed_event_args &e)
	Raises the common_dialog::dialog_close event. More...

virtual void	on_help_request (help_event_args &e)
	Raises the common_dialog::help_request event. More...

void	set_dialog_result (xtd::forms::dialog_result value)
	Sets async dialog_result result after dialog box is closing. More...

Protected Member Functions inherited from xtd::forms::component
	component ()
	Initialises a new instance of the component class. More...

virtual bool	can_raise_events () const noexcept
	Gets a value indicating whether the component can raise an event. More...

bool	design_mode () const noexcept
	Gets a value that indicates whether the component is currently in design mode. More...

Member Typedef Documentation

◆ colors

using xtd::forms::color_dialog::colors = std::vector<xtd::drawing::color>

@ brief Represents an xtd::drawing::color array.

Constructor & Destructor Documentation

◆ color_dialog()

xtd::forms::color_dialog::color_dialog ( )

Initializes a new instance of the color_dialog class.

Remarks

When you create an instance of ColorDialog, the following read/write properties are set to initial values.

Property	Initial Value
alpha_color	true
allow_full_open	true
any_color	false
color	drawing::color::black
custom_colors	has no value
full_open	false
show_help	false
solid_color_only	false

You can change the value for any of these properties through a separate call to the property.

Member Function Documentation

◆ allow_full_open() [1/2]

bool xtd::forms::color_dialog::allow_full_open ( ) const

noexcept

Gets a value indicating whether the user can use the dialog box to define custom colors.

Returns: true if the user can define custom colors; otherwise, false. The default is true.

◆ allow_full_open() [2/2]

color_dialog& xtd::forms::color_dialog::allow_full_open ( bool allow_full_open )

Sets a value indicating whether the user can use the dialog box to define custom colors.

Parameters

allow_full_open true if the user can define custom colors; otherwise, false. The default is true.

◆ alpha_color() [1/2]

bool xtd::forms::color_dialog::alpha_color ( ) const

noexcept

Gets a value indicating whether the dialog box shows alpha values and an opacity selector (slider).

Returns: true if the dialog box shows alpha values and an opacity selector (slider); otherwise, false. The default is true.

◆ alpha_color() [2/2]

color_dialog& xtd::forms::color_dialog::alpha_color ( bool alpha_color )

Sets a value indicating whether the user can use the dialog box to define custom colors.

Parameters

alpha_color true if the dialog box shows alpha values and an opacity selector (slider); otherwise, false.

◆ any_color() [1/2]

bool xtd::forms::color_dialog::any_color ( ) const

noexcept

Gets a value indicating whether the dialog box displays all available colors in the set of basic colors.

Returns: true if the dialog box displays all available colors in the set of basic colors; otherwise, false. The default value is false.

◆ any_color() [2/2]

color_dialog& xtd::forms::color_dialog::any_color ( bool any_color )

Sets a value indicating whether the dialog box displays all available colors in the set of basic colors.

Parameters

any_color true if the dialog box displays all available colors in the set of basic colors; otherwise, false. The default value is false.

◆ color() [1/2]

drawing::color xtd::forms::color_dialog::color ( ) const

noexcept

Gets the color selected by the user.

Returns: The color selected by the user. If a color is not selected, the default value is black.

Remarks: The color selected by the user in the dialog box at run time, as defined in color structure.

Examples:: color_dialog.cpp, and demo.cpp.

◆ color() [2/2]

color_dialog& xtd::forms::color_dialog::color ( const drawing::color & color )

Sets the color selected by the user.

Parameters

color The color selected by the user. If a color is not selected.

Remarks: The color selected by the user in the dialog box at run time, as defined in color structure.

◆ custom_colors() [1/2]

const colors& xtd::forms::color_dialog::custom_colors ( ) const

noexcept

Gets the set of custom colors shown in the dialog box.

Returns: A set of custom colors shown by the dialog box. The default value is empty.

Remarks: Users can create their own set of custom colors. These colors are contained in an int32 composed of the BGR (blue, green, red) values necessary to create the color.; Custom colors can only be defined if allow_full_open is set to true.

◆ custom_colors() [2/2]

color_dialog& xtd::forms::color_dialog::custom_colors ( const colors & custom_colors )

Sets the set of custom colors shown in the dialog box.

Parameters

custom_color A set of custom colors shown by the dialog box.

Remarks: Users can create their own set of custom colors. These colors are contained in an int32 composed of the BGR (blue, green, red) values necessary to create the color.; Custom colors can only be defined if allow_full_open is set to true.

◆ full_open() [1/2]

bool xtd::forms::color_dialog::full_open ( ) const

noexcept

Gets a value indicating whether the controls used to create custom colors are visible when the dialog box is opened.

Returns: true if the custom color controls are available when the dialog box is opened; otherwise, false. The default value is false.

Remarks: By default, the custom color controls are not visible when the dialog box is first opened. You must click the Custom Colors button to display them.

Note: If allow_full_open is false, then full_open has no effect.

◆ full_open() [2/2]

color_dialog& xtd::forms::color_dialog::full_open ( bool full_open )

Sets a value indicating whether the controls used to create custom colors are visible when the dialog box is opened.

Parameters

full_open true if the custom color controls are available when the dialog box is opened; otherwise, false. The default value is false.

Remarks: By default, the custom color controls are not visible when the dialog box is first opened. You must click the Custom Colors button to display them.

Note: If allow_full_open is false, then full_open has no effect.

◆ options()

size_t xtd::forms::color_dialog::options ( ) const

noexcept

Gets values to initialize the color_dialog.

Returns: A bitwise combination of internal values that initializes the color_dialog.

Remarks: The options property corresponds to the flags used to initialize a color dialog box using Win32. Use the properties of the color_dialog class to get and set the options.

◆ reset()

void xtd::forms::color_dialog::reset ( )

overridevirtualnoexcept

Resets all options to their default values, the last selected color to black, and the custom colors to their default values.

Implements xtd::forms::common_dialog.

◆ run_dialog()

bool xtd::forms::color_dialog::run_dialog ( intptr owner )

overrideprotectedvirtual

When overridden in a derived class, specifies a common dialog box.

Parameters

owner A value that represents the window handle of the owner window for the common dialog box.

Returns: true if the dialog box was successfully run; otherwise, false.

Implements xtd::forms::common_dialog.

◆ run_sheet()

void xtd::forms::color_dialog::run_sheet ( intptr owner )

overrideprotectedvirtual

When overridden in a derived class, specifies a common dialog box.

Parameters

owner A value that represents the window handle of the owner window for the common dialog box.

Implements xtd::forms::common_dialog.

◆ show_help() [1/2]

bool xtd::forms::color_dialog::show_help ( ) const

noexcept

Gets a value indicating whether a Help button appears in the color dialog box.

Returns: true if the Help button is shown in the dialog box; otherwise, false. The default value is false.

◆ show_help() [2/2]

color_dialog& xtd::forms::color_dialog::show_help ( bool show_help )

Sets a value indicating whether a Help button appears in the color dialog box.

Parameters

show_help true if the Help button is shown in the dialog box; otherwise, false.

◆ solid_color_only() [1/2]

bool xtd::forms::color_dialog::solid_color_only ( ) const

noexcept

Gets a value indicating whether the dialog box will restrict users to selecting solid colors only.

Returns: true if users can select only solid colors; otherwise, false. The default value is false.

Remarks: This property is applicable to systems with 256 or fewer colors. On these types of systems, some colors are composites of others.

◆ solid_color_only() [2/2]

color_dialog& xtd::forms::color_dialog::solid_color_only ( bool solid_color_only )

Sets a value indicating whether the dialog box will restrict users to selecting solid colors only.

Parameters

solid_color_only true if users can select only solid colors; otherwise, false.

Remarks: This property is applicable to systems with 256 or fewer colors. On these types of systems, some colors are composites of others.

◆ title() [1/2]

virtual const xtd::ustring& xtd::forms::color_dialog::title ( ) const

virtualnoexcept

Gets the color dialog box title.

Returns: The color dialog box title. The default value is an empty string ("").

Remarks: The string is placed in the title bar of the dialog box. If the title is an empty string, the system uses a default title, which is "Color".

◆ title() [2/2]

virtual color_dialog& xtd::forms::color_dialog::title ( const xtd::ustring & value )

virtual

Sets the color dialog box title.

Parameters

value The file dialog box title. The default value is an empty string ("").

Returns: Current file_dialog.

Remarks: The string is placed in the title bar of the dialog box. If the title is an empty string, the system uses a default title, which is "Color".

The documentation for this class was generated from the following file:

xtd.forms/include/xtd/forms/color_dialog.h

Definition

Public Types

Constructors

Properties

Methods

Protected methods

Additional Inherited Members

Member Typedef Documentation

◆ colors

Constructor & Destructor Documentation

◆ color_dialog()

Member Function Documentation

◆ allow_full_open() [1/2]

◆ allow_full_open() [2/2]

◆ alpha_color() [1/2]

◆ alpha_color() [2/2]

◆ any_color() [1/2]

◆ any_color() [2/2]

◆ color() [1/2]

◆ color() [2/2]

◆ custom_colors() [1/2]

◆ custom_colors() [2/2]

◆ full_open() [1/2]

◆ full_open() [2/2]

◆ options()

◆ reset()

◆ run_dialog()

◆ run_sheet()

◆ show_help() [1/2]

◆ show_help() [2/2]

◆ solid_color_only() [1/2]

◆ solid_color_only() [2/2]

◆ title() [1/2]

◆ title() [2/2]