| GrapeCity.Win.CalendarGrid.v20 アセンブリ > GrapeCity.Win.CalendarGrid 名前空間 : GcCalendarGrid クラス |
Public Class GcCalendarGrid Inherits GrapeCity.Framework.Forms.ControlBase
public class GcCalendarGrid : GrapeCity.Framework.Forms.ControlBase
GcCalendarGrid は、データが日別に整理されるカレンダーコントロールです。それぞれの日では、その日に関連するデータを表現できます。すなわち、カレンダーの日付だけでなく、その日の重要なビジネスデータも GcCalendarGrid に表すことができます。
1 日ごとに、それぞれの日のビジネスデータによって CalendarTemplate を設計できます。CalendarTemplate はグリッド状のレイアウトになっており、個々の要件に従って複数の行または列を定義できます。設計した CalendarTemplate を Template プロパティに設定すると、GcCalendarGrid のビュー全体にそのテンプレートが適用されます。
GcCalendarGrid には、すべての日付を異なるレイアウトで表示できるように、複数のビューが用意されています。CalendarView プロパティに異なる値を設定することで、ビューを変更できます。CalendarMonthView、CalendarWeekView、CalendarMonthMultiColumnView、CalendarListView などの CalendarView が使用可能で、ビジネス要件に応じてその中から 1 つを選択できます。
GcCalendarGrid の基本データ単位は CalendarCell です。これは 1 つのセルに対応し、1 日のデータを表示できます。たとえば、ある特定の日に営業収入と支出を表示する場合は、収入用に 1 つ、支出用に 1 つの計 2 つの CalendarCell を CalendarTemplate に配置します。CalendarCell ごとに CalendarCell.CellType プロパティを設定し、CalendarCell に異なるデータ型を表示できます。たとえば、CalendarCell.CellType プロパティに CalendarImageCellType を設定して、その特定の日にイメージを表示できます。
GcCalendarGrid コントロールを使用してデータを表示する際、基になるデータソースを使用できます。そのためには、DataColumn の 1 つとして日付軸が設定されたデータソースを定義し、日付軸に基づいてデータソースのデータを作成してから、データソースを DataSource または DataMember プロパティに設定します。最も重要なことは、日付軸（DataColumn）の名前を GcCalendarGrid.DateField プロパティに設定することです。これにより、GcCalendarGrid はデータソースからどの日付のデータを取得すればよいかがわかります。さらに、データソースの DataColumn の名前を CalendarCell.DataField プロパティに設定することで、それぞれの日のデータがデータソースからセルに取得されます。
大量のデータを操作する場合は、GcCalendarGrid の VirtualMode プロパティを true に設定してデータの一部のみを表示し、関連する CellValueNeeded イベントと CellValuePushed イベントに独自のプログラムロジックを記述できます。
Commands プロパティからすべてのコマンドにアクセスできます。各コマンドでは、ICalendarGridAction を実行するためのジェスチャーを定義できます。
GcCalendarGrid コントロールには、CalendarCell に異なる外観を与える CalendarCellStyle が用意されています。また、CalendarNamedCellStyle を GcCalendarGrid.Styles に追加/削除することにより、名前によって参照される CalendarNamedCellStyle を事前定義できます。
GcCalendarGrid では、独自のポリシーに従って休日をカスタマイズできます。Holidays プロパティを使用してください。
［Ctrl］キーを押しながらマウスホイールを回すことで、GcCalendarGrid の内容をズームできます。また、ZoomFactor プロパティを使用してズーム倍率を設定することもできます。
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
GrapeCity.Framework.Forms.FrameworkControl
GrapeCity.Framework.Views.Windows.ElementContainerControl
GrapeCity.Framework.Forms.ControlBase
GrapeCity.Win.CalendarGrid.GcCalendarGrid