HijriDatePickerController class Null safety

An object that used for programmatic date navigation, date and range selection and view switching in SfHijriDateRangePicker.

A HijriDatePickerController served for several purposes. It can be used to selected dates and ranges programmatically on SfHijriDateRangePicker by using the controller.selectedDate, controller.selectedDates, controller.selectedRange, controller.selectedRanges. It can be used to change the SfHijriDateRangePicker view by using the controller.view property. It can be used to navigate to specific date by using the controller.displayDate property.

Listening to property changes:

The HijriDatePickerController is a listenable. It notifies it's listeners whenever any of attached SfHijriDateRangePicker`s selected date, display date and view changed (i.e: selecting a different date, swiping to next/previous view and navigates to different view] in in SfHijriDateRangePicker.

The SfHijriDateRangePicker visible view can be changed by using the Controller.view property, the property allow to change the view of SfHijriDateRangePicker programmatically on initial load and in rum time.

Programmatic selection:

In SfHijriDateRangePicker selecting dates programmatically can be achieved by using the controller.selectedDate, controller.selectedDates, controller.selectedRange, controller.selectedRanges which allows to select the dates or ranges programmatically on SfHijriDateRangePicker on initial load and in run time.

Defaults to null.

See also:

This example demonstrates how to use the HijriDatePickerController for SfHijriDateRangePicker.


class MyApp extends StatefulWidget {
 @override
 MyAppState createState() => MyAppState();
}

class MyAppState extends State<MyApp> {
 HijriDatePickerController _pickerController = HijriDatePickerController();

 @override
 void initState() {
   _pickerController.selectedDates = <HijriDateTime>[
     HijriDateTime.now().add(Duration(days: 2)),
     HijriDateTime.now().add(Duration(days: 4)),
     HijriDateTime.now().add(Duration(days: 7)),
     HijriDateTime.now().add(Duration(days: 11))
   ];
   _pickerController.displayDate = HijriDateTime.now();
   _pickerController.addPropertyChangedListener(handlePropertyChange);
   super.initState();
 }

 void handlePropertyChange(String propertyName) {
   if (propertyName == 'selectedDates') {
     final List<HijriDateTime> selectedDates =
                                _pickerController.selectedDates!;
   } else if (propertyName == 'displayDate') {
     final HijriDateTime displayDate = _pickerController.displayDate!;
   }
 }

 @override
 Widget build(BuildContext context) {
   return MaterialApp(
     home: Scaffold(
       body: SfHijriDateRangePicker(
         view: HijriDatePickerView.month,
         controller: _pickerController,
         selectionMode: DateRangePickerSelectionMode.multiple,
       ),
     ),
   );
 }
}

Inheritance

Constructors

HijriDatePickerController()

Properties

backward VoidCallback?
Moves to the previous view programmatically with animation by checking that the previous view dates falls between the minimum and maximum date range. [...]
read / write
displayDate HijriDateTime?
The first date of the current visible view month, when the HijriDatePickerMonthViewSettings.numberOfWeeksInView set with default value 6. [...]
read / write
forward VoidCallback?
Moves to the next view programmatically with animation by checking that the next view dates falls between the minimum and maximum date range. [...]
read / write
hashCode int
The hash code for this object. [...]
read-only, inherited
runtimeType Type
A representation of the runtime type of the object.
read-only, inherited
selectedDate HijriDateTime?
The selected date in the SfHijriDateRangePicker. [...]
read / write
selectedDates List<HijriDateTime>?
The list of dates selected in the SfHijriDateRangePicker. [...]
read / write
selectedRange HijriDateRange?
selected date range in the SfHijriDateRangePicker. [...]
read / write
selectedRanges List<HijriDateRange>?
List of selected ranges in the SfHijriDateRangePicker. [...]
read / write
view HijriDatePickerView?
The current visible HijriDatePickerView of SfHijriDateRangePicker.
read / write

Methods

addPropertyChangedListener(DateRangePickerValueChangedCallback listener) → void
Calls the listener every time the controller's property changed. [...]
inherited
debugFillProperties(DiagnosticPropertiesBuilder properties) → void
Add additional properties associated with the node. [...]
override
dispose() → void
Discards any resources used by the object. After this is called, the object is not in a usable state and should be discarded (calls to addListener and removeListener will throw after the object is disposed). [...]
@mustCallSuper, inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a non-existent method or property is accessed. [...]
inherited
notifyPropertyChangedListeners(String value) → void
Call all the registered listeners. [...]
inherited
removePropertyChangedListener(DateRangePickerValueChangedCallback listener) → void
remove the listener used for notify the data source changes. [...]
inherited
toDiagnosticsNode({String? name, DiagnosticsTreeStyle? style}) DiagnosticsNode
Returns a debug representation of the object that is used by debugging tools and by DiagnosticsNode.toStringDeep. [...]
inherited
toString({DiagnosticLevel minLevel = DiagnosticLevel.info}) String
A string representation of this object. [...]
inherited
toStringShort() String
A brief description of this object, usually just the runtimeType and the hashCode. [...]
inherited

Operators

operator ==(Object other) bool
The equality operator. [...]
inherited