CustomFieldMappingCollectionBase<T>.Add(CustomFieldMappingBase<T>) Method
Adds the specified object to the current collection.
Namespace: DevExpress.XtraScheduler
Assembly: DevExpress.XtraScheduler.v24.1.Core.dll
NuGet Package: DevExpress.Scheduler.Core
Declaration
Parameters
Name | Type | Description |
---|---|---|
mapping | CustomFieldMappingBase<T> | A DevExpress.XtraScheduler.CustomFieldMappingBase object to append to the collection. |
Returns
Type | Description |
---|---|
Int32 | An integer value indicating the position of the element. |
Remarks
This method adds an object to the collection if it doesn’t already exist in the collection; otherwise, it returns the index of the element in the collection.
The code sample below illustrates how to create an appointment with a custom field and use this field in the SchedulerDataStorage.FilterAppointment event to hide appointments which meet certain criteria.
To define a custom field, create a new custom field mapping and add it to the collection of custom mappings using the CustomFieldMappingCollectionBase<T>.Add
method. If the Scheduler is not bound to a data source, specify any non-empty string as the data field name.
Create an appointment using the SchedulerDataStorage.CreateAppointment method (so the newly created custom field mappings will be preserved for a new appointment). Set the value for the custom field and add the appointment to the SchedulerDataStorage.Appointments collection.
In the SchedulerDataStorage.FilterAppointment event handler, check the value of the custom field to set e.Cancel to true and hide this appointment.
scheduler.Storage.Appointments.Clear();
// Handle the FilterAppointment event to display appointments by some criteria.
scheduler.Storage.FilterAppointment += Storage_FilterAppointment;
scheduler.DayView.TopRowTime = TimeSpan.FromHours(DateTime.Now.Hour);
// Add mapping to create a custom field.
// If Scheduler is bound to data, the string "DataFieldOne" should match the field name in the data source.
// For unbound Scheduler, the data field name is required but not used.
scheduler.Storage.Appointments.CustomFieldMappings.Add(new
AppointmentCustomFieldMapping("PropertyOne", "DataFieldOne"));
Appointment apt1 = scheduler.Storage.CreateAppointment(AppointmentType.Normal,
DateTime.Now, new TimeSpan(1, 0, 0), "Visible Appointment");
apt1.CustomFields["PropertyOne"] = "Visible";
scheduler.Storage.Appointments.Add(apt1);
Appointment apt2 = scheduler.Storage.CreateAppointment(AppointmentType.Normal,
DateTime.Now.AddHours(2), new TimeSpan(0, 30, 0), "Hidden Appointment");
apt2.CustomFields["PropertyOne"] = "Hidden";
scheduler.Storage.Appointments.Add(apt2);
static void Storage_FilterAppointment(object sender, PersistentObjectCancelEventArgs e) {
e.Cancel = ((Appointment)e.Object).CustomFields["PropertyOne"].ToString() == "Hidden";
}