ig.scheduler.AppointmentPropertyMapping
Remarks
The ScheduleListDataSource class provides the ability to specify an item source from which data objects which represent appointments can be obtained.
In cases where the name or data type of the data object property does not match the name or data type of the corresponding appointment property, a mapping can be used to resolve the name and/or type.
In cases where the name or data type of the data object property does not match the name or data type of the corresponding appointment property, a mapping can be used to resolve the name and/or type.
For example, assume there exists a data object property named 'StartDate', which is the property from which the appointment's Start property value is obtained.
To create a mapping between these two properties, a new AppointmentPropertyMapping object is created with a Property value of Start, and a DataObjectPropertyName of 'StartDate', i.e., the actual name of the data object property.
This AppointmentPropertyMapping object is then added to the ScheduleListDataSource's AppointmentPropertyMappings collection; this signifies to the data source that the value the Appointment's Start property is to be obtained/assigned from/to a property named 'StartDate' on the data object.
A property mapping can also be used to perform bi-directional conversions between an appointment property and the corresponding data object property using the ConvertCallback AND ConvertBackCallback properties. These properties accept a delegate which is invoked whenever data is transferred between the appointment and it's underlying data object, providing the ability to change the value.
Dependencies
-
ig.scheduler.AppointmentPropertyMapping
Constructor- new $.ig.scheduler.AppointmentPropertyMapping( );
Creates a new instance.
-
convertBackCallback
Inherited- .convertBackCallback( );
Reference to a delegate which is invoked before the value of a schedule object property is assigned 'back' to the underlying data object's corresponding property, providing an opportunity to convert the value to the type expected by that property.
Remarks
To bypass conversion, return the same value that was passed into this method. If null is returned, a value of null will be assigned to the underlying data object property, which will cause an exception to be thrown if null is not a valid value for that property.
-
convertBackCallback
Inherited- .convertBackCallback( value:function );
Reference to a delegate which is invoked before the value of a schedule object property is assigned 'back' to the underlying data object's corresponding property, providing an opportunity to convert the value to the type expected by that property.
- value
- Type:function
Remarks
To bypass conversion, return the same value that was passed into this method. If null is returned, a value of null will be assigned to the underlying data object property, which will cause an exception to be thrown if null is not a valid value for that property.
-
convertCallback
Inherited- .convertCallback( );
Reference to a delegate which is invoked before a value is assigned to a schedule object property, providing an opportunity to convert the value.
Remarks
To bypass conversion, return the same value that was passed into this method. If null is returned, a value of null will be assigned to the schedule object property, which will cause an exception to be thrown if null is not a valid value for that property.
-
convertCallback
Inherited- .convertCallback( value:function );
Reference to a delegate which is invoked before a value is assigned to a schedule object property, providing an opportunity to convert the value.
- value
- Type:function
Remarks
To bypass conversion, return the same value that was passed into this method. If null is returned, a value of null will be assigned to the schedule object property, which will cause an exception to be thrown if null is not a valid value for that property.
-
dataObjectPropertyName
Inherited- .dataObjectPropertyName( );
Gets the name of the property of the underlying data object with which this instance is associated.
-
dataObjectPropertyName
Inherited- .dataObjectPropertyName( value:string );
Sets the name of the property of the underlying data object with which this instance is associated.
- value
- Type:string
-
onPropertyChanged
Inherited- .onPropertyChanged( propertyName:string );
Raises the PropertyChanged event.
- propertyName
- Type:string
-
property
- .property( );
- Return Type:
- ig.scheduler.AppointmentProperty
- Return Type Description:
- Returns a AppointmentProperty.
Identifies the property on the Appointment object.
See Also
-
property
- .property( value:ig.scheduler.AppointmentProperty );
- Return Type:
- ig.scheduler.AppointmentProperty
- Return Type Description:
- Returns a AppointmentProperty.
Identifies the property on the Appointment object.
- value
- Type:ig.scheduler.AppointmentProperty
See Also
-
toString
Inherited- .toString( );
Returns the string representation of this object.
-
verifyProperty
- .verifyProperty( propertyValue:number );
Throws an exception if a mapping is created for the RecurrenceRoot or Resource properties.
- propertyValue
- Type:number
- The integer equivalent of an AppointmentProperty constant.