Namespace: Consultingwerk.Windows.Util
Class 
DateRangeDataFilter Copy to Clipboard
Parent classes:
Progress.Lang.Object
Consultingwerk.Windows.Util.DateRangeDataFilter

Inherits: Progress.Lang.Object
Implements: Infragistics.Win.IEditorDataFilter


Navigate to: Methods | Constructors | Events | Properties | ProDatasets | Temp-Tables



Top Method Summary
Options Name Purpose
AfterEditorButtonCloseUpHandler (Object, EditorButtonEventArgs) Event handler for the AfterEditorButtonCloseUp event of the UltraTextEditor
BeforeEditorButtonDropDownHandler (Object, BeforeEditorButtonDropDownEventArgs) Event handler for the BeforeEditorButtonDropDown event of the UltraTextEditor
System.Object Convert (EditorDataFilterConvertArgs) Converts between the value of the editor (display text) and the value of the filter cell (ISO date range)
Infragistics.Win.UltraWinEditors.UltraDateTimeEditor CreateDatePicker () Creates a date picker of the drop down
DatePickerValueChangedHandler (Object, EventArgs) Event handler for the ValueChanged event of the date pickers
Consultingwerk.Windows.Util.DateRangeDataFilter EnableDateRangeFilter (UltraGrid, UltraGridColumn, date, date) Assigns the date range filter cell to the filter cell of a column
CHARACTER FormatDate (date) Returns a date in the short date format of the current culture
Consultingwerk.Windows.Util.DateRangeDataFilter FromEditorComponent (Object) Returns the DateRangeDataFilter of an editor component
DATE GetPickerDate (UltraDateTimeEditor) Returns the date of a date picker
LOGICAL IsValidRange (date, date) Returns if a date range can be applied as a filter
DATE ParseDate (character) Parses a date in the date format of the current culture
LOGICAL ParseDisplayText (character, date, date) Parses a display text (typed by the user) into the from and to date
DATE ParseIsoDate (character) Parses an ISO date (yyyy-mm-dd)
LOGICAL ParseRangeValue (character, date, date) Parses the value of the filter cell into the from and to date
ReadEditorValue (EmbeddableEditorBase, date, date) Reads the range from the current value of the embedded editor
SetLimits (date, date) Assigns the limits of the date range
CHARACTER ToDisplayText (date, date) Returns the display text of a date range
CHARACTER ToRangeValue (date, date) Returns the value of the filter cell for a date range

Top Constructor Summary
Options Name Purpose
DateRangeDataFilter (date, date) Constructor for the DateRangeDataFilter class

Top Property Summary
Options Name Purpose
DATE LowerLimit
CHARACTER RangeDelimiter
Infragistics.Win.UltraWinEditors.UltraTextEditor TextEditor
CHARACTER TextSeparator
DATE UpperLimit


Method Detail
Top

AfterEditorButtonCloseUpHandler (Object, EditorButtonEventArgs)
Purpose: Event handler for the AfterEditorButtonCloseUp event of the
UltraTextEditor
Notes: Releases the embedded editor of the filter cell

Parameters:
sender System.Object
The object that raised the AfterEditorButtonCloseUp event
e Infragistics.Win.UltraWinEditors.EditorButtonEventArgs
The EditorButtonEventArgs with the data for this event
Top

BeforeEditorButtonDropDownHandler (Object, BeforeEditorButtonDropDownEventArgs)
Purpose: Event handler for the BeforeEditorButtonDropDown event of the
UltraTextEditor
Notes: Remembers the embedded editor of the filter cell and initializes
the date pickers with its current value

Parameters:
sender System.Object
The object that raised the BeforeEditorButtonDropDown event
e Infragistics.Win.UltraWinEditors.BeforeEditorButtonDropDownEventArgs
The BeforeEditorButtonDropDownEventArgs with the data for this event
Top

System.Object Convert (EditorDataFilterConvertArgs)
Purpose: Converts between the value of the editor (display text) and the
value of the filter cell (ISO date range)
Notes: Implementation of IEditorDataFilter. An invalid text or a range
outside the limits is reported as invalid, so the editor rejects
it and the filter cell keeps its previous value.

Parameters:
args Infragistics.Win.EditorDataFilterConvertArgs
The EditorDataFilterConvertArgs with the data for the conversion
Returns System.Object
The converted value
Top

Infragistics.Win.UltraWinEditors.UltraDateTimeEditor CreateDatePicker ()
Purpose: Creates a date picker of the drop down
Notes:

Returns Infragistics.Win.UltraWinEditors.UltraDateTimeEditor
The UltraDateTimeEditor
Top

DatePickerValueChangedHandler (Object, EventArgs)
Purpose: Event handler for the ValueChanged event of the date pickers
Notes: Writes the selected range into the embedded editor of the filter
cell. A range outside the limits or with the from date after the
to date is not written.

Parameters:
sender System.Object
The object that raised the ValueChanged event
e System.EventArgs
The System.EventArgs with the data for this event
Top

Consultingwerk.Windows.Util.DateRangeDataFilter EnableDateRangeFilter (UltraGrid, UltraGridColumn, date, date)
Purpose: Assigns the date range filter cell to the filter cell of a column
Notes: Assigns a DateRangeDataFilter's UltraTextEditor as the editor of
the filter cell and hides the filter operator of the column (the
range has its own operators). Repeated calls only update the
limits. The editor of the column (cell editing) is not changed.

Parameters:
poGrid Infragistics.Win.UltraWinGrid.UltraGrid
The UltraGrid
poColumn Infragistics.Win.UltraWinGrid.UltraGridColumn
The date column to use the date range filter cell for
pdaLowerLimit DATE
The lowest date the user can filter for, ? for no lower bound
pdaUpperLimit DATE
The highest date the user can filter for, ? for no upper bound
Returns Consultingwerk.Windows.Util.DateRangeDataFilter
The DateRangeDataFilter of the filter cell
Top

CHARACTER FormatDate (date)
Purpose: Returns a date in the short date format of the current culture
Notes:

Parameters:
pdaDate DATE
The date to format
Returns CHARACTER
The formatted date
Top

Consultingwerk.Windows.Util.DateRangeDataFilter FromEditorComponent (Object)
Purpose: Returns the DateRangeDataFilter of an editor component
Notes: Returns the unknown value when the editor component is not the
editor of a date range filter cell

Parameters:
poComponent System.Object
The editor component (typically an UltraTextEditor)
Returns Consultingwerk.Windows.Util.DateRangeDataFilter
The DateRangeDataFilter or ?
Top

DATE GetPickerDate (UltraDateTimeEditor)
Purpose: Returns the date of a date picker
Notes:

Parameters:
poEditor Infragistics.Win.UltraWinEditors.UltraDateTimeEditor
The date picker
Returns DATE
The date or ? when no date is selected
Top

LOGICAL IsValidRange (date, date)
Purpose: Returns if a date range can be applied as a filter
Notes: At least one end has to be set, the from date must not be after
the to date and both ends have to be within the limits

Parameters:
pdaFrom DATE
The from date, ? for an open end
pdaTo DATE
The to date, ? for an open end
Returns LOGICAL
Logical value indicating if the date range is valid
Top

DATE ParseDate (character)
Purpose: Parses a date in the date format of the current culture
Notes:

Parameters:
pcText CHARACTER
The text to parse
Returns DATE
The date or ? when the text is not a date
Top

LOGICAL ParseDisplayText (character, date, date)
Purpose: Parses a display text (typed by the user) into the from and to date
Notes: Accepts "from - to", "from -", "- to" and a single date (from and
to are that date) in the short date format of the current culture.
An empty text is valid and returns two unknown dates.

Parameters:
pcText CHARACTER
The display text
pdaFrom DATE
OUTPUT The from date
pdaTo DATE
OUTPUT The to date
Returns LOGICAL
Logical value indicating if the text could be parsed
Top

DATE ParseIsoDate (character)
Purpose: Parses an ISO date (yyyy-mm-dd)
Notes:

Parameters:
pcValue CHARACTER
The ISO date
Returns DATE
The date or ? when the value is empty or not an ISO date
Top

LOGICAL ParseRangeValue (character, date, date)
Purpose: Parses the value of the filter cell into the from and to date
Notes: An empty end is returned as the unknown value

Parameters:
pcValue CHARACTER
The value of the filter cell
pdaFrom DATE
OUTPUT The from date
pdaTo DATE
OUTPUT The to date
Returns LOGICAL
Logical value indicating if the value is a valid date range value
Top

ReadEditorValue (EmbeddableEditorBase, date, date)
Purpose: Reads the range from the current value of the embedded editor
Notes: The value of the embedded editor is the value of the filter cell
(ISO date range); a value that cannot be read leaves both dates
unknown

Parameters:
poEditor Infragistics.Win.EmbeddableEditorBase
The embedded editor of the filter cell
pdaFrom DATE
OUTPUT The from date
pdaTo DATE
OUTPUT The to date
Top

SetLimits (date, date)
Purpose: Assigns the limits of the date range
Notes: The date pickers of the drop down cannot select a date outside
the limits, a typed range outside the limits is rejected

Parameters:
pdaLowerLimit DATE
The lowest date the user can filter for, ? for no lower bound
pdaUpperLimit DATE
The highest date the user can filter for, ? for no upper bound
Top

CHARACTER ToDisplayText (date, date)
Purpose: Returns the display text of a date range
Notes: The dates in the short date format of the current culture

Parameters:
pdaFrom DATE
The from date, ? for an open end
pdaTo DATE
The to date, ? for an open end
Returns CHARACTER
The display text
Top

CHARACTER ToRangeValue (date, date)
Purpose: Returns the value of the filter cell for a date range
Notes: The ISO dates of both ends separated by the RangeDelimiter, an
unknown date is an empty end. Returns the unknown value when
both ends are unknown.

Parameters:
pdaFrom DATE
The from date, ? for an open end
pdaTo DATE
The to date, ? for an open end
Returns CHARACTER
The value of the filter cell


Constructor Detail
Top

DateRangeDataFilter (date, date)
Purpose: Constructor for the DateRangeDataFilter class
Notes: Creates the UltraTextEditor with the drop down button and the date
pickers. Use EnableDateRangeFilter to assign it to a filter cell.

Parameters:
pdaLowerLimit DATE
The lowest date the user can filter for, ? for no lower bound
pdaUpperLimit DATE
The highest date the user can filter for, ? for no upper bound


Property Detail
Top

DATE LowerLimit

Returns DATE
Top

CHARACTER RangeDelimiter

Returns CHARACTER
Top

Infragistics.Win.UltraWinEditors.UltraTextEditor TextEditor

Returns Infragistics.Win.UltraWinEditors.UltraTextEditor
Top

CHARACTER TextSeparator

Returns CHARACTER
Top

DATE UpperLimit

Returns DATE


©2006-2026 Consultingwerk Ltd.         info@consultingwerk.de         http://www.consultingwerk.de       09.11.2026 08:20:38