PowerTools SPREAD for Windows Forms 10.0J > 開発者ガイド > セル型 > InputManセル > GcMask型セル > 視覚的な補助(GcMask型セル) |
GcMask型セルでは様々な視覚的な補助機能を提供しています。
AlternateText プロパティを使用すれば、セルが未入力のときに代わりに表示するテキストを文字列として設定することができます。
(図) 下:代替テキストを表示したマスクコントロール
AlternateText プロパティは、MaskAlternateTextInfo オブジェクトを参照します。 セルが編集状態のときのテキストを設定するには、MaskAlternateText クラスのNull プロパティを、セルが非編集状態のときのテキストを設定するには、DisplayNull プロパティを使用します。これらのプロパティはAlternateTextInfo クラスを参照し、次の2つを設定することができます。
次のサンプルコードは、代替テキストを設定する例です。
C# |
コードのコピー
|
---|---|
GrapeCity.Win.Spread.InputMan.CellType.GcMaskCellType gcMask1 = new GrapeCity.Win.Spread.InputMan.CellType.GcMaskCellType(); // フォーカスがないときの代替テキストを設定します。 gcMask1.AlternateText.DisplayNull.Text = "電話番号を入力してください。"; gcMask1.AlternateText.DisplayNull.ForeColor = Color.Gray; // 入力中の代替テキストを設定します。 gcMask1.AlternateText.Null.Text = "市外局番から入力してください。"; gcMask1.AlternateText.Null.ForeColor = Color.Pink; fpSpread1.ActiveSheet.Cells[0, 0].CellType = gcMask1; |
Visual Basic |
コードのコピー
|
---|---|
Dim gcMask1 As New GrapeCity.Win.Spread.InputMan.CellType.GcMaskCellType() ' フォーカスがないときの代替テキストを設定します。 gcMask1.AlternateText.DisplayNull.Text = "電話番号を入力してください。" gcMask1.AlternateText.DisplayNull.ForeColor = Color.Gray ' 入力中の代替テキストを設定します。 gcMask1.AlternateText.Null.Text = "市外局番から入力してください。" gcMask1.AlternateText.Null.ForeColor = Color.Pink FpSpread1.ActiveSheet.Cells(0, 0).CellType = gcMask1 |
ShowRecommendedValue プロパティを使用すると、セルの値が未入力のとき、入力候補となる値をグレー表示することができます。
入力候補として表示されたセルの値は、表示された候補値のまま適用するか、その一部もしくは全ての値を変更して入力値として適用することができます。
入力候補として表示される値は、RecommendedValue プロパティで設定します。
候補として表示された値を確定するには、[Ctrl]+[Enter]キーを押下します。
(図) 入力候補値を変更せずに値を確定
(図) 入力候補値から値の一部を変更して値を確定