Struct native_windows_gui::DatePicker [−][src]
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 aDatePickerValue
valueformat
: The format of the date. See theset_format
method.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: ControlHandle
Implementations
Sets the date format of the control
About the format string:
-
d
The one- or two-digit day. -
dd
The two-digit day. Single-digit day values are preceded by a zero. -
ddd
The three-character weekday abbreviation. -
dddd
The full weekday name. -
M
The one- or two-digit month number. -
MM
The two-digit month number. Single-digit values are preceded by a zero. -
MMM
The three-character month abbreviation. -
MMMM
The full month name. -
t
The one-letter AM/PM abbreviation (that is, AM is displayed as “A”). -
tt
The two-letter AM/PM abbreviation (that is, AM is displayed as “AM”). -
yy
The last two digits of the year (that is, 1996 would be displayed as “96”). -
yyyy
The full year (that is, 1996 would be displayed as “1996”). -
h
The one- or two-digit hour in 12-hour format. -
hh
The two-digit hour in 12-hour format. Single-digit values are preceded by a zero. -
H
The one- or two-digit hour in 24-hour format. -
HH
The two-digit hour in 24-hour format. Single-digit values are preceded by a zero. -
m
The one- or two-digit minute. -
mm
The 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.
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
Close the calendar popup if it is open. Note that there is no way to force the calendar to drop down
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.
Set the time set in the control in a PickerDate
structure.
If None
is passed, this clears the checkbox.
Gets the current minimum and maximum allowable system times for a date and time picker control.
Sets the minimum and maximum allowable system times for a date and time picker control.
Return true if the control user can interact with the control, return false otherwise
Enable or disable the control
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))
Show or hide the control to the user
Return the position of the date picker in the parent window
Set the position of the date picker in the parent window
Winapi class name used during control creation
Winapi flags required by the control
Trait Implementations
Returns the “default value” for a type. Read more
Performs the conversion.
Performs the conversion.
This method tests for self
and other
values to be equal, and is used
by ==
. Read more
This method tests for !=
.
Auto Trait Implementations
impl RefUnwindSafe for DatePicker
impl !Send for DatePicker
impl !Sync for DatePicker
impl Unpin for DatePicker
impl UnwindSafe for DatePicker