GcLabelCellは、PlusPakのGcLabelコントロールと同等の機能を提供します。GcLabelCellを使用すると、Visual Studio標準のラベルコントロールの機能の他に、文字の「均等割付」や「縦表示」の機能を使用できます。
機能
GcLabelCellでは、次の機能を使用できます。
- 文字の均等割付
- 文字のスタイル設定
- 文字の自動縮小、アーチ表示
- 省略文字の表示
- 背景スタイルの設定
各機能の詳細はGcLabelCellクラスのリファレンスを参照してください。
データ型
GcLabelCellはObject型の値を保持します。この型はGcLabelCell.ValueTypeプロパティで確認できます。
ラベルのキャプションの表示は、String型にキャストした値が使用されます。この型はGcLabelCell.FormattedValueTypeプロパティで確認できます。セルに値が読み出される場合の動作を変更するには、GcFontPickerCell.OnCellFormattingメソッドをオーバーライドします。セルから値が書き戻される場合の動作を変更するには、GcLabelCell.OnCellParsingメソッドをオーバーライドします。
ラベルのキャプションの表示は、String型にキャストした値が使用されます。この型はGcLabelCell.FormattedValueTypeプロパティで確認できます。セルに値が読み出される場合の動作を変更するには、GcFontPickerCell.OnCellFormattingメソッドをオーバーライドします。セルから値が書き戻される場合の動作を変更するには、GcLabelCell.OnCellParsingメソッドをオーバーライドします。
セル編集コントロール
GcLabelCellのセル編集コントロールはありません。GcLabelCell.EditTypeプロパティは常にnull参照(Visual BasicではNothing)を返します。
スタイル
GcLabelCellはCellStyleクラスの次のメンバをサポートしています。セルのスタイルはCell.Styleプロパティで設定します。
| CellStyle メンバ | 有効／無効 |
|---|---|
| BackColor | 有効 |
| BackgroundGradientEffect | 有効 |
| Border | 有効 |
| DataSourceNullValue | 有効 |
| DisabledBackColor | 有効 |
| DisabledForeColor | 有効 |
| DisabledGradientEffect | 有効 |
| EditingBackColor | - |
| EditingForeColor | - |
| Font | 有効 |
| ForeColor | 有効 |
| Format | 有効 |
| FormatProvider | 有効 |
| Image | 有効 |
| ImageAlign | 有効 |
| ImeMode | - |
| ImeSentenceMode | - |
| InputScope | - |
| LineAdjustment | GDI+互換モードの場合のみ有効 |
| Margin | 有効 |
| MouseOverBackColor | 有効 |
| MouseOverForeColor | 有効 |
| MouseOverGradientEffect | 有効 |
| Multiline | 有効 |
| NullValue | 有効 |
| Padding | 有効 |
| PatternColor | 有効 |
| PatternStyle | 有効 |
| SelectionBackColor | 有効 |
| SelectionForeColor | 有効 |
| SelectionGradientEffect | 有効 |
| Tag | 有効 |
| TextAdjustment | GDI+互換モードの場合のみ有効 |
| TextAlign | 有効 |
| TextAngle | GDI+互換モードの場合のみ有効 |
| TextEffect | 有効 |
| TextImageRelation | 有効 |
| TextIndent | 有効 |
| TextVertical | GDI+互換モードの場合のみ有効 |
| UseCompatibleTextRendering | 有効 |
| WordWrap | 有効 |
ショートカットキー
GcLabelCellで処理されるショートカットキーはありません。
イベント
セルの内容領域のクリックに対応した処理を実装するには、GcMultiRow.CellContentClickイベントを使用します。ダブルクリックの場合はGcMultiRow.CellContentDoubleClickイベントです。
PlusPakコントロールとの比較
次の表はGcLabelCellとPlusPakのGcLabelコントロールの主要なプロパティの比較です。
| GcLabelCell | GcLabel |
|---|---|
| AutoShrink | AutoShrink |
| CharSpacing | CharSpacing |
| CharWidthScale | CharWidthScale |
| DisableForeColor | DisableForeColor |
| EllipsisMode | EllipsisMode |
| FlatStyle | FlatStyle |
| GradientEffect | GradientEffect |
| Image | Image |
| ImageAlign | ImageAlign |
| なし | ImageIndex |
| なし | ImageKey |
| なし | ImageList |
| MinFontSize | MinFontSize |
| OutlineEffect | OutlineEffect |
| ContentPadding | Padding |
| PatternEffect | PatternEffect |
| ShadowEffect | ShadowEffect |
| ShrinkMode | ShrinkMode |
| TextArcMode | TextArcMode |
| TextDecorations | TextDecorations |
| TextEffect | TextEffect |
| TextHAlign | TextHAlign |
| TextOrientation | TextOrientation |
| TextVAlign | TextVAlign |
| UseMnemonic | UseMnemonic |
| VerticalFarEastSettings | VerticalFarEastSettings |
| WrapMode | WrapMode |
GcLabelCellの利用
参照