マウス

[C#] マウスポインタを砂時計に変更する方法

2025-01-18更新日: 2025-01-18

C#でマウスポインタを砂時計に変更するには、Cursorクラスを使用します。

具体的には、System.Windows.Forms名前空間のCursor.CurrentプロパティをCursors.WaitCursorに設定します。

これにより、現在のマウスポインタが砂時計(待機中のカーソル)に変更されます。

例えば、長時間の処理を行う前にCursor.Current = Cursors.WaitCursor;を設定し、処理が完了したらCursor.Current = Cursors.Default;で元に戻すことが一般的です。

これにより、ユーザーに処理中であることを視覚的に示すことができます。

目次から探す

砂時計カーソルの設定方法
実装例
応用例
まとめ

砂時計カーソルの設定方法

C#でアプリケーションを開発する際、ユーザーに処理中であることを示すために、マウスポインタを砂時計に変更することがあります。

ここでは、砂時計カーソルの設定方法について詳しく解説します。

Cursors.WaitCursorの使用

Cursors.WaitCursorは、簡単に砂時計カーソルを設定するためのプロパティです。

以下のサンプルコードでは、ボタンをクリックした際にカーソルを砂時計に変更し、一定時間後に元に戻す例を示します。

using System;
using System.Windows.Forms;
using System.Threading; // スレッドを使用するための名前空間
public class MainForm : Form
{
    private Button button;
    public MainForm()
    {
        button = new Button();
        button.Text = "処理開始";
        button.Click += new EventHandler(Button_Click);
        Controls.Add(button);
    }
    private void Button_Click(object sender, EventArgs e)
    {
        Cursor = Cursors.WaitCursor; // 砂時計カーソルに変更
        Thread.Sleep(3000); // 3秒間処理を待機
        Cursor = Cursors.Default; // 元のカーソルに戻す
    }
    [STAThread]
    public static void Main()
    {
        Application.EnableVisualStyles();
        Application.Run(new MainForm());
    }
}

このコードを実行すると、ボタンをクリックした際にカーソルが砂時計に変わり、3秒後に元のカーソルに戻ります。

Thread.Sleepは処理の待機をシミュレートするために使用しています。

Cursor.Currentプロパティの設定

Cursor.Currentプロパティを使用することで、現在のカーソルを動的に変更することができます。

以下の例では、Cursor.Currentを用いてカーソルを砂時計に変更します。

using System;
using System.Windows.Forms;
using System.Threading;
public class MainForm : Form
{
    private Button button;
    public MainForm()
    {
        button = new Button();
        button.Text = "処理開始";
        button.Click += new EventHandler(Button_Click);
        Controls.Add(button);
    }
    private void Button_Click(object sender, EventArgs e)
    {
        Cursor.Current = Cursors.WaitCursor; // 現在のカーソルを砂時計に変更
        Thread.Sleep(3000); // 3秒間処理を待機
        Cursor.Current = Cursors.Default; // 元のカーソルに戻す
    }
    [STAThread]
    public static void Main()
    {
        Application.EnableVisualStyles();
        Application.Run(new MainForm());
    }
}

このコードも、ボタンをクリックするとカーソルが砂時計に変わり、3秒後に元に戻ります。

Cursor.Currentを使用することで、より柔軟にカーソルを制御できます。

砂時計カーソルの解除方法

砂時計カーソルを解除するには、Cursors.Defaultを使用して元のカーソルに戻すことが一般的です。

以下の表に、砂時計カーソルの設定と解除の方法をまとめます。

操作内容	コード例
砂時計に変更	`Cursor = Cursors.WaitCursor;`
砂時計を解除	`Cursor = Cursors.Default;`

このように、Cursors.Defaultを使用することで、簡単に元のカーソルに戻すことができます。

これにより、ユーザーに対して処理が完了したことを明確に示すことができます。

実装例

ここでは、砂時計カーソルを使用する具体的な実装例を紹介します。

基本的な実装から、長時間処理や非同期処理での使用例までを解説します。

基本的な実装例

まずは、基本的な砂時計カーソルの実装例を示します。

ボタンをクリックすると、カーソルが砂時計に変わり、一定時間後に元に戻るシンプルな例です。

using System;
using System.Windows.Forms;
using System.Threading;
public class MainForm : Form
{
    private Button button;
    public MainForm()
    {
        button = new Button();
        button.Text = "処理開始";
        button.Click += new EventHandler(Button_Click);
        Controls.Add(button);
    }
    private void Button_Click(object sender, EventArgs e)
    {
        Cursor = Cursors.WaitCursor; // 砂時計カーソルに変更
        Thread.Sleep(2000); // 2秒間処理を待機
        Cursor = Cursors.Default; // 元のカーソルに戻す
    }
    [STAThread]
    public static void Main()
    {
        Application.EnableVisualStyles();
        Application.Run(new MainForm());
    }
}

このコードを実行すると、ボタンをクリックした際にカーソルが砂時計に変わり、2秒後に元のカーソルに戻ります。

Thread.Sleepは処理の待機をシミュレートしています。

長時間処理での使用例

長時間の処理を行う場合、ユーザーに処理中であることを示すために砂時計カーソルを使用します。

以下の例では、ループを用いて長時間の処理をシミュレートしています。

using System;
using System.Windows.Forms;
using System.Threading;
public class MainForm : Form
{
    private Button button;
    public MainForm()
    {
        button = new Button();
        button.Text = "長時間処理開始";
        button.Click += new EventHandler(Button_Click);
        Controls.Add(button);
    }
    private void Button_Click(object sender, EventArgs e)
    {
        Cursor = Cursors.WaitCursor; // 砂時計カーソルに変更
        for (int i = 0; i < 5; i++)
        {
            Thread.Sleep(1000); // 1秒間の処理を5回繰り返す
        }
        Cursor = Cursors.Default; // 元のカーソルに戻す
    }
    [STAThread]
    public static void Main()
    {
        Application.EnableVisualStyles();
        Application.Run(new MainForm());
    }
}

このコードでは、ボタンをクリックすると5秒間の処理が行われ、その間カーソルが砂時計に変わります。

ループを用いることで、長時間の処理をシミュレートしています。

非同期処理での使用例

非同期処理を行う場合、UIスレッドをブロックしないようにするため、asyncとawaitを使用します。

以下の例では、非同期メソッドを用いて砂時計カーソルを設定しています。

using System;
using System.Windows.Forms;
using System.Threading.Tasks;
public class MainForm : Form
{
    private Button button;
    public MainForm()
    {
        button = new Button();
        button.Text = "非同期処理開始";
        button.Click += new EventHandler(Button_Click);
        Controls.Add(button);
    }
    private async void Button_Click(object sender, EventArgs e)
    {
        Cursor = Cursors.WaitCursor; // 砂時計カーソルに変更
        await Task.Run(() => LongRunningProcess()); // 非同期で長時間処理を実行
        Cursor = Cursors.Default; // 元のカーソルに戻す
    }
    private void LongRunningProcess()
    {
        // 長時間の処理をシミュレート
        for (int i = 0; i < 5; i++)
        {
            System.Threading.Thread.Sleep(1000); // 1秒間の処理を5回繰り返す
        }
    }
    [STAThread]
    public static void Main()
    {
        Application.EnableVisualStyles();
        Application.Run(new MainForm());
    }
}

このコードでは、ボタンをクリックすると非同期で5秒間の処理が行われ、その間カーソルが砂時計に変わります。

Task.Runを使用することで、UIスレッドをブロックせずに処理を実行できます。

応用例

砂時計カーソルの基本的な使用方法を理解したところで、さらに応用的な使い方を見ていきましょう。

ここでは、カスタムカーソルの作成や状況に応じたカーソルの切り替え、ユーザーインターフェースの改善について解説します。

カスタムカーソルの作成

C#では、独自のカーソルを作成して使用することができます。

これにより、アプリケーションのデザインに合わせたカーソルを提供することが可能です。

以下の例では、カスタムカーソルを作成して使用する方法を示します。

using System;
using System.Windows.Forms;
using System.Drawing; // カーソルの画像を扱うための名前空間
public class MainForm : Form
{
    private Button button;
    private Cursor customCursor;
    public MainForm()
    {
        button = new Button();
        button.Text = "カスタムカーソル";
        button.Click += new EventHandler(Button_Click);
        Controls.Add(button);
        // カスタムカーソルの作成
        Bitmap cursorBitmap = new Bitmap("custom_cursor.png"); // カーソル画像を読み込む
        customCursor = new Cursor(cursorBitmap.GetHicon());
    }
    private void Button_Click(object sender, EventArgs e)
    {
        Cursor = customCursor; // カスタムカーソルに変更
        MessageBox.Show("カスタムカーソルが設定されました。");
        Cursor = Cursors.Default; // 元のカーソルに戻す
    }
    [STAThread]
    public static void Main()
    {
        Application.EnableVisualStyles();
        Application.Run(new MainForm());
    }
}

このコードでは、custom_cursor.pngという画像ファイルを使用してカスタムカーソルを作成しています。

ボタンをクリックすると、カーソルがカスタムカーソルに変わります。

状況に応じたカーソルの切り替え

アプリケーションの状況に応じてカーソルを動的に切り替えることで、ユーザーに対してより直感的な操作感を提供できます。

以下の例では、マウスの位置に応じてカーソルを切り替える方法を示します。

using System;
using System.Windows.Forms;
public class MainForm : Form
{
    public MainForm()
    {
        this.MouseMove += new MouseEventHandler(Form_MouseMove);
    }
    private void Form_MouseMove(object sender, MouseEventArgs e)
    {
        if (e.X < this.Width / 2)
        {
            Cursor = Cursors.Hand; // 左側では手のカーソル
        }
        else
        {
            Cursor = Cursors.Cross; // 右側では十字のカーソル
        }
    }
    [STAThread]
    public static void Main()
    {
        Application.EnableVisualStyles();
        Application.Run(new MainForm());
    }
}