DesignTimeValueプロパティはセルの設計時だけに利用できる特別なプロパティで、実行時には利用できません。設計時と実行時の両方で同じ値を表示する場合は、Cell.Valueプロパティを使用します。
![](images/overview/DesignTimeValue.png)
チュートリアル
DesignTimeValueプロパティは主に文字列の幅を見積もるために使用するため、固定幅のフォントと共に使用することが推奨されます。次の手順は、固定幅フォントの指定とダミー文字列の指定方法を示します。
- デザイナを開く。
- ツールボックスから「TextBoxCell」を選択し、Rowセクションにドラッグする。
- プロパティウィンドウを使用してtextBoxCell1のFontプロパティを「MS ゴシック, 11ポイント」に設定する。
- プロパティウィンドウを使用してtextBoxCell1のMaxLengthプロパティを10に設定する。
- プロパティウィンドウを使用してtextBoxCell1のDesignTimeValueプロパティを「XXXXXXXXXX」に設定する。
- textBoxCell1に表示された文字列に基づいて、textBoxCell1の幅を変更する。
- ドキュメントウィンドウの「実行時」タブをクリックし、textBoxCell1の表示領域にちょうど10文字を入力できることを確認する。
DesignTimeValueプロパティのデータ型
DesignTimeValueプロパティの仕様は、そのセルのValueプロパティと同じです。たとえば、日付型セル(DateTimePickerCell)ではCell.ValueプロパティはDate型の値を保持するため、DesignTimeValueプロパティの型もDate型になります。
DesignTimeValueプロパティの値の格納場所
DesignTimeValueプロパティは、厳密にはセルのプロパティではなく、デザイナの設計情報です。DesignTimeValueプロパティの値はTemplate.resxファイルに格納され、Template.Designer.vb(またはTemplate.Designer.cs)には出力されません。
同様の情報に、セルのロックやテーブルを使用したテンプレート作成があります。
同様の情報に、セルのロックやテーブルを使用したテンプレート作成があります。