ラベル型セル(LabelCell)は、.NET FrameworkのLabelコントロール(System.Windows.Forms.Label)と同等の機能を提供します。LabelCellを使用すると、ユーザーが編集不可能なテキストを表示できます。
機能
データ型
LabelCellはObject型の値を保持します。この型はLabelCell.ValueTypeプロパティで確認できます。
ラベルのキャプションの表示は、String型にキャストした値が使用されます。この型はLabelCell.FormattedValueTypeプロパティで確認できます。Object型のToStringメソッドをオーバーライドすると、キャストする際の動作を変更できます。セルに値が読み出される場合の動作を変更するには、LabelCell.OnCellFormattingメソッドをオーバーライドします。セルから値が書き戻される場合の動作を変更するには、LabelCell.OnCellParsingメソッドをオーバーライドします。
ラベルのキャプションの表示は、String型にキャストした値が使用されます。この型はLabelCell.FormattedValueTypeプロパティで確認できます。Object型のToStringメソッドをオーバーライドすると、キャストする際の動作を変更できます。セルに値が読み出される場合の動作を変更するには、LabelCell.OnCellFormattingメソッドをオーバーライドします。セルから値が書き戻される場合の動作を変更するには、LabelCell.OnCellParsingメソッドをオーバーライドします。
セル編集コントロール
LabelCellのセル編集コントロールはありません。LabelCell.EditTypeプロパティは常にnull参照(Visual BasicではNothing)を返します。
スタイル
LabelCellはCellStyleクラスの次のメンバをサポートしています。セルのスタイルはLabelCell.Styleプロパティで設定します。
GDI+互換モードを有効にするには、UseCompatibleTextRenderingプロパティをTrueに設定します。
CellStyleメンバ | 有効/無効 |
---|---|
BackColor | 有効 |
Border | 有効 |
DataSourceNullValue | 有効 |
DisabledBackColor | 有効 |
DisabledForeColor | 有効 |
Font | 有効 |
ForeColor | 有効 |
Format | 有効 |
FormatProvider | 有効 |
GradientColors | 有効 |
GradientDirection | 有効 |
GradientStyle | 有効 |
Image | 有効 |
ImageAlign | 有効 |
ImeMode | - |
ImeSentenceMode | - |
InputScope | - |
LineAdjustment | GDI+互換モードの場合のみ有効 |
Margin | 有効 |
Multiline | 有効 |
NullValue | 有効 |
Padding | 有効 |
PatternColor | 有効 |
PatternStyle | 有効 |
SelectionBackColor | 有効 |
SelectionForeColor | 有効 |
Tag | 有効 |
TextAdjustment | GDI+互換モードの場合のみ有効 |
TextAlign | 有効 |
TextAngle | GDI+互換モードの場合のみ有効 |
TextEffect | 有効 |
TextImageRelation | 有効 |
TextIndent | 有効 |
TextVertical | GDI+互換モードの場合のみ有効 |
UseCompatibleTextRendering | 有効 |
WordWrap | 有効 |
GDI+互換モードを有効にするには、UseCompatibleTextRenderingプロパティをTrueに設定します。
ショートカットキー
LabelCellで処理されるショートカットキーはありません。
イベント
セルの内容領域のクリックに対応した処理を実装するには、GcMultiRow.CellContentClickイベントを使用します。ダブルクリックの場合はGcMultiRow.CellContentDoubleClickイベントです。
使用例