pub struct DatePicker {
pub handle: ControlHandle,
}Expand description
A date and time picker (DTP) control provides a simple and intuitive interface through which to exchange date and time information with a user. For example, with a DTP control you can ask the user to enter a date and then easily retrieve the selection.
Requires the datetime-picker feature.
Builder parameters:
parent: Required. The dtp parent container.size: The dtp size.position: The dtp position.enabled: If the dtp can be used by the user. It also has a grayed out look if disabled.flags: A combination of the DatePickerFlags values.ex_flags: A combination of win32 window extended flags. Unlikeflags, ex_flags must be used straight from winapifont: The font used for the dtp textdate: The default date as aDatePickerValuevalueformat: The format of the date. See theset_formatmethod.range: The accepted range of dates. The value is inclusive.focus: The control receive focus after being created
Control events:
OnDatePickerClosed: When the datepicker dropdown is closedOnDatePickerDropdown: When the datepicker dropdown is openedOnDatePickerChanged: When a new value in a datepicker is choosenMousePress(_): Generic mouse press events on the checkboxOnMouseMove: Generic mouse mouse eventOnMouseWheel: Generic mouse wheel event
use native_windows_gui as nwg;
fn build_dtp(date: &mut nwg::DatePicker, window: &nwg::Window) {
let v = nwg::DatePickerValue { year: 2000, month: 10, day: 5 };
let v1 = nwg::DatePickerValue { year: 2000, month: 10, day: 5 };
let v2 = nwg::DatePickerValue { year: 2012, month: 10, day: 5 };
nwg::DatePicker::builder()
.size((200, 300))
.position((0, 0))
.date(Some(v))
.format(Some("'YEAR: 'yyyy"))
.range(Some([v1, v2]))
.parent(window)
.build(date);
}Fields§
§handle: ControlHandleImplementations§
Source§impl DatePicker
impl DatePicker
pub fn builder<'a>() -> DatePickerBuilder<'a>
Sourcepub fn set_format<'a>(&self, format: Option<&'a str>)
pub fn set_format<'a>(&self, format: Option<&'a str>)
Sets the date format of the control
About the format string:
-
dThe one- or two-digit day. -
ddThe two-digit day. Single-digit day values are preceded by a zero. -
dddThe three-character weekday abbreviation. -
ddddThe full weekday name. -
MThe one- or two-digit month number. -
MMThe two-digit month number. Single-digit values are preceded by a zero. -
MMMThe three-character month abbreviation. -
MMMMThe full month name. -
tThe one-letter AM/PM abbreviation (that is, AM is displayed as “A”). -
ttThe two-letter AM/PM abbreviation (that is, AM is displayed as “AM”). -
yyThe last two digits of the year (that is, 1996 would be displayed as “96”). -
yyyyThe full year (that is, 1996 would be displayed as “1996”). -
hThe one- or two-digit hour in 12-hour format. -
hhThe two-digit hour in 12-hour format. Single-digit values are preceded by a zero. -
HThe one- or two-digit hour in 24-hour format. -
HHThe two-digit hour in 24-hour format. Single-digit values are preceded by a zero. -
mThe one- or two-digit minute. -
mmThe two-digit minute. Single-digit values are preceded by a zero.
Furthermore, any string enclosed in ' can be used in the format to display text.
For example, to display the current date with the format 'Today is: Tuesday Mar 23, 1996, the format string is 'Today is: 'dddd MMM dd', 'yyyy.
If format is set to None, use the default system format.
Sourcepub fn checked(&self) -> bool
pub fn checked(&self) -> bool
Return the check state of the checkbox of the control.
If the date time picker is not optional, return false.
To set the check state of the control, use set_value method
Sourcepub fn close_calendar(&self)
pub fn close_calendar(&self)
Close the calendar popup if it is open. Note that there is no way to force the calendar to drop down
Sourcepub fn value(&self) -> Option<DatePickerValue>
pub fn value(&self) -> Option<DatePickerValue>
Return the time set in the control in a PickerDate structure.
Return None if optional was set and the checkbox is not checked.
Note: use get_text to get the text value of the control.
Sourcepub fn set_value(&self, date: Option<DatePickerValue>)
pub fn set_value(&self, date: Option<DatePickerValue>)
Set the time set in the control in a PickerDate structure.
If None is passed, this clears the checkbox.
Sourcepub fn range(&self) -> [DatePickerValue; 2]
pub fn range(&self) -> [DatePickerValue; 2]
Gets the current minimum and maximum allowable system times for a date and time picker control.
Sourcepub fn set_range(&self, r: &[DatePickerValue; 2])
pub fn set_range(&self, r: &[DatePickerValue; 2])
Sets the minimum and maximum allowable system times for a date and time picker control.
Sourcepub fn enabled(&self) -> bool
pub fn enabled(&self) -> bool
Return true if the control user can interact with the control, return false otherwise
Sourcepub fn set_enabled(&self, v: bool)
pub fn set_enabled(&self, v: bool)
Enable or disable the control
Sourcepub fn visible(&self) -> bool
pub fn visible(&self) -> bool
Return true if the control is visible to the user. Will return true even if the control is outside of the parent client view (ex: at the position (10000, 10000))
Sourcepub fn set_visible(&self, v: bool)
pub fn set_visible(&self, v: bool)
Show or hide the control to the user
Sourcepub fn position(&self) -> (i32, i32)
pub fn position(&self) -> (i32, i32)
Return the position of the date picker in the parent window
Sourcepub fn set_position(&self, x: i32, y: i32)
pub fn set_position(&self, x: i32, y: i32)
Set the position of the date picker in the parent window
Sourcepub fn class_name(&self) -> &'static str
pub fn class_name(&self) -> &'static str
Winapi class name used during control creation
Sourcepub fn forced_flags(&self) -> u32
pub fn forced_flags(&self) -> u32
Winapi flags required by the control