xtd::forms::selection_range Class Reference

Definition

Represents a date selection range in a month calendar control.

Header

#include <xtd/forms/selection_range> 

Namespace

xtd::forms

Library

xtd.forms

Examples

The following example sets the xtd::forms::month_calendar::selection_range property of a xtd::forms::month_calendar control based on two dates entered into two xtd::forms::text_box controls when a xtd::forms::button is clicked. This code assumes new instances of a xtd::forms::month_calendar control, two xtd::forms::text_box controls, and a xtd::forms::button have been created on a xtd::forms::form. You might consider adding code to validate the xtd::forms::control::text assigned to the text boxes to verify that they contain valid dates.

void button1_click(const object& sender, const event_args& e) {
  // Set the selection_range with start and end dates from text boxes.
  try {
    month_calendar1.selection_range(selection_range(date_time::parse(text_box1.text(), date_time::parse(text_box2.text()));
  } catch(const system_exception& ex) {
    message_box::show(ex.message());
  }
}

Remarks

The xtd::forms::selection_range is the date or dates selected and highlighted on the xtd::forms::month_calendar control. If only one date is selected, the xtd::forms::selection_range::start and xtd::forms::selection_range::end property values will be equal. The xtd::forms::selection_range can be changed by the user clicking a date while dragging the mouse pointer across the desired dates, or you can set the range in code. For example, you might want to have the user enter a date range into two xtd::forms::text_box controls or two xtd::forms::date_time_picker controls and set the xtd::forms::selection_range based on those dates.

	selection_range ()=default
	Constructors More...
	selection_range (date_time start, date_time end)
	Initializes a new instance of the xtd::forms::selection_range class with the specified beginning and ending dates. More...
virtual date_time	end () const noexcept
	Properties More...
virtual selection_range &	end (date_time value)
	Sets the ending date and time of the selection range. More...
virtual date_time	start () const noexcept
	Gets the starting date and time of the selection range. More...
virtual selection_range &	start (date_time value)
	Sets the starting date and time of the selection range. More...
xtd::ustring	to_string () const noexcept override

Additional Inherited Members
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...
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...

Constructor & Destructor Documentation

selection_range() [1/2]

xtd::forms::selection_range::selection_range ( )

default

Constructors

Initializes a new instance of the xtd::forms::selection_range class.

Remarks

The xtd::forms::selection_range::start and xtd::forms::selection_range::end values are set to xtd::date_time::min_value when this constructor is used.

selection_range() [2/2]

xtd::forms::selection_range::selection_range	(	date_time	start,
		date_time	end
	)

Initializes a new instance of the xtd::forms::selection_range class with the specified beginning and ending dates.

Parameters

start	The starting date in the xtd::forms::selection_range.
end	The ending date in the xtd::forms::selection_range.

Remarks

If the lower xtd::dateTime value is greater than the upper xtd::date_time value, the lower value will be assigned to the xtd::forms::selection_range::end property instead of the xtd::forms::selection_range::start property.

Member Function Documentation

end() [1/2]

virtual date_time xtd::forms::selection_range::end ( ) const

virtualnoexcept

Properties

Gets the ending date and time of the selection range.

Returns

The ending xtd::date_time value of the range.

end() [2/2]

virtual selection_range& xtd::forms::selection_range::end ( date_time  value )

virtual

Sets the ending date and time of the selection range.

Parameters

value

The ending xtd::date_time value of the range.

Returns

This current instance.

start() [1/2]

virtual date_time xtd::forms::selection_range::start ( ) const

virtualnoexcept

Gets the starting date and time of the selection range.

Returns

The starting xtd::date_time value of the range.

start() [2/2]

virtual selection_range& xtd::forms::selection_range::start ( date_time  value )

virtual

Sets the starting date and time of the selection range.

Parameters

value

The starting xtd::date_time value of the range.

Returns

This current instance.

to_string()

xtd::ustring xtd::forms::selection_range::to_string ( ) const

overridevirtualnoexcept

Methods

Reimplemented from xtd::object.

---

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

• xtd.forms/include/xtd/forms/selection_range.h