Generally, you can use the following functions to specify non-working parts in the chart:
- The NonworkingDays property specifies the days being marked as nonworking in a week. Use the AddNonworkingDate method to add custom dates as being nonworking days. Use the NonworkingDaysPattern property to specify the pattern being used to fill non-working days. The NonworkingDaysColor property specifies the color being used to fill the non-working days. Use the ClearNonworkingDates method to remove all nonworking dates. Use the IsDateVisible property to specify whether a date fits the chart's area.
- The NonworkingHours property indicates the non-working hours with in a day. The non-working hours are shown using the NonworkingHoursPattern and the NonworkingHoursColor which defines the pattern and the color, when the base level of the chart displays hours, if the ShowNonworkingUnits property is True ( by default ).
- The ItemNonworkingUnits property specifies different non-working zones for different items. If the Item parameter indicates a valid handle, the IsNonworkingDate property queries the non-working expression for the item if the giving Date parameter is being non-working or working unit.
Generally, you can use the following attributes for a bar ( ItemBar property ) to work with non-working part of the bars:
- exBarWorkingCount attribute specifies the working count in days for the giving bar. For instance, if the exBarWorkingCount is 1 indicates a full day, or 24 working hours, while if it is 1/24 it indicates one working hour.
- exBarNonWorkingCount attributes specifies the working count in days for the giving bar. For instance, if the exBarNonWorkingCount is 1 indicates a full day, or 24 non-working hours, while if it is 1/24 it indicates one non-working hour.
- exBarWorkingUnits attribute retrieves a safe array of pair (start-end) that indicates the working parts of the bar. You can use the exBarWorkingUnitsAsString attribute to display the working parts of the bar as a string. The /NET assembly provides the public virtual DateTime[] get_BarWorkingUnits(int Item, object Key) method that returns the array of 2 DateTime objects that specifies the working parts of the bar.
- exBarWorkingUnitsAsString attribute retrieves the working part of the bar as a string, in other words it is similar with the exBarWorkingUnits excepts that it returns a string that shows the working parts of the bar.
- exBarNonWorkingUnits attribute retrieves a safe array of pair (start-end) that indicates the non-working parts of the bar. You can use the exBarNonWorkingUnitsAsString attribute to display the non-working parts of the bar as a string. The /NET assembly provides the public virtual DateTime[] get_BarNonWorkingUnits(int Item, object Key) method that returns the array of 2 DateTime objects that specifies the working parts of the bar.
- exBarNonWorkingUnitsAsString attribute retrieves the non-working part of the bar as a string, in other words it is similar with the exBarNonWorkingUnits excepts that it returns a string that shows the non-working parts of the bar.
The following screen shots shows the chart based on the value for the properties:
- ShowNonworkingDates property indicates whether the non-working ( weekend ) days are shown or hidden
- ShowNonworkingUnits property indicates whether the charts lists the non-working units, hours or days
- UnitWidthNonworking property specifies the width for non-working units, hours or days
Use the AdjustLevelsToBase property to align the levels to base level. The chart's NonworkingDays property is 65 ( indicates that saturday and sunday are non-working days ) while the NonworkingHours property is 16761855 ( indicates working hour from 10AM to 2 PM ).
- ShowNonworkingDates = True, UnitWidthNonworking = 0, ShowNonworkingUnits = True ( by default )
- ShowNonworkingDates = False, UnitWidthNonworking = 0, ShowNonworkingUnits = True
- ShowNonworkingDates = True, UnitWidthNonworking = 2, ShowNonworkingUnits = True
- ShowNonworkingDates = True, UnitWidthNonworking = -18, ShowNonworkingUnits = True
- ShowNonworkingDates = False, UnitWidthNonworking = 2, ShowNonworkingUnits = True
- ShowNonworkingDates = False, UnitWidthNonworking = -18, ShowNonworkingUnits = True
- ShowNonworkingDates = True, UnitWidthNonworking = 0, ShowNonworkingUnits = False
- ShowNonworkingDates = True, UnitWidthNonworking = 2, ShowNonworkingUnits = False
- ShowNonworkingDates = True, UnitWidthNonworking = -18, ShowNonworkingUnits = False
- ShowNonworkingDates = False, UnitWidthNonworking = 0, ShowNonworkingUnits = False
