MESCIUS SPREAD for Windows Forms 17.0J
視覚的な補助(GcDateTime型セル)

GcDateTime型セルでは様々な視覚的な補助機能を提供しています。

未入力時に表示する代替テキスト

AlternateText プロパティを使用すれば、セルが未入力(GcDateTimeCell.Value)のときや和暦表示できない日付が設定された場合に代わりに表示するテキストを文字列として設定することができます。

代替テキスト

AlternateTextプロパティは、DateAlternateText クラスのプロパティを使用して以下の代替テキストを設定できます。

プロパティ 代替テキストの内容
DisplayNull プロパティ セルが非編集状態で、未入力のときの代替テキスト
DisplayEmptyEra プロパティ セルが非編集状態で、その値が和暦表示できないときの代替テキスト
Null プロパティ セルが編集状態で、未入力のときの代替テキスト
EmptyEra プロパティ セルが編集状態で、その値が和暦表示できないときの代替テキスト

これらのプロパティはAlternateText クラスを参照し、次の2つを設定することができます。           

サンプルコード

次のサンプルコードは、代替テキストを設定する例です。

C#
コードのコピー
GrapeCity.Win.Spread.InputMan.CellType.GcDateTimeCellType gcDateTimeCell1 = new GrapeCity.Win.Spread.InputMan.CellType.GcDateTimeCellType();
// 非編集状態の代替テキスト
gcDateTimeCell1.AlternateText.DisplayNull.Text = "生年月日を入力してください";
gcDateTimeCell1.AlternateText.DisplayNull.ForeColor = System.Drawing.Color.LightSeaGreen;
gcDateTimeCell1.AlternateText.DisplayEmptyEra.Text = "和暦表示ができません";
gcDateTimeCell1.AlternateText.DisplayEmptyEra.ForeColor = System.Drawing.Color.Gray;
// 編集状態の代替テキスト
gcDateTimeCell1.AlternateText.Null.Text = "和暦で入力してください";
gcDateTimeCell1.AlternateText.Null.ForeColor = System.Drawing.Color.LightPink;
gcDateTimeCell1.AlternateText.EmptyEra.Text = "和暦表示ができません";
gcDateTimeCell1.AlternateText.EmptyEra.ForeColor = System.Drawing.Color.Red;
fpSpread1.ActiveSheet.Cells[1, 1].CellType = gcDateTimeCell1;
Visual Basic
コードのコピー
Dim gcDateTimeCell1 As New GrapeCity.Win.Spread.InputMan.CellType.GcDateTimeCellType()
' 非編集状態の代替テキスト
gcDateTimeCell1.AlternateText.DisplayNull.Text = "生年月日を入力してください"
gcDateTimeCell1.AlternateText.DisplayNull.ForeColor = System.Drawing.Color.LightSeaGreen
gcDateTimeCell1.AlternateText.DisplayEmptyEra.Text = "和暦表示ができません"
gcDateTimeCell1.AlternateText.DisplayEmptyEra.ForeColor = System.Drawing.Color.Gray
' 編集状態の代替テキスト
gcDateTimeCell1.AlternateText.Null.Text = "和暦で入力してください"
gcDateTimeCell1.AlternateText.Null.ForeColor = System.Drawing.Color.LightPink
gcDateTimeCell1.AlternateText.EmptyEra.Text = "和暦表示ができません"
gcDateTimeCell1.AlternateText.EmptyEra.ForeColor = System.Drawing.Color.Red
FpSpread1.ActiveSheet.Cells(1, 1).CellType = gcDateTimeCell1
入力候補値の表示

ShowRecommendedValue プロパティを使用すると、GcDateTime型セルで値が未入力のとき、入力候補となる値をグレー表示することができます。

入力候補として表示された日付の値は、表示された候補値のまま適用するか、フィールドの一部もしくは全ての値を変更して入力値として適用することができます。

入力候補として表示される値は、RecommendedValue プロパティで設定します。

候補として表示された値を確定するには、ショートカットキーとして定義されている[Ctrl]+[Enter]キーを押下します。

入力候補値を変更せずに値を確定

入力候補値から日付だけ変更して値を確定

フィールドごとの外観設定

GcDateTime型セルでは、フィールドごとに異なる外観を設定することが可能です。

非編集中のフィールごとの外観を有効にするにはPaintByControl プロパティをTrueに設定する必要があります。PaintByControlプロパティは非編集中の描画方法のみに影響します。編集はこのプロパティの設定に関わらず、外観の設定が有効になります。

※注意 PaintByControlプロパティをTrueに設定しフィールドごとの描画を有効にすると、フィールドごとに描画処理が必要になりレスポンスが低下します。

サンプルコード

次のサンプルコードは、以下の図のように、非編集中(表示時)のセルでフィールドごとの外観設定を有効にします。
フィールドごとの外観設定

C#
コードのコピー
GrapeCity.Win.Spread.InputMan.CellType.GcDateTimeCellType gdtcell = new GrapeCity.Win.Spread.InputMan.CellType.GcDateTimeCellType();
gdtcell.SideButtons[0].Visible = GrapeCity.Win.Spread.InputMan.CellType.ButtonVisibility.NotShown;
// 非編集状態の外観設定を有効にします
gdtcell.PaintByControl = true;
gdtcell.Fields.Clear();
gdtcell.Fields.AddRange("yyyy/MM/dd");
gdtcell.Fields[0].ForeColor = Color.Blue;
gdtcell.Fields[2].ForeColor = Color.Blue;
gdtcell.Fields[4].ForeColor = Color.Blue;
spread.ActiveSheet.Cells[0, 0].CellType = gdtcell;
Visual Basic
コードのコピー
Dim gdtcell = New GrapeCity.Win.Spread.InputMan.CellType.GcDateTimeCellType()
gdtcell.SideButtons(0).Visible = GrapeCity.Win.Spread.InputMan.CellType.ButtonVisibility.NotShown
' 非編集状態の外観設定を有効にします
gdtcell.PaintByControl = True
gdtcell.Fields.Clear()
gdtcell.Fields.AddRange("yyyy/MM/dd")
gdtcell.Fields(0).ForeColor = Color.Blue
gdtcell.Fields(2).ForeColor = Color.Blue
gdtcell.Fields(4).ForeColor = Color.Blue
参照

 

 


© MESCIUS inc. All rights reserved.