PowerTools SPREAD for Windows Forms 10.0J > 開発者ガイド > セル型 > グラフィカルなセル型 > プログレス型セル |
プログレス型セルでは、進行状況を示すコントロールがセル全体に表示されます。 塗りつぶし色、表示するテキスト、テキスト色を設定できます。
インジケータは単色で塗りつぶすことも(デフォルト)、下図に示すように、個々のバーによって塗りつぶすこともできます。
プログレス型セルとその各属性を設定するには、ProgressCellTypeクラスを使用します。
プログレス型セルの表示および操作をカスタマイズするには、以下のプロパティを使用します。
プロパティ | カスタマイズ |
---|---|
BackgroundImage | セルの背景画像を設定します。 |
FillColor | プログレスインジケータの塗りつぶしに使用する色を設定します。 |
FillColor2 | プログレスインジケータの塗りつぶしに使用するグラデーション色の2番目の色を設定します。 |
FillTextColor | プログレスインジケータの塗りつぶし部分に使用するテキストの色を設定します。 |
GradientMode | グラデーションスタイルで表示するプログレスインジケータのグラデーションモードを設定します。 |
Maximum | ユーザーが入力可能な最大値を設定します。 |
Minimum | ユーザーが入力可能な最小値を設定します。 |
Orientation | プログレスバーの方向を設定します。 |
Picture | スタイルを「Picture」に設定した場合にプログレスバーに使用するイメージを設定します。 |
ShowText | 塗りつぶしの度合いを示すパーセント文字列を表示するかどうかを設定します。 |
Style | プログレスバーのスタイルを設定します。 |
Text | TextStyle を「Custom」に設定した場合に使用する文字列を設定します。 |
TextStyle | プログレスバーのテキスト部分の表示方法を設定します。 |
特定のセル型において、一部のグラフィカル要素がビジュアルスタイルの影響を受けることに注意してください。 FpSpreadクラスのVisualStylesプロパティを「Off」に設定すると、これらのグラフィカルなセル型の視覚的なカスタマイズを、指定したとおりに機能させることができます。詳細については、「ビジュアルスタイル」を参照してください。 |
ProgressCellTypeクラスのインスタンスを作成して、クラスの各プロパティを設定します。
セルに設定する場合はCellクラスの、行に設定する場合はRowクラスの、列に設定する場合はColumnクラスの、あるいはスタイルに設定する場合はStyleInfoクラスのCellTypeプロパティに、定義したProgressCellTypeクラスのインスタンスを割り当てます。
次のサンプルコードは、セルをプログレス型セルに設定します。
C# |
コードのコピー
|
---|---|
FarPoint.Win.Spread.CellType.ProgressCellType progcell = new FarPoint.Win.Spread.CellType.ProgressCellType();
progcell.FillColor = Color.Red;
fpSpread1.ActiveSheet.Cells[0, 0].CellType = progcell;
fpSpread1.ActiveSheet.Cells[0, 0].VisualStyles = FarPoint.Win.VisualStyles.Off;
fpSpread1.ActiveSheet.Cells[0, 0].Value = 50;
|
Visual Basic |
コードのコピー
|
---|---|
Dim progcell As New FarPoint.Win.Spread.CellType.ProgressCellType() progcell.FillColor = Color.Red FpSpread1.ActiveSheet.Cells(0, 0).CellType = progcell FpSpread1.ActiveSheet.Cells(0, 0).VisualStyles = FarPoint.Win.VisualStyles.Off FpSpread1.ActiveSheet.Cells(0, 0).Value = 50 |