'宣言 Public Property IsWorkDay As Infragistics.Win.DefaultableBoolean
public Infragistics.Win.DefaultableBoolean IsWorkDay {get; set;}
IsWorkDay プロパティが 'Default' 以外の値に明示的に設定される場合、設定は DayOfWeek オブジェクトの IsWorkDay プロパティの値に優先されます。
IsWorkDay プロパティが明示的に 'False' に設定される場合、WorkingHours コレクションのコンテンツは使用できません。すなわち、すべての日が不稼働時間であるとみなされます。
IsWorkday プロパティは、複数のクラスによって公開されるため、稼働日をさまざまなレベルに定義することが可能です。つまり、特定の日、曜日、または定期的な日付パターンなどに基づきます。以下のテーブルは、IsWorkDayプロパティのプロパティ解決プロセスでの優先順位の詳細を表します。
| 優先順序 | 解決された値 |
|---|---|
| 1) OwnerDateSettings | Owner の DateSettings コレクションが解決する日のエントリーを含む場合は、そのエントリーが評価されます。評価されない場合、解決プロセスは次のレベルへ続行します。IsWorkDay が明示的に設定される場合、値はプロパティの解決階層の他のレベルすべてに優先されます。対応する日付に表示される TimeSlot は、プロパティが False に設定されている場合、非稼働日時間の外観を示します。または、プロパティが True に設定されていて、TimeSlot が稼働時間内である場合の稼働時間の外観を示します。 |
| 2) CalendarDateSettings | CalendarInfo の DateSettings コレクションが解決する日のエントリーを含む場合は、そのエントリーが評価されます。評価されない場合、解決プロセスは次のレベルへ続行します。IsWorkDay が明示的に設定された場合、値はプロパティの解決階層の残りのすべてのレベルに優先されます。対応する日付に表示される TimeSlot は、プロパティが False に設定されている場合、非稼働日時間の外観を示します。または、プロパティが True に設定されていて、TimeSlot が稼働時間内である場合の稼働時間の外観を示します。このレベルはオーナーに固有に適用されることに注意してください。つまり、オーナー固有の項目をに表示しないコントロールでは、選択した日付の稼動時間を定義するために UltraCalendarInfo の DateSettings コレクションを使用できます。 |
| 3) OwnerRecurringDateSettings |
Owner の RecurringDateSettings コレクションが 1 つ以上のメンバーを含む場合、各メンバーは、Recurrence プロパティで定義された定期的なパターンと一致する日付が解決されるかどうかを決定するために検証されます。評価されない場合、解決プロセスは次のレベルへ続行します。IsWorkDay が明示的に設定される場合、値はプロパティの解決階層の残りのすべてのレベルに優先されます。出来事のある日付に表示される TimeSlot は、プロパティが False に設定されている場合、非稼働日時間の外観を示します。または、プロパティが True に設定されていて、TimeSlot が稼働時間内である場合の稼働時間の外観を示します。
注: 複数の繰り返しが同じ日付の出来事を生成する場合は、コレクションの最初に一番近いインスタンスに指定された日付に優先します。このため、稼働日を定義するのに複数の繰り返しを使用する場合は、最低頻度の出来事を生成する定期的なアイテムをコレクションの開始の一番近くに配置する必要があります。下記の例は 2 つの定期的なイベントのシナリオです。1 つ (月単位) は、「毎月、最初の月曜日」に発生し、IsWorkDay プロパティは False に設定されています。もう 1 つの定期的なアイテム (日単位) は、「全ての平日」に発生し、IsWorkDay プロパティが True に設定されています。月単位の定期的なアイテムは、コレクションの開始に挿入をする必要があります。日単位の定期的なアイテムはその後に挿入します。そうしない場合、月の最初の月曜日は非単位の定期的アイテムに解決されます (月の最初の月曜日は平日であるため)。IsWorkDay は False に解決される意図でしたが、True に解決されます。 |
| 4) DayOfWeekSettings | 解決される日付に対応する DayOfWeekSettings コレクションのメンバーが参照されます。IsWorkDay プロパティが明示的に設定された場合は、この値はプロパティの解決階層の残りレベルに優先します。プロパティが False に設定された場合、対応する曜日に表示される TimeSlot は非稼働時間の外観を表示します。またはプロパティが True に設定された場合、TimeSlot が稼働時間内になるよう決定された場合、稼働時間の外観を表示します。 |
| 5) DayOfWeek (UltraCalendarInfo) | プロパティの解決階層の最終レベルです。解決チェインに特定の設定があるプレーヤーが他にいない場合は、この値が最終決定を下します。デフォルトでは、土曜日および日曜日以外はすべて稼働日です。この設定はすべてのオーナーに適用されます。プロパティが False に設定された場合、対応する曜日に表示される TimeSlot は非稼働時間の外観を表示します。またはプロパティが True に設定された場合、TimeSlot が稼働時間内になるよう決定された場合、稼働時間の外観を表示します。 |