ProgressBar

[C#] ProgressBarの値設定方法と活用法

C#のProgressBarは、進行状況を視覚的に示すためのコントロールです。

値の設定は、Valueプロパティを使用して行います。

例えば、progressBar.Value = 50;とすることで、進行状況を50%に設定できます。

MinimumとMaximumプロパティで範囲を設定し、Stepプロパティで増加量を指定できます。

活用法としては、ファイルのダウンロードやデータ処理の進捗をユーザーに示す際に便利です。

非同期処理と組み合わせることで、UIの応答性を保ちながら進行状況を更新できます。

目次から探す
  1. ProgressBarの値設定方法
  2. ProgressBarの活用法
  3. ProgressBarの応用例
  4. まとめ

ProgressBarの値設定方法

Valueプロパティの使い方

Valueプロパティは、ProgressBarの現在の値を設定するために使用します。

この値は、MinimumプロパティとMaximumプロパティの範囲内でなければなりません。

以下は、Valueプロパティを使用したサンプルコードです。

using System;
using System.Windows.Forms;
public class ProgressBarExample : Form
{
    private ProgressBar progressBar;
    public ProgressBarExample()
    {
        progressBar = new ProgressBar();
        progressBar.Minimum = 0; // 最小値を設定
        progressBar.Maximum = 100; // 最大値を設定
        progressBar.Value = 50; // 現在の値を設定
        Controls.Add(progressBar);
    }
    static void Main()
    {
        Application.Run(new ProgressBarExample());
    }
}
ProgressBarが50の位置に設定されたウィンドウが表示されます。

MinimumとMaximumプロパティの設定

MinimumプロパティとMaximumプロパティは、ProgressBarの値の範囲を定義します。

これにより、ProgressBarがどの範囲で動作するかを指定できます。

以下のサンプルコードでは、これらのプロパティを設定しています。

using System;
using System.Windows.Forms;
public class ProgressBarRangeExample : Form
{
    private ProgressBar progressBar;
    public ProgressBarRangeExample()
    {
        progressBar = new ProgressBar();
        progressBar.Minimum = 0; // 最小値を0に設定
        progressBar.Maximum = 200; // 最大値を200に設定
        progressBar.Value = 100; // 現在の値を100に設定
        Controls.Add(progressBar);
    }
    static void Main()
    {
        Application.Run(new ProgressBarRangeExample());
    }
}
ProgressBarが100の位置に設定されたウィンドウが表示されます。

Stepプロパティによる増加量の設定

Stepプロパティは、ProgressBarの値を増加させる際の単位を指定します。

このプロパティを使用することで、ProgressBarの進行状況を段階的に更新できます。

以下は、Stepプロパティを使用したサンプルコードです。

using System;
using System.Windows.Forms;
public class ProgressBarStepExample : Form
{
    private ProgressBar progressBar;
    public ProgressBarStepExample()
    {
        progressBar = new ProgressBar();
        progressBar.Minimum = 0;
        progressBar.Maximum = 100;
        progressBar.Step = 10; // 増加量を10に設定
        for (int i = 0; i < 10; i++)
        {
            progressBar.PerformStep(); // Step分だけ進める
        }
        Controls.Add(progressBar);
    }
    static void Main()
    {
        Application.Run(new ProgressBarStepExample());
    }
}
ProgressBarが100の位置に設定されたウィンドウが表示されます。

値の更新方法

ProgressBarの値を更新するには、Valueプロパティを直接設定するか、PerformStepメソッドを使用します。

以下のサンプルコードでは、ボタンをクリックすることでProgressBarの値を更新する方法を示しています。

using System;
using System.Windows.Forms;
public class ProgressBarUpdateExample : Form
{
    private ProgressBar progressBar;
    private Button button;
    public ProgressBarUpdateExample()
    {
        progressBar = new ProgressBar();
        progressBar.Minimum = 0;
        progressBar.Maximum = 100;
        progressBar.Value = 0;
        button = new Button();
        button.Text = "進める";
        button.Click += new EventHandler(OnButtonClick);
        Controls.Add(progressBar);
        Controls.Add(button);
    }
    private void OnButtonClick(object sender, EventArgs e)
    {
        if (progressBar.Value < progressBar.Maximum)
        {
            progressBar.Value += 10; // 値を10増やす
        }
    }
    static void Main()
    {
        Application.Run(new ProgressBarUpdateExample());
    }
}
ボタンをクリックすることでProgressBarが10ずつ進むウィンドウが表示されます。

ProgressBarの活用法

ファイルダウンロードの進捗表示

ファイルのダウンロード中にProgressBarを使用することで、ユーザーに進捗状況を視覚的に示すことができます。

以下のサンプルコードでは、ファイルをダウンロードする際のProgressBarの使用例を示しています。

using System;
using System.Net;
using System.Windows.Forms;
public class FileDownloadExample : Form
{
    private ProgressBar progressBar;
    private Button downloadButton;
    public FileDownloadExample()
    {
        progressBar = new ProgressBar();
        progressBar.Minimum = 0;
        progressBar.Maximum = 100;
        downloadButton = new Button();
        downloadButton.Text = "ダウンロード開始";
        downloadButton.Click += new EventHandler(OnDownloadButtonClick);
        Controls.Add(progressBar);
        Controls.Add(downloadButton);
    }
    private void OnDownloadButtonClick(object sender, EventArgs e)
    {
        WebClient webClient = new WebClient();
        webClient.DownloadProgressChanged += new DownloadProgressChangedEventHandler(OnDownloadProgressChanged);
        webClient.DownloadFileAsync(new Uri("https://example.com/file.zip"), "file.zip");
    }
    private void OnDownloadProgressChanged(object sender, DownloadProgressChangedEventArgs e)
    {
        progressBar.Value = e.ProgressPercentage; // 進捗を更新
    }
    static void Main()
    {
        Application.Run(new FileDownloadExample());
    }
}
ファイルのダウンロード中にProgressBarが進捗を表示します。

データ処理の進行状況表示

データ処理を行う際にProgressBarを使用することで、処理の進行状況をユーザーに示すことができます。

以下のサンプルコードでは、データ処理の進行状況を表示する例を示しています。

using System;
using System.Threading;
using System.Windows.Forms;
public class DataProcessingExample : Form
{
    private ProgressBar progressBar;
    private Button processButton;
    public DataProcessingExample()
    {
        progressBar = new ProgressBar();
        progressBar.Minimum = 0;
        progressBar.Maximum = 100;
        processButton = new Button();
        processButton.Text = "データ処理開始";
        processButton.Click += new EventHandler(OnProcessButtonClick);
        Controls.Add(progressBar);
        Controls.Add(processButton);
    }
    private void OnProcessButtonClick(object sender, EventArgs e)
    {
        for (int i = 0; i <= 100; i++)
        {
            Thread.Sleep(50); // 処理のシミュレーション
            progressBar.Value = i; // 進捗を更新
        }
    }
    static void Main()
    {
        Application.Run(new DataProcessingExample());
    }
}
データ処理中にProgressBarが進捗を表示します。

インストールプロセスの進捗管理

インストールプロセスにおいてProgressBarを使用することで、ユーザーにインストールの進行状況を示すことができます。

以下のサンプルコードでは、インストールプロセスの進捗を表示する例を示しています。

using System;
using System.Threading;
using System.Windows.Forms;
public class InstallationProgressExample : Form
{
    private ProgressBar progressBar;
    private Button installButton;
    public InstallationProgressExample()
    {
        progressBar = new ProgressBar();
        progressBar.Minimum = 0;
        progressBar.Maximum = 100;
        installButton = new Button();
        installButton.Text = "インストール開始";
        installButton.Click += new EventHandler(OnInstallButtonClick);
        Controls.Add(progressBar);
        Controls.Add(installButton);
    }
    private void OnInstallButtonClick(object sender, EventArgs e)
    {
        for (int i = 0; i <= 100; i++)
        {
            Thread.Sleep(30); // インストールのシミュレーション
            progressBar.Value = i; // 進捗を更新
        }
    }
    static void Main()
    {
        Application.Run(new InstallationProgressExample());
    }
}
インストール中にProgressBarが進捗を表示します。

ProgressBarの応用例

非同期処理との組み合わせ

非同期処理を使用することで、UIがブロックされることなくProgressBarを更新できます。

以下のサンプルコードでは、非同期メソッドを使用してProgressBarを更新する例を示しています。

using System;
using System.Threading.Tasks;
using System.Windows.Forms;
public class AsyncProgressBarExample : Form
{
    private ProgressBar progressBar;
    private Button startButton;
    public AsyncProgressBarExample()
    {
        progressBar = new ProgressBar();
        progressBar.Minimum = 0;
        progressBar.Maximum = 100;
        startButton = new Button();
        startButton.Text = "非同期処理開始";
        startButton.Click += new EventHandler(OnStartButtonClick);
        Controls.Add(progressBar);
        Controls.Add(startButton);
    }
    private async void OnStartButtonClick(object sender, EventArgs e)
    {
        await Task.Run(() => 
        {
            for (int i = 0; i <= 100; i++)
            {
                Task.Delay(50).Wait(); // 処理のシミュレーション
                UpdateProgress(i); // 進捗を更新
            }
        });
    }
    private void UpdateProgress(int value)
    {
        if (progressBar.InvokeRequired)
        {
            progressBar.Invoke(new Action(() => progressBar.Value = value));
        }
        else
        {
            progressBar.Value = value;
        }
    }
    static void Main()
    {
        Application.Run(new AsyncProgressBarExample());
    }
}
非同期処理中にProgressBarが進捗を表示します。

カスタムスタイルのProgressBar

ProgressBarの外観をカスタマイズすることで、アプリケーションのデザインに合わせることができます。

以下のサンプルコードでは、カスタムスタイルのProgressBarを作成する方法を示しています。

using System;
using System.Drawing;
using System.Windows.Forms;
public class CustomProgressBarExample : Form
{
    private ProgressBar progressBar;
    public CustomProgressBarExample()
    {
        progressBar = new ProgressBar();
        progressBar.Minimum = 0;
        progressBar.Maximum = 100;
        progressBar.Value = 50;
        progressBar.ForeColor = Color.Green; // 色を変更
        Controls.Add(progressBar);
    }
    protected override void OnPaint(PaintEventArgs e)
    {
        base.OnPaint(e);
        // カスタム描画
        e.Graphics.FillRectangle(new SolidBrush(progressBar.ForeColor), 
            new Rectangle(0, 0, (int)(progressBar.Width * (progressBar.Value / 100.0)), progressBar.Height));
    }
    static void Main()
    {
        Application.Run(new CustomProgressBarExample());
    }
}
カスタムスタイルのProgressBarが表示されます。

複数のProgressBarの管理

複数のProgressBarを同時に管理することで、異なる処理の進捗を同時に表示できます。

以下のサンプルコードでは、2つのProgressBarを管理する例を示しています。

using System;
using System.Threading;
using System.Windows.Forms;
public class MultipleProgressBarsExample : Form
{
    private ProgressBar progressBar1;
    private ProgressBar progressBar2;
    private Button startButton;
    public MultipleProgressBarsExample()
    {
        progressBar1 = new ProgressBar();
        progressBar1.Minimum = 0;
        progressBar1.Maximum = 100;
        progressBar2 = new ProgressBar();
        progressBar2.Minimum = 0;
        progressBar2.Maximum = 100;
        progressBar2.Top = 30; // 位置を調整
        startButton = new Button();
        startButton.Text = "処理開始";
        startButton.Click += new EventHandler(OnStartButtonClick);
        Controls.Add(progressBar1);
        Controls.Add(progressBar2);
        Controls.Add(startButton);
    }
    private void OnStartButtonClick(object sender, EventArgs e)
    {
        Thread thread1 = new Thread(() => UpdateProgress(progressBar1));
        Thread thread2 = new Thread(() => UpdateProgress(progressBar2));
        thread1.Start();
        thread2.Start();
    }
    private void UpdateProgress(ProgressBar progressBar)
    {
        for (int i = 0; i <= 100; i++)
        {
            Thread.Sleep(50); // 処理のシミュレーション
            progressBar.Invoke(new Action(() => progressBar.Value = i)); // 進捗を更新
        }
    }
    static void Main()
    {
        Application.Run(new MultipleProgressBarsExample());
    }
}
2つのProgressBarが同時に進捗を表示します。

ユーザーインターフェースの改善

ProgressBarを使用することで、ユーザーインターフェースを改善し、ユーザーに対して処理の進行状況を明示的に示すことができます。

以下のサンプルコードでは、ProgressBarを使用してユーザーインターフェースを改善する方法を示しています。

using System;
using System.Threading;
using System.Windows.Forms;
public class UIImprovementExample : Form
{
    private ProgressBar progressBar;
    private Button startButton;
    private Label statusLabel;
    public UIImprovementExample()
    {
        progressBar = new ProgressBar();
        progressBar.Minimum = 0;
        progressBar.Maximum = 100;
        startButton = new Button();
        startButton.Text = "処理開始";
        startButton.Click += new EventHandler(OnStartButtonClick);
        statusLabel = new Label();
        statusLabel.Top = 30; // 位置を調整
        Controls.Add(progressBar);
        Controls.Add(startButton);
        Controls.Add(statusLabel);
    }
    private void OnStartButtonClick(object sender, EventArgs e)
    {
        statusLabel.Text = "処理中...";
        for (int i = 0; i <= 100; i++)
        {
            Thread.Sleep(50); // 処理のシミュレーション
            progressBar.Value = i; // 進捗を更新
        }
        statusLabel.Text = "処理完了！";
    }
    static void Main()
    {
        Application.Run(new UIImprovementExample());
    }
}
処理中のメッセージと共にProgressBarが進捗を表示します。

まとめ

この記事では、C#におけるProgressBarの値設定方法や活用法、応用例について詳しく解説しました。

特に、非同期処理との組み合わせやカスタムスタイルの作成、複数のProgressBarの管理方法など、実践的な内容に焦点を当てています。

これらの知識を活用して、ユーザーインターフェースをより魅力的にし、アプリケーションの使い勝手を向上させることに挑戦してみてください。

Back to top button