In This Article

DateTimeEditBox Class

Represents a date/time edit box.

public class DateTimeEditBox : PartEditBoxBase<DateTime?>
Inheritance:
object Visual UIElement FrameworkElement Control PartEditBoxBase<DateTime?> object
Derived:
DateEditBox TimeEditBox

Constructors

DateTimeEditBox()

Initializes an instance of the DateTimeEditBox class.

public DateTimeEditBox()

Properties

Format

Gets or sets the date/time format string.

public string Format { get; set; }

Property Value

string:

The date/time format string. The default value is "g".

HasPopupButtonWhenReadOnly

Gets whether the control should display the popup button when the control is read-only.

protected override bool HasPopupButtonWhenReadOnly { get; }

Property Value

bool:

true if the control should display the popup button when the control is read-only; otherwise, false.

Maximum

Gets or sets the highest possible value.

public DateTime Maximum { get; set; }

Property Value

DateTime:

The highest possible value.

Minimum

Gets or sets the lowest possible value.

public DateTime Minimum { get; set; }

Property Value

DateTime:

The lowest possible value.

ResolvedFormat

Gets the resolved date/time format string.

public string ResolvedFormat { get; }

Property Value

string:

The resolved date/time format string.

SetValueToNowCommand

Gets the ICommand that sets the value to the current date/time.

public ICommand SetValueToNowCommand { get; }

Property Value

ICommand:

The ICommand that sets the value to the current date/time.

SetValueToTodayCommand

Gets the ICommand that sets the value to the current date.

public ICommand SetValueToTodayCommand { get; }

Property Value

ICommand:

The ICommand that sets the value to the current date.

Methods

CoerceParsedValue(DateTime?)

Coerces the parsed value from text, only using components from the value for which parts are displayed in the edit box.

protected virtual DateTime? CoerceParsedValue(DateTime? value)
Parameter Type Description
value DateTime?

The value to coerce.

Returns

DateTime?:

The coerced value.

Remarks

The logic in this method ensures that time-only edit boxes retain their dates, month/day date-only edit boxes retain their years, etc.

CoerceValidValue(DateTime?)

Coerces the value to be within range.

protected override DateTime? CoerceValidValue(DateTime? value)
Parameter Type Description
value DateTime?

The value to coerce.

Returns

DateTime?:

The coerced value.

ConvertToString(DateTime?)

Converts the specified value to a string representation.

protected override string ConvertToString(DateTime? valueToConvert)
Parameter Type Description
valueToConvert DateTime?

The value.

Returns

string:

The string representation of the specified value.

CreateIncrementalChangeRequest(IncrementalChangeRequestKind)

Creates an incremental change (spin) request.

protected override IncrementalChangeRequest<DateTime?> CreateIncrementalChangeRequest(IncrementalChangeRequestKind kind)
Parameter Type Description
kind IncrementalChangeRequestKind

The kind of request.

Returns

IncrementalChangeRequest<DateTime?>:

The incremental change (spin) request that was created.

GenerateParts()

Generates the parts for the edit box.

protected override IList<IPart> GenerateParts()

Returns

IList<IPart>:

The parts that were generated.

IsValidValue(DateTime?)

Returns whether the specified value is valid.

protected override bool IsValidValue(DateTime? value)
Parameter Type Description
value DateTime?

The value to examine.

Returns

bool:

true if the value is valid; otherwise, false.

OnPopupOpened()

Occurs when the popup is opened.

protected override void OnPopupOpened()

RaiseValueChangedEvent()

Raises the ValueChanged event.

protected override void RaiseValueChangedEvent()

ResetValue()

Resets the value to a default value.

protected override void ResetValue()

TryConvertFromString(string, bool, out DateTime?)

Tries to convert the specified text to a value.

protected override bool TryConvertFromString(string textToConvert, bool canCoerce, out DateTime? value)
Parameter Type Description
textToConvert string

The text.

canCoerce bool

Whether the returned value should be coerced to fall within the allowed value range.

value DateTime?

Returns the value for the specified text.

Returns

bool:

true if the text was converted to a value successfully; otherwise, false.

Events

ValueChanged

Occurs after the Value property value changes.

public event EventHandler ValueChanged

Event Type

EventHandler

Fields

FormatProperty

Identifies the Format dependency property. This field is read-only.

public static readonly DependencyProperty FormatProperty

MaximumProperty

Identifies the Maximum dependency property. This field is read-only.

public static readonly DependencyProperty MaximumProperty

MinimumProperty

Identifies the Minimum dependency property. This field is read-only.

public static readonly DependencyProperty MinimumProperty

ResolvedFormatProperty

Identifies the ResolvedFormat dependency property. This field is read-only.

public static readonly DependencyProperty ResolvedFormatProperty

Inherited Members