Struct ColorPicker 

pub struct ColorPicker<'a> {
    pub title: &'a str,
    pub value: ColorValue,
    pub owner: Option<&'a dyn HasWindowHandle>,
}

Color picker dialog.

The color picker dialog allows the user to select a color, which is returned as an RGB value. The dialog may also show a palette of predefined colors for the user to choose from.

let color = rustydialogs::ColorPicker {
	title: "Pick a Color",
	value: rustydialogs::ColorValue {
		red: 64,
		green: 128,
		blue: 255,
	},
	owner: None,
}.show();

if let Some(color) = color {
	println!("RGB({}, {}, {})", color.red, color.green, color.blue);
}

Fields

title: &'a str

The title of the dialog.

value: ColorValue

The initial color value to show in the color picker dialog.

owner: Option<&'a dyn HasWindowHandle>

The owner window of the dialog.

Implementations

impl<'a> ColorPicker<'a>

pub fn show(&self) -> Option<ColorValue>

Show the dialog.

Returns Some(ColorValue) if the user selected a color and confirmed the dialog, or None if the user cancelled the dialog.

Examples found in repository

examples/color_picker.rs (line 12)

fn main() {
	let picker = rustydialogs::ColorPicker {
		title: "Pick a color",
		value: rustydialogs::ColorValue {
			red: 0xFF,
			green: 0x00,
			blue: 0x77,
		},
		owner: None,
	};

	match picker.show() {
		Some(color) => println!(
			"Selected color: #{:02X}{:02X}{:02X}",
			color.red, color.green, color.blue
		),
		None => println!("Color selection canceled"),
	}
}

examples/tests.rs (line 293)

fn test_color_picker() {
	println!("\n{}", Color("==== Testing ColorPicker ====", "120;190;255"));

	step("Select pure RED (#FF0000) and press OK.",
		Some(rustydialogs::ColorValue { red: 255, green: 0, blue: 0 }),
		|| rustydialogs::ColorPicker {
			title: "[tests] ColorPicker",
			value: rustydialogs::ColorValue { red: 255, green: 0, blue: 0 },
			owner: None,
		}.show()
	);

	step("Select specific color (#4FB3A3) (79, 179, 163) and press OK.",
		Some(rustydialogs::ColorValue { red: 79, green: 179, blue: 163 }),
		|| rustydialogs::ColorPicker {
			title: "[tests] ColorPicker",
			value: rustydialogs::ColorValue { red: 255, green: 0, blue: 0 },
			owner: None,
		}.show()
	);

	step("Dismiss the dialog.",
		None,
		|| rustydialogs::ColorPicker {
			title: "[tests] Dismiss ColorPicker",
			value: rustydialogs::ColorValue { red: 255, green: 0, blue: 0 },
			owner: None,
		}.show()
	);
}

Trait Implementations

impl<'a> Clone for ColorPicker<'a>

fn clone(&self) -> ColorPicker<'a>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Copy for ColorPicker<'a>