'Declaration Public Property IsWorkDay As Infragistics.Win.DefaultableBoolean
public Infragistics.Win.DefaultableBoolean IsWorkDay {get; set;}
When the IsWorkDay property is explicitly set to a value other than 'Default', that setting takes precedence over the value of the DayOfWeek object's IsWorkDay property.
When the IsWorkDay property is explicitly set to false, the contents of the WorkingHours collection is not applicable, i.e., the entire day is considered to consist of non-working hours.
Since the IsWorkday property is exposed by several different classes, it is possible to define workdays at various different levels, i.e., for a specific date, a day of the week, or based on a recurring date pattern. The following table details order of precedence in the property resolution process for the IsWorkDay property:
| Order of precedence | Resolved value |
|---|---|
| 1) OwnerDateSettings | If the Owner's DateSettings collection contains an entry for the date to be resolved, that entry is evaluated. If it does not, the resolution process proceeds to the next level. If IsWorkDay is explicitly set, that value takes precedence over all other levels of the property resolution hierarchy. A TimeSlot displayed for the corresponding date will exhibit the non-working hour appearance if the property is set to false, or the working hour appearance if the property is set to true and the TimeSlot is determined to fall within working hours. |
| 2) CalendarDateSettings | If the UltraCalendarInfo's DateSettings collection contains an entry for the date to be resolved, that entry is evaluated. If it does not, the resolution process proceeds to the next level. If IsWorkDay is explicitly set, that value takes precedence over remaining levels of the property resolution hierarchy. A TimeSlot displayed for the corresponding date will exhibit the non-working hour appearance if the property is set to false, or the working hour appearance if the property is set to true and the TimeSlot is determined to fall within working hours. Note that this level is applicable independently of the owner-specific ones, i.e., with control views that do not display owners separately, the UltraCalendarInfo's DateSettings collection can still be used to define working hours for any arbitrarily selected date. |
| 3) OwnerRecurringDateSettings |
If the Owner's RecurringDateSettings collection contains one or more members, each one is examined to determine whether the date to be resolved coincides with the recurrence pattern defined by the Recurrence property. If it does not, the resolution process proceeds to the next level. If IsWorkDay is explicitly set, that value takes precedence over the remaining levels of the property resolution hierarchy. A TimeSlot displayed for a date on which there is an occurrence will exhibit the non-working hour appearance if the property is set to false, or the working hour appearance if the property is set to true and the TimeSlot is determined to fall within working hours.
Note that in the case where more than one recurrence generates an occurrence for the same date, precedence for that date is given to the instance closest to the beginning of the collection. For this reason it is recommended that when using multiple recurrences to define workdays, the recurrence that generates occurrences at the lowest frequency should be positioned closest to the beginning of the collection. For example, consider two recurrences, one (monthly) that occurs on "the first Monday of each month" whose IsWorkDay property is set to false, and another (daily) that occurs "every weekday" whose IsWorkDay property is set to true. The one that occurs monthly should be inserted at the beginning of the collection, and the daily one after it, otherwise (since the first Monday of the month is also a weekday) the first Monday of the month will resolve through the daily recurrence, and IsWorkDay will resolve to true, where the intent was to resolve it to false. |
| 4) DayOfWeekSettings | The member of the DayOfWeekSettings collection which corresponds to the date to be resolved is referenced; if the IsWorkDay property is explicitly set, that value takes precedence over the remaining levels of the property resolution hierarchy. A TimeSlot displayed for the corresponding day of the week will exhibit the non-working hour appearance if the property is set to false, or the working hour appearance if the property is set to true and the TimeSlot is determined to fall within working hours. |
| 5) DayOfWeek (UltraCalendarInfo) | This is the final level of the property resolution hierarchy. If no other player in the resolution chain had a specific setting, this value makes the final determination. By default, all days except Saturday and Sunday are considered to be workdays. This setting applies to all owners. A TimeSlot displayed for the corresponding day of the week will exhibit the non-working hour appearance if the property is set to false, or the working hour appearance if the property is set to true and the TimeSlot is determined to fall within working hours. |
Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2