GcProgressBarCellは、PlusPakのGcProgressBarコントロールと同等の機能を提供します。GcProgressBarCellを使用すると、グラデーションや任意のイメージで進捗を表現できます。
機能
GcProgressBarCellでは、ProgressBarCellの機能に加えて、次の機能を使用できます。
各機能の詳細はGcProgressBarCellクラスのリファレンスを参照してください。
- グラデーション効果
- 画像を使った描画
- 文字の向きのカスタマイズ
各機能の詳細はGcProgressBarCellクラスのリファレンスを参照してください。
データ型
GcProgressBarCellはObject型の値を保持します。この型はGcProgressBarCell.ValueTypeプロパティで確認できます。
入力と表示には、Integer型にキャストした値が使用されます。この型はGcProgressBarCell.FormattedValueTypeプロパティで確認できます。セルに値が読み出される場合の動作を変更するには、GcProgressBarCell.OnCellFormattingメソッドをオーバーライドします。セルから値が書き戻される場合の動作を変更するには、GcProgressBarCell.OnCellParsingメソッドをオーバーライドします。
入力と表示には、Integer型にキャストした値が使用されます。この型はGcProgressBarCell.FormattedValueTypeプロパティで確認できます。セルに値が読み出される場合の動作を変更するには、GcProgressBarCell.OnCellFormattingメソッドをオーバーライドします。セルから値が書き戻される場合の動作を変更するには、GcProgressBarCell.OnCellParsingメソッドをオーバーライドします。
セル編集コントロール
GcProgressBarCellのセル編集コントロールはありません。GcProgressBarCell.EditTypeプロパティは常にNull参照(Visual BasicではNothing)を返します。
スタイル
GcProgressBarCellはCellStyleクラスの次のメンバをサポートしています。セルのスタイルはCell.Styleプロパティで設定します。
| CellStyle メンバ | 有効／無効 |
|---|---|
| BackColor | 有効 |
| BackgroundGradientEffect | - |
| Border | 有効 |
| DataSourceNullValue | 有効 |
| DisabledBackColor | 有効 |
| DisabledForeColor | - |
| DisabledGradientEffect | - |
| EditingBackColor | - |
| EditingForeColor | - |
| Font | 有効 |
| ForeColor | 有効 |
| Format | - |
| FormatProvider | - |
| Image | - |
| ImageAlign | - |
| ImeMode | - |
| ImeSentenceMode | - |
| InputScope | - |
| LineAdjustment | - |
| Margin | 有効 |
| MouseOverBackColor | 有効 |
| MouseOverForeColor | 有効 |
| MouseOverGradientEffect | - |
| Multiline | - |
| NullValue | 有効 |
| Padding | 有効 |
| PatternColor | 有効 |
| PatternStyle | 有効 |
| SelectionBackColor | 有効 |
| SelectionForeColor | 有効 |
| SelectionGradientEffect | - |
| Tag | 有効 |
| TextAdjustment | - |
| TextAlign | 有効 |
| TextAngle | - |
| TextEffect | - |
| TextImageRelation | - |
| TextIndent | - |
| TextVertical | - |
| UseCompatibleTextRendering | - |
| WordWrap | - |
ショートカットキー
GcProgressBarCellで処理されるショートカットキーはありません。
イベント
セルの内容領域のクリックに対応した処理を実装するには、GcMultiRow.CellContentClickイベントを使用します。ダブルクリックの場合はGcMultiRow.CellContentDoubleClickイベントです。
PlusPakコントロールとの比較
次の表はGcProgressBarCellとPlusPakのGcProgressBarコントロールの主要なプロパティの比較です。
| GcProgressBarCell | GcProgressBar |
|---|---|
| Style.BackColor | BackColor |
| BackGradientEffect | BackGradientEffect |
| BackgroundImage | BackgroundImage |
| BackgroundImageLayout | BackgroundImageLayout |
| Style.Border | BorderStyle |
| DisplayTextFormat | DisplayTextFormat |
| DisplayText | DisplayText |
| FillColor | FillColor |
| FillForeColor | FillForeColor |
| FillGradientEffect | FillGradientEffect |
| FillImage | FillImage |
| FillImageLayout | FillImageLayout |
| FlatStyle | FlatStyle |
| Style.Font | Font |
| Style.ForeColor | ForeColor |
| なし | MarqueeAnimationSpeed |
| Maximum | Maximum |
| Minimum | Minimum |
| Orientation | Orientation |
| ReverseFillDirection | ReverseFillDirection |
| Step | Step |
| Style.Border | SingleBorderColor |
| ProgressBarStyle | Style |
| Style.TextAlign | TextAlign |
| TextOrientation | TextOrientation |
| Value | Value |
組み込みのセル型との比較
次の表はGcProgressBarCellとProgressBarCellのプロパティの主要なプロパティの比較です。
| GcProgressBarCell | ProgressBarCell |
|---|---|
| BackGradientEffect | なし |
| BackgroundImage | なし |
| BackgroundImageLayout | なし |
| FillForeColor | なし |
| FillGradientEffect | なし |
| FillImage | なし |
| FillImageLayout | なし |
| FlatStyle | なし |
| Orientation ReverseFillDirection |
FillDirection |
| DisplayTextFormat | TextFormat |
GcProgressBarCellの利用
ここでは、GcProgressBarCellの利用方法について、以下の項目に分けて解説しています。