GrapeCity MultiRow for Windows Forms 11.0J
視覚的な補助

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

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

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


(図) 代替テキストを表示したGcTextBoxCell

 

AlternateTextプロパティは、TextBoxAlternateTextクラスを参照します。セルにフォーカスがあるときのテキストを設定するには、TextBoxAlternateTextクラスのNullプロパティを、セルにフォーカスがないときのテキストを設定するには、TextBoxAlternateTextクラスのDisplayNullプロパティを使用します。これらのプロパティはAlternateTextクラスを参照し、次の2つを設定することができます。

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

Imports GrapeCity.Win.MultiRow
Imports InputManCell = GrapeCity.Win.MultiRow.InputMan
                                                                
Dim GcTextBoxCell1 As New InputManCell.GcTextBoxCell()

GcTextBoxCell1.Name = "GcTextBoxCell1"
' フォーカスがないときの代替テキストを設定します。
GcTextBoxCell1.AlternateText.DisplayNull.Text = "氏名を入力してください。"
GcTextBoxCell1.AlternateText.DisplayNull.ForeColor = Color.Gray
' 入力中の代替テキストを設定します。
GcTextBoxCell1.AlternateText.Null.Text = "全角文字で入力してください。"
GcTextBoxCell1.AlternateText.Null.ForeColor = Color.Pink

GcMultiRow1.Template = Template.CreateGridTemplate(New Cell() {GcTextBoxCell1})
GcMultiRow1.RowCount = 3
using GrapeCity.Win.MultiRow;
using InputManCell = GrapeCity.Win.MultiRow.InputMan;
                                                                
InputManCell.GcTextBoxCell gcTextBoxCell1 = new InputManCell.GcTextBoxCell();

gcTextBoxCell1.Name = "gcTextBoxCell1";

// フォーカスがないときの代替テキストを設定します。
gcTextBoxCell1.AlternateText.DisplayNull.Text = "氏名を入力してください。";
gcTextBoxCell1.AlternateText.DisplayNull.ForeColor = Color.Gray;
// 入力中の代替テキストを設定します。
gcTextBoxCell1.AlternateText.Null.Text = "全角文字で入力してください。";
gcTextBoxCell1.AlternateText.Null.ForeColor = Color.Pink;

gcMultiRow1.Template = Template.CreateGridTemplate(new Cell[] { gcTextBoxCell1 });
gcMultiRow1.RowCount = 3;
                            
入力候補値の表示

ShowRecommendedValueプロパティを使用すると、GcTextBoxCell で値が未入力のとき、入力候補となる値をグレー表示することができます。入力候補として表示されたテキストの値は、表示された候補値のまま適用するか、全ての値を変更して入力値として適用することができます。入力候補として表示される値は、RecommendedValueプロパティで設定します。

  • GcTextBoxCell、GcCharMaskCell、GcNumberCell、GcComboBoxCell では候補値の一部の値だけを変更することはできません。
  • RecommendedValueプロパティは複数行テキストでは機能しません。


(図) 入力候補値を変更せずに値を確定
ハイライト表示
HighlightTextプロパティを使用すると、フォーカスを受け取ったときに、セルのすべてのテキストを選択状態にできます。
オーバーフローチップの表示
セルの編集時のみ有効です。GcTextBoxEditingControl.OverflowTipプロパティを使用します。
省略文字

Textプロパティに割り当てられた文字列がセルの幅に収まりきらないときに、すべての文字が表示されていないことを示す省略文字を表示することができます。省略文字を表示の有無やその表示位置は、Ellipsisプロパティで設定することができます。        

Ellipsisの値 説明
None 省略文字を表示しません。
EllipsisEnd セルの右側に省略文字を表示します。
EllipsisPath セルの中央に省略文字を表示します。

MultilineプロパティをTrueに設定して複数行表示した場合、省略文字はコントロールに表示されている最終行に表示されます。

省略文字は、既定値では3点リーダー(…)で表示されます。任意の文字に表示を変更する場合は、EllipsisStringプロパティを使用します。        

   
関連トピック

 

 


© 2008 GrapeCity inc. All rights reserved.