進行状況の設定

GcProgressBarCellの進捗状況の設定方法について、以下に解説します。

進行範囲の指定

タスクの進行状況を表す値の範囲を指定するには、GcProgressBarCellのMaximumプロパティとMinimumプロパティを使用します。通常、Minimumプロパティは0に設定され、Maximumプロパティはタスクの完了を示す値に設定します。

進行状況の変更

タスクの進行状況を表すには、Valueプロパティを使用します。GcProgressBarCellはValueプロパティの値を基にコントロールを塗りつぶします。

進行状況の値を変更するには、StepプロパティとPerformStepメソッドを組み合わせて使用する方法もあります。毎回特定の量だけ増やすには、Stepプロパティに増加分を設定し、PerformStepメソッドを呼び出すことで進行を表します。

また、特定の値だけ増加させるには、Incrementメソッドを使用します。

Visual Basic
C#

Imports GrapeCity.Win.MultiRow
Imports PlusPakCell = GrapeCity.Win.MultiRow.PlusPak

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
    Dim GcProgressBarCell1 As New PlusPakCell.GcProgressBarCell()
    ' 増加する量を設定します。
    GcProgressBarCell1.Step = 5

    GcMultiRow1.Template = Template.CreateGridTemplate(New Cell() {GcProgressBarCell1})
    GcMultiRow1.RowCount = 10
End Sub

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
    ' 現在の位置をStepプロパティの量だけ進めます。 
    DirectCast(GcMultiRow1(0, 0), PlusPakCell.GcProgressBarCell).PerformStep()

End Sub

Private Sub Button2_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button2.Click
    ' 現在の位置を指定の量（10）だけ進めます。
    DirectCast(GcMultiRow1(0, 0), PlusPakCell.GcProgressBarCell).Increment(15)
End Sub

using GrapeCity.Win.MultiRow;
using PlusPakCell = GrapeCity.Win.MultiRow.PlusPak;

private void Form1_Load(object sender, EventArgs e)
{
    PlusPakCell.GcProgressBarCell gcProgressBarCell1 = new PlusPakCell.GcProgressBarCell();
    // 増加する量を設定します。
    gcProgressBarCell1.Step = 5;

    gcMultiRow1.Template = Template.CreateGridTemplate(new Cell[] { gcProgressBarCell1 });
    gcMultiRow1.RowCount = 10;

}

private void button1_Click(object sender, EventArgs e)
{
    // 現在の位置をStepプロパティの量だけ進めます。 
    (gcMultiRow1[0, 0] as PlusPakCell.GcProgressBarCell).PerformStep();
}

private void button2_Click(object sender, EventArgs e)
{
    // 現在の位置を指定の量（10）だけ進めます。
    (gcMultiRow1[0, 0] as PlusPakCell.GcProgressBarCell).Increment(15);
}

参照