[−][src]Struct native_windows_gui::DatePicker
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.font
: 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
impl DatePicker
[src]
pub fn builder<'a>() -> DatePickerBuilder<'a>
[src]
pub fn set_format<'a>(&self, format: Option<&'a str>)
[src]
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.
pub fn checked(&self) -> bool
[src]
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
pub fn close_calendar(&self)
[src]
Close the calendar popup if it is open. Note that there is no way to force the calendar to drop down
pub fn value(&self) -> Option<DatePickerValue>
[src]
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.
pub fn set_value(&self, date: Option<DatePickerValue>)
[src]
Set the time set in the control in a PickerDate
structure.
If None
is passed, this clears the checkbox.
pub fn range(&self) -> [DatePickerValue; 2]
[src]
Gets the current minimum and maximum allowable system times for a date and time picker control.
pub fn set_range(&self, r: &[DatePickerValue; 2])
[src]
Sets the minimum and maximum allowable system times for a date and time picker control.
pub fn font(&self) -> Option<Font>
[src]
Return the font of the control
pub fn set_font(&self, font: Option<&Font>)
[src]
Sets the font of the control
pub fn focus(&self) -> bool
[src]
Return true if the control currently has the keyboard focus
pub fn set_focus(&self)
[src]
Sets the keyboard focus on the button.
pub fn enabled(&self) -> bool
[src]
Return true if the control user can interact with the control, return false otherwise
pub fn set_enabled(&self, v: bool)
[src]
Enable or disable the control
pub fn visible(&self) -> bool
[src]
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))
pub fn set_visible(&self, v: bool)
[src]
Show or hide the control to the user
pub fn size(&self) -> (u32, u32)
[src]
Return the size of the date picker in the parent window
pub fn set_size(&self, x: u32, y: u32)
[src]
Set the size of the date picker in the parent window
pub fn position(&self) -> (i32, i32)
[src]
Return the position of the date picker in the parent window
pub fn set_position(&self, x: i32, y: i32)
[src]
Set the position of the date picker in the parent window
pub fn class_name(&self) -> &'static str
[src]
Winapi class name used during control creation
pub fn flags(&self) -> u32
[src]
Winapi base flags used during window creation
pub fn forced_flags(&self) -> u32
[src]
Winapi flags required by the control
Trait Implementations
impl Default for DatePicker
[src]
fn default() -> DatePicker
[src]
impl Drop for DatePicker
[src]
impl Eq for DatePicker
[src]
impl<'_> From<&'_ DatePicker> for ControlHandle
[src]
fn from(control: &DatePicker) -> Self
[src]
impl PartialEq<ControlHandle> for DatePicker
[src]
fn eq(&self, other: &ControlHandle) -> bool
[src]
#[must_use]fn ne(&self, other: &Rhs) -> bool
1.0.0[src]
impl PartialEq<DatePicker> for DatePicker
[src]
fn eq(&self, other: &DatePicker) -> bool
[src]
fn ne(&self, other: &DatePicker) -> bool
[src]
impl PartialEq<DatePicker> for ControlHandle
[src]
impl StructuralEq for DatePicker
[src]
impl StructuralPartialEq for DatePicker
[src]
Auto Trait Implementations
impl RefUnwindSafe for DatePicker
impl !Send for DatePicker
impl !Sync for DatePicker
impl Unpin for DatePicker
impl UnwindSafe for DatePicker
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,