GcTextBoxコントロールについて
GcTextBoxコントロールは、次のようなVisual Studio標準のテキストボックスにはない高度な機能を提供します。
- 特定の文字種だけ入力を受け付ける文字種限定入力
- 入力可能な文字種へ自動変換するオートコンバート機能
- 透かし文字表示
- 入力候補値の表示
- 複数行入力時の罫線表示
- オーバーフロー文字の表示
- 省略文字表示
文字種の設定
GcTextBoxコントロールは、文字種を設定することで入力できる文字の種類を制限できます。
文字種の制限をかけると、指定した文字種以外でデータが入力されると受け付けないか、自動変換が可能であれば指定した文字種に変換されます。たとえば、数値しか受け付けないように設定したとき、文字が入力されてもGcTextBoxコントロールは受け付けません。
また、全角カナに文字種を設定したGcTextBoxコントロールに、ひらがなを入力すると自動的にカタカナに変換されます。
設定可能な文字種は表のとおりで、プロパティウィンドウのリストを使って、Formatプロパティに全角または半角の記号で文字種を設定します。
| 全角 | 半角 | 説明 |
| Ａ | A | 大文字のアルファベット（A～Z） |
| ａ | a | 小文字のアルファベット（a～z） |
| Ｋ | K | カタカナ（促音・拗音の小書き表記あり） |
| Ｎ | N | カタカナ（促音・拗音の小書き表記なし） |
| ９ | 9 | 数字（0～9） |
| ＃ | # | 数字および数字関連記号（0～9、+ - $ % \ , .） |
| ＠ | @ | 記号（! " # $ % & ' ( ) - = ^ ~ \ | @ ` [ { ; + : * ] } , < . > / ? _） |
| Ｂ | B | 2進数（0または1） |
| Ｘ | X | 16進数（0～9、A～F） |
| Ｊ | - | ひらがな（促音・拗音の小書き表記あり） |
| Ｇ | - | ひらがな（促音・拗音の小書き表記なし） |
| Ｚ | - | すべての全角文字 |
| Ｔ | - | サロゲート ペア文字 |
| Ｓ | S | 空白文字 |
| - | H | すべての半角文字 |
| - | ^ | 指定した文字種に含まれないすべての文字 |
| - | \ | エスケープシーケンス |
未入力時に表示する透かし表示テキスト
コントロールにフォーカスがあるとき、およびコントロールにフォーカスがないときに、コントロールに透かし表示テキストを設定できます。
使用するプロパティはWatermarkNullおよびWatermarkDisplayNullで、それぞれ表示したい文字列を設定します。
また、WatermarkNullForegroundプロパティおよびWatermarkDisplayNullForegroundプロパティを使用することにより、それぞれのテキストを表示する際の文字色を指定できます。
入力候補値の表示
テキストコントロールで値が未入力のとき、入力候補となる値をあらかじめグレー表示できます。入力候補として表示されたテキストの値は、表示された候補値のまま入力値として適用できます。
入力候補値を表示するには、ShowRecommendedValueプロパティを使用し、表示される値はRecommendedValueプロパティで設定します。
省略文字
入力された文字列が、GcTextBoxコントロールの幅に収まりきらないときに、すべての文字が表示されていないことを示す省略文字を表示できます。省略文字の表示の有無やその表示位置は、Ellipsisプロパティで設定できます。
この機能を使えば、長文入力を受け付ける場合でもGcTextBoxコントロールの幅を広くとる必要がありません。
オーバーフローチップの表示
入力された文字列が、GcTextBoxコントロールの幅に収まりきらないときに、コントロールの上にマウスカーソルが置かれたときにオーバーフローチップを表示できます。
オーバーフローチップを表示するには、ShowOverflowTipプロパティを「True」に設定します。
省略文字と組み合わせて使うと効果が大きいです。
