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

GcTimeSpan型セルでは様々な視覚的な補助機能を提供しています。この章ではそれらの機能について解説します。

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

AlternateText プロパティを使用すれば、セルが未入力のときに代わりに表示するテキストを文字列として設定することができます。


(図) 代替テキストを表示したタイムスパンコントロール

AlternateText プロパティは、TimeSpanAlternateTextInfo オブジェクトを参照し、以下の代替テキストを設定できます。

プロパティ 代替テキストの内容
 DisplayNull セルが非編集状態で、未入力のときの代替テキスト
 DisplayZero セルが非編集状態で、値が0のときの代替テキスト
 Null セルが編集状態で、未入力のときの代替テキスト
 Zero セルが編集状態で、値が0のときの代替テキスト

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

サンプルコード

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

C#
コードのコピー
// セルが非編集状態のときの代替テキスト
gcTimeSpan1.AlternateText.DisplayNull.Text = "日数を入力してください";
gcTimeSpan1.AlternateText.DisplayNull.ForeColor = Color.Gray;
gcTimeSpan1.AlternateText.DisplayZero.Text = "0日は無効です";
gcTimeSpan1.AlternateText.DisplayZero.ForeColor = Color.Pink;
// セルが編集状態のときの代替テキスト
gcTimeSpan1.AlternateText.Null.Text = "実施期間を入力してください";
gcTimeSpan1.AlternateText.Null.ForeColor = Color.Red;
gcTimeSpan1.AlternateText.Zero.Text = "1日以上を入力してください";
gcTimeSpan1.AlternateText.Zero.ForeColor = Color.Red;
Visual Basic
コードのコピー
' セルが非編集状態のときの代替テキスト
gcTimeSpan1.AlternateText.DisplayNull.Text = "日数を入力してください"
gcTimeSpan1.AlternateText.DisplayNull.ForeColor = Color.Gray
gcTimeSpan1.AlternateText.DisplayZero.Text = "0日は無効です"
gcTimeSpan1.AlternateText.DisplayZero.ForeColor = Color.Pink
' セルが編集状態のときの代替テキスト
gcTimeSpan1.AlternateText.Null.Text = "実施期間を入力してください"
gcTimeSpan1.AlternateText.Null.ForeColor = Color.Red
gcTimeSpan1.AlternateText.Zero.Text = "1日以上を入力してください"
gcTimeSpan1.AlternateText.Zero.ForeColor = Color.Red
入力候補値の表示

ShowRecommendedValue プロパティを使用すると、GcTimeSpan型セルで値が未入力のとき、入力候補となる値をグレー表示することができます。
入力候補として表示された値は、表示された候補値のまま適用するか、その一部もしくは全ての値を変更して入力値として適用することができます。
入力候補として表示される値は、RecommendedValue プロパティで設定します。

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


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


(図) 入力候補値から値の一部を変更して値を確定

参照

 

 


© MESCIUS inc. All rights reserved.