![](images/userguide/CellType_ProgressBarCell_01.png)
プログレスバー型セル(ProgressBarCell)は、.NET FrameworkのProgressBarコントロール(System.Windows.Forms.ProgressBar)と同等の機能を提供します。ProgressBarCellを使用すると、割合を視覚的に表示できます。
機能
ProgressBarCellでは、基本セルの機能に加えて、次の機能を使用できます。
各機能の詳細はProgressBarCellクラスのリファレンスを参照してください。
- 値の割合に応じた塗りつぶし
- 値のテキストの表示
各機能の詳細はProgressBarCellクラスのリファレンスを参照してください。
データ型
ProgressBarCellはObject型の値を保持します。この型はProgressBarCell.ValueTypeプロパティで確認できます。入力と表示には、Integer型にキャストした値が使用されます。この型はProgressBarCell.FormattedValueTypeプロパティで確認できます。セルに値が読み出される場合の動作を変更するには、ProgressBarCell.OnCellFormattingメソッドをオーバーライドします。セルから値が書き戻される場合の動作を変更するには、ProgressBarCell.OnCellParsingメソッドをオーバーライドします。
セル編集コントロール
ProgressBarCellのセル編集コントロールはありません。ProgressBarCell.EditTypeプロパティは常にnull参照(Visual BasicではNothing)を返します。
スタイル
ProgressBarCellはCellStyleクラスの次のメンバをサポートしています。セルのスタイルはProgressBarCell.Styleプロパティで設定します。
GDI+互換モードを有効にするには、ProgressBarCell.Style.UseCompatibleTextRenderingプロパティをTrueに設定します。
CellStyleメンバ | 有効/無効 |
---|---|
BackColor | ProgressBarCell.UseVisualProgressBarStyle=Falseの場合のみ有効 |
BackgroundGradientEffect | ProgressBarCell.UseVisualProgressBarStyle=Falseの場合のみ有効 |
Border | 有効 |
DataSourceNullValue | 有効 |
DisabledBackColor | ProgressBarCell.UseVisualProgressBarStyle=Falseの場合のみ有効 |
DisabledForeColor | 有効 |
DisabledGradientEffect | ProgressBarCell.UseVisualProgressBarStyle=Falseの場合のみ有効 |
EditingBackColor | - |
EditingForeColor | - |
Font | 有効 |
ForeColor | 有効 |
Format | 有効 |
FormatProvider | 有効 |
Image | 有効 |
ImageAlign | 有効 |
ImeMode | - |
ImeSentenceMode | - |
InputScope | - |
LineAdjustment | GDI+互換モードの場合のみ有効 |
Margin | 有効 |
MouseOverBackColor | ProgressBarCell.UseVisualProgressBarStyle=Falseの場合のみ有効 |
MouseOverForeColor | 有効 |
MouseOverGradientEffect | ProgressBarCell.UseVisualProgressBarStyle=Falseの場合のみ有効 |
Multiline | 有効 |
NullValue | 有効 |
Padding | 有効 |
PatternColor | 有効 |
PatternStyle | 有効 |
SelectionBackColor | ProgressBarCell.UseVisualProgressBarStyle=Falseの場合のみ有効 |
SelectionForeColor | 有効 |
SelectionGradientEffect | ProgressBarCell.UseVisualProgressBarStyle=Falseの場合のみ有効 |
Tag | 有効 |
TextAdjustment | GDI+互換モードの場合のみ有効 |
TextAlign | 有効 |
TextAngle | GDI+互換モードの場合のみ有効 |
TextEffect | 有効 |
TextImageRelation | 有効 |
TextIndent | 有効 |
TextVertical | GDI+互換モードの場合のみ有効 |
UseCompatibleTextRendering | 有効 |
WordWrap | 有効 |
GDI+互換モードを有効にするには、ProgressBarCell.Style.UseCompatibleTextRenderingプロパティをTrueに設定します。
ショートカットキー
ProgressBarCellで処理されるショートカットキーはありません。
イベント
セルの内容領域のクリックに対応した処理を実装するには、GcMultiRow.CellContentClickイベントを使用します。ダブルクリックの場合はGcMultiRow.CellContentDoubleClickイベントです。
標準コントロールとの比較
次の表はProgressBarCellとSystem.Windows.Forms.ProgressBarコントロールの主要なプロパティの比較です。
ProgressBarCell | ProgressBar |
---|---|
MarqueeAnimationSpeed | なし |
Maximum | Maximum |
Minimum | Minimum |
なし | RightToLeft |
なし | RightToLeftLayout |
Step | Step |
ProgressBarStyle | Style |
Value | Value |
FillColor | なし |
FillDirection | なし |
ShowText | なし |
TextFormat | なし |
使用例