GcCalendarコントロールに休日を設定する方法

文書番号 : 27055     文書種別 : 使用方法     最終更新日 : 2009/06/18
文書を印刷する
対象製品
PlusPak for Windows Forms 5.0J
詳細
GcCalendarコントロールに休日の設定を行うには、プロパティページから設定する方法、コードで設定する方法、xmlファイルで設定する方法があります。

以下は、毎年10/1を創立記念日として休日表示するサンプルコードです。
【プロパティページから設定する方法】
================================================================
・GcCalendarを右クリック、「プロパティ」を選択します。
・表示される画面で、「休日設定」タブを選択します。
・「カレンダーに表示する休日スタイルを選択」の追加ボタンを押下し、左のチェックボックスを選択します。
・「休日スタイル」タブの名前とキーに「創立記念日」、文字色を「Red」、背景色を「HotPink」、太字にチェックをします。
・「休日の追加」タブの追加ボタンを押下し、タイプを「Holiday」、StartDateとEndDateに10/1を、Nameに「創立記念日」を設定します。
・OKボタンを押下し、画面を閉じます。
================================================================

【コードで設定する方法】
コードからキャプションのテキストを設定するには、SetCaptionTextメソッドを使って次のように記述します。
[VB]
  ' 休日スタイルを生成します。
  Dim aHS As New GrapeCity.Win.Calendar.HolidayStyle
  aHS.Name = "創立記念日"
  aHS.SubStyle = New GrapeCity.Win.Calendar.SubStyle(Color.HotPink, Color.Red, True, False)
  aHS.Holidays.Add(New GrapeCity.Win.Calendar.Holiday("創立記念日", 10, 1))

  ' コレクションに登録します。
  GcCalendar1.HolidayStyles.Add("創立記念日", aHS)

  ' カレンダーに反映させます。
  GcCalendar1.ActiveHolidayStyles = New String() {"創立記念日"}

[C#]
  // 休日スタイルを生成します。
  GrapeCity.Win.Calendar.HolidayStyle aHS = new GrapeCity.Win.Calendar.HolidayStyle();
  aHS.Name = "創立記念日";
  aHS.SubStyle = new GrapeCity.Win.Calendar.SubStyle(Color.HotPink, Color.Red, true, false);
  aHS.Holidays.Add(new GrapeCity.Win.Calendar.Holiday("創立記念日", 10, 1));

  // コレクションに登録します。
  gcCalendar1.HolidayStyles.Add("創立記念日", aHS);

  // カレンダーに反映させます。
  gcCalendar1.ActiveHolidayStyles = new string[] { "創立記念日" };

【xmlファイルで設定する方法】
サンプルのようなレイアウトのxmlファイルを作成し、以下の手順でxmlファイルを開きます。なお、プロパティページから設定した休日の内容は、保存ボタンを押下することでxmlファイルに保存されます。
================================================================
◇サンプル
<?xml version="1.0" encoding="utf-16"?>
 <HolidaySetting><Holidays Key="創立記念日" Name="創立記念日" ForeColor="Red" BackColor="HotPink" Bold="True" UnderLine="False"><HolidayPolicy><Sunday WeekFlags="None" Override="None" /><Monday WeekFlags="None" Override="None" /><Tuesday WeekFlags="None" Override="None" /><Wednesday WeekFlags="None" Override="None" /><Thursday WeekFlags="None" Override="None" /><Friday WeekFlags="None" Override="None" /><Saturday WeekFlags="None" Override="None" /></HolidayPolicy>
 <Holiday Name="創立記念日" StartDate="2008-10-01T00:00:00" EndDate="2008-10-01T00:00:00" />
 </Holidays>
</HolidaySetting>
--------------------------------------------------
・GcCalendarを右クリック、「プロパティ」を選択します。
・表示される画面で、「休日設定」タブを選択します。
・「カレンダーに表示する休日スタイルを選択」の開くボタンを押下し、xmlファイルを指定します。
・表示された休日「創立記念日」にチェックを付けます。
================================================================

◎上記のxmlのサンプルをコピーして使用した場合、文字コードの関係で読み込みエラーとなります。実際に使用するサンプルファイルはこちらからダウンロードしてください。

◎出力されたxmlファイルは、改行のない1行のレイアウトとなります。改行を使用しレイアウトを整えたxmlファイルを開くことは可能ですが、再度保存した場合には改行が削除され、1行となります。

この文書は、以前は次のFAQ IDで公開されていました : 11786