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

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

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

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

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

• ForeColor （テキストの前景色）
• Text （表示するテキスト）

サンプルコード

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

// セルが非編集状態のときの代替テキスト
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;

' セルが非編集状態のときの代替テキスト
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]キーを押下します。

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


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