마우스는 컴퓨터 사용에 필수적인 입력 장치입니다. 시스템에는 마우스의 다양한 기본 설정이 존재하며, 예를 들어 더블 클릭 시간, 캐럿 깜빡임 주기, 이동 속도 등이 있습니다. 이 문서에서는 C# 언어를 사용하여 이러한 마우스 관련 정보를 프로그래밍 방식으로 조회하고 제어하는 다양한 방법을 다룹니다.

1.1 마우스 정보 조회

① 마우스 더블 클릭 시간 간격 얻기

시스템에서 두 번의 마우스 클릭을 더블 클릭으로 인식하는 최대 시간 간격을 얻는 방법입니다. user32.dll에 포함된 GetDoubleClickTime 함수를 사용합니다.

using System;
using System.Runtime.InteropServices;
using System.Windows.Forms;

public partial class MainForm : Form
{
    [DllImport("user32.dll")]
    private static extern int GetDoubleClickTime();

    public MainForm()
    {
        InitializeComponent(); // WinForms 초기화 메서드
        this.Load += new EventHandler(MainForm_Load);
    }

    private Label statusLabel; // 폼에 Label 컨트롤이 있다고 가정

    private void MainForm_Load(object sender, EventArgs e)
    {
        int doubleClickIntervalMs = GetDoubleClickTime();
        statusLabel.Text = $"더블 클릭 시간: {doubleClickIntervalMs}ms";
    }
}

② 캐럿(커서) 깜빡임 주기 얻기

텍스트 입력 시 나타나는 캐럿(입력 커서)의 깜빡임 주기를 밀리초 단위로 가져옵니다. user32.dll의 GetCaretBlinkTime 함수를 활용합니다.

using System;
using System.Runtime.InteropServices;
using System.Windows.Forms;

public partial class CursorInfoForm : Form
{
    [DllImport("user32.dll")]
    private static extern int GetCaretBlinkTime();

    public CursorInfoForm()
    {
        InitializeComponent();
        this.Load += new EventHandler(CursorInfoForm_Load);
    }

    private Label infoLabel; // 폼에 Label 컨트롤이 있다고 가정

    private void CursorInfoForm_Load(object sender, EventArgs e)
    {
        int blinkDuration = GetCaretBlinkTime();
        infoLabel.Text = $"캐럿 깜빡임 주기: {blinkDuration}ms";
    }
}

③ 마우스 버튼 개수 얻기

시스템에 연결된 마우스의 버튼 개수를 조회합니다. user32.dll의 GetSystemMetrics 함수와 SM_CMOUSEBUTTONS 상수(값 43)를 사용합니다.

using System;
using System.Runtime.InteropServices;
using System.Windows.Forms;

public partial class ButtonCountForm : Form
{
    private const int SM_CMOUSEBUTTONS = 43; // 마우스 버튼 개수를 위한 시스템 메트릭스 인덱스

    [DllImport("user32.dll")]
    private static extern int GetSystemMetrics(int metricIndex);

    public ButtonCountForm()
    {
        InitializeComponent();
        this.Load += new EventHandler(ButtonCountForm_Load);
    }

    private Label resultLabel; // 폼에 Label 컨트롤이 있다고 가정

    private void ButtonCountForm_Load(object sender, EventArgs e)
    {
        int buttonCount = GetSystemMetrics(SM_CMOUSEBUTTONS);
        resultLabel.Text = $"마우스 버튼 수: {buttonCount}개";
    }
}

④ 마우스 대기 커서 표시

프로그램이 작업을 수행 중일 때 사용자에게 대기 중임을 시각적으로 알리기 위해 마우스 커서를 표준 대기 커서(모래시계 또는 회전 원)로 변경하는 방법입니다.

using System;
using System.Windows.Forms;

public partial class WaitCursorForm : Form
{
    public WaitCursorForm()
    {
        InitializeComponent();
        this.Load += new EventHandler(WaitCursorForm_Load);
    }

    private void WaitCursorForm_Load(object sender, EventArgs e)
    {
        // 폼의 커서를 대기 커서로 설정합니다.
        this.Cursor = Cursors.WaitCursor;
    }
}

⑤ 폼 위 마우스 위치 얻기

사용자가 폼 위에서 마우스 버튼을 클릭했을 때, 해당 클릭 지점의 좌표(X, Y)를 폼 기준으로 가져옵니다. MouseEventArgs 객체의 X와 Y 속성을 사용합니다.

using System;
using System.Windows.Forms;

public partial class MousePositionForm : Form
{
    public MousePositionForm()
    {
        InitializeComponent();
        this.MouseDown += new MouseEventHandler(MousePositionForm_MouseDown);
    }

    private Label xCoordLabel; // 폼에 X 좌표를 표시할 Label 컨트롤이 있다고 가정
    private Label yCoordLabel; // 폼에 Y 좌표를 표시할 Label 컨트롤이 있다고 가정

    private void MousePositionForm_MouseDown(object sender, MouseEventArgs e)
    {
        xCoordLabel.Text = $"X 좌표: {e.X}";
        yCoordLabel.Text = $"Y 좌표: {e.Y}";
    }
}

1.2 마우스 기본 설정

① 마우스 포인터 모양 변경

특정 컨트롤 위로 마우스가 이동했을 때, 마우스 포인터의 모양을 변경하여 사용자에게 해당 컨트롤이 상호작용 가능함을 알리는 방법입니다. 예를 들어, 링크 위에서 손가락 모양 커서로 변경할 수 있습니다.

using System.Windows.Forms;

public partial class CursorShapeForm : Form
{
    public CursorShapeForm()
    {
        InitializeComponent();
        // 폼 로드 시 또는 특정 시점에 호출
        SetCursorForLabel(this.clickableLabel); // 'clickableLabel'은 폼에 있는 Label 컨트롤
    }

    private Label clickableLabel; // 폼에 Label 컨트롤이 있다고 가정

    private void SetCursorForLabel(Label targetLabel)
    {
        // 'targetLabel' 컨트롤 위로 마우스가 올라가면 손가락 모양 커서를 표시합니다.
        targetLabel.Cursor = Cursors.Hand;
    }
}

② 사용자 정의 마우스 커서 사용

시스템 기본 커서 대신 사용자 정의 .cur 파일을 사용하여 마우스 포인터의 시각적 스타일을 변경할 수 있습니다. 이는 애플리케이션의 브랜드나 특정 기능을 강조할 때 유용합니다.

using System;
using System.Drawing;
using System.IO; // For FileNotFoundException
using System.Windows.Forms;

public partial class CustomCursorForm : Form
{
    public CustomCursorForm()
    {
        InitializeComponent();
    }

    private Button changeCursorButton; // 폼에 Button 컨트롤이 있다고 가정

    private void ChangeCursorButton_Click(object sender, EventArgs e)
    {
        try
        {
            // 애플리케이션의 실행 경로 또는 지정된 경로에 'custom_pen.cur' 파일이 있다고 가정합니다.
            // 이 경로는 실제 커서 파일의 경로로 대체되어야 합니다.
            string cursorFilePath = "custom_pen.cur"; 
            this.Cursor = new Cursor(cursorFilePath);
        }
        catch (FileNotFoundException ex)
        {
            MessageBox.Show($"커서 파일을 찾을 수 없습니다: {ex.Message}", "오류", MessageBoxButtons.OK, MessageBoxIcon.Error);
        }
        catch (Exception ex)
        {
            MessageBox.Show($"커서 변경 중 오류 발생: {ex.Message}", "오류", MessageBoxButtons.OK, MessageBoxIcon.Error);
        }
    }
}

③ 마우스 좌우 버튼 기능 교환

Windows 시스템 설정에서 마우스의 왼쪽 및 오른쪽 버튼 기능을 프로그래밍 방식으로 교환하거나 기본값으로 되돌릴 수 있습니다. user32.dll의 SwapMouseButton 함수를 사용하며, 인자로 true를 전달하면 버튼이 교환되고, false를 전달하면 기본 상태로 돌아옵니다.

using System;
using System.Runtime.InteropServices;
using System.Windows.Forms;

public partial class MouseButtonSwapForm : Form
{
    [DllImport("user32.dll")]
    private static extern bool SwapMouseButton(bool bSwap);

    public MouseButtonSwapForm()
    {
        InitializeComponent();
    }

    private Button btnEnableLeftHand; // 좌수 모드 버튼
    private Button btnEnableRightHand; // 우수 모드 버튼

    public void SetLeftHandedMode()
    {
        // 마우스 버튼을 좌수용(오른쪽 버튼이 주 클릭)으로 설정합니다.
        SwapMouseButton(true); 
    }

    public void SetRightHandedMode()
    {
        // 마우스 버튼을 우수용(왼쪽 버튼이 주 클릭)으로 설정합니다.
        SwapMouseButton(false);
    }

    private void ToggleMouseButtons_Click(object sender, EventArgs e)
    {
        if (sender == btnEnableLeftHand)
        {
            SetLeftHandedMode();
            MessageBox.Show("마우스 버튼이 좌수용으로 변경되었습니다.", "알림");
        }
        else if (sender == btnEnableRightHand)
        {
            SetRightHandedMode();
            MessageBox.Show("마우스 버튼이 우수용으로 변경되었습니다.", "알림");
        }
    }
}

④ 마우스 커서 제어 영역 고정

마우스 커서의 움직임을 특정 화면 영역이나 폼 내로 제한할 수 있습니다. 이는 특정 UI 요소 내에서만 마우스 상호작용이 필요한 경우 유용합니다. Cursor.Clip 속성을 사용하며, Rectangle 구조체를 통해 제한 영역을 지정합니다.

using System;
using System.Drawing;
using System.Windows.Forms;

public partial class CursorClipForm : Form
{
    public CursorClipForm()
    {
        InitializeComponent();
    }

    private Button btnConfineToForm; // 폼 내로 제한하는 버튼
    private Button btnReleaseToScreen; // 제한을 해제하는 버튼

    private void ConfineCursorToForm_Click(object sender, EventArgs e)
    {
        // 현재 폼 영역 내에서만 마우스 커서가 움직이도록 제한합니다.
        Cursor.Clip = new Rectangle(this.Location, this.Size);
        MessageBox.Show("마우스 커서가 폼 내로 제한되었습니다.", "알림");
    }

    private void ReleaseCursorToScreen_Click(object sender, EventArgs e)
    {
        // 마우스 커서 제한을 해제하고 기본 전체 화면 영역으로 되돌립니다.
        Cursor.Clip = Screen.PrimaryScreen.Bounds; // 주 모니터 전체 영역으로 설정
        // 또는 Cursor.Clip = Rectangle.Empty; 를 사용하여 제한을 완전히 해제할 수도 있습니다.
        MessageBox.Show("마우스 커서 제한이 해제되었습니다.", "알림");
    }
}

1.3 마우스 조작의 실제 응용

① 마우스 커서 숨기기/표시

때때로 마우스 커서를 완전히 숨기거나 다시 표시해야 할 경우가 있습니다(예: 풀스크린 비디오 재생 중). user32.dll의 ShowCursor 함수를 사용하여 이 작업을 수행할 수 있습니다. true를 전달하면 커서가 표시되고, false를 전달하면 숨겨집니다. 이 함수는 커서의 참조 횟수를 증가/감소시키므로, 여러 번 호출될 경우 ShowCursor(true) 호출 횟수와 ShowCursor(false) 호출 횟수가 일치해야 합니다.

using System;
using System.Runtime.InteropServices;
using System.Windows.Forms;

public partial class ToggleCursorVisibilityForm : Form
{
    [DllImport("user32.dll")]
    private static extern int ShowCursor(bool bShow); // 커서 표시 카운트를 반환

    public ToggleCursorVisibilityForm()
    {
        InitializeComponent();
    }

    private Button btnHideCursor; // 커서 숨기기 버튼
    private Button btnShowCursor; // 커서 표시 버튼

    private void HideCursorButton_Click(object sender, EventArgs e)
    {
        // 마우스 커서를 숨깁니다. (내부적으로 참조 카운터 감소)
        ShowCursor(false);
        MessageBox.Show("마우스 커서가 숨겨졌습니다.", "알림");
    }

    private void ShowCursorButton_Click(object sender, EventArgs e)
    {
        // 마우스 커서를 표시합니다. (내부적으로 참조 카운터 증가)
        ShowCursor(true);
        MessageBox.Show("마우스 커서가 표시되었습니다.", "알림");
    }
}

② 폼 더블 클릭으로 Tab 키 동작 시뮬레이션

폼을 더블 클릭하는 동작을 통해 키보드의 Tab 키를 누르는 것과 동일한 효과를 발생시킬 수 있습니다. 이는 주로 사용자 인터페이스에서 포커스를 다음 컨트롤로 이동시키는 데 사용될 수 있습니다. SendKeys.Send 메서드를 활용합니다.

using System;
using System.Windows.Forms;

public partial class TabSimulationForm : Form
{
    public TabSimulationForm()
    {
        InitializeComponent();
        this.DoubleClick += new EventHandler(TabSimulationForm_DoubleClick);
    }

    private void TabSimulationForm_DoubleClick(object sender, EventArgs e)
    {
        // 현재 포커스된 컨트롤에서 다음 컨트롤로 포커스를 이동하기 위해 Tab 키를 전송합니다.
        SendKeys.Send("{TAB}");
        // 대문자 TAB 또는 소문자 tab 모두 작동합니다.
    }
}

③ 마우스를 이용한 그리기

마우스를 사용하여 폼 위에 직접 선을 그리는 기능은 그래픽 편집기나 주석 도구 등에서 활용됩니다. MouseDown 이벤트에서 그리기를 시작하고, MouseMove 이벤트 동안 마우스 이동 경로를 따라 선을 그리며, MouseUp 이벤트에서 그리기를 중단합니다. Graphics 객체와 Pen 객체를 사용하여 선의 색상과 두께를 정의할 수 있습니다.

using System;
using System.Drawing;
using System.Windows.Forms;

public partial class DrawingForm : Form
{
    private bool isDrawing = false;
    private Point lastMousePosition;
    private Pen drawingPen = new Pen(Color.Red, 3); // 펜 색상과 두께 변경

    public DrawingForm()
    {
        InitializeComponent();
        this.MouseDown += new MouseEventHandler(DrawingForm_MouseDown);
        this.MouseMove += new MouseEventHandler(DrawingForm_MouseMove);
        this.MouseUp += new MouseEventHandler(DrawingForm_MouseUp);
    }

    private void DrawingForm_MouseDown(object sender, MouseEventArgs e)
    {
        if (e.Button == MouseButtons.Left) // 왼쪽 마우스 버튼을 눌렀을 때만 그리기 시작
        {
            isDrawing = true;
            lastMousePosition = e.Location; // 현재 마우스 위치를 시작점으로 저장
        }
    }

    private void DrawingForm_MouseMove(object sender, MouseEventArgs e)
    {
        if (isDrawing)
        {
            // Graphics 객체는 using 블록으로 관리하여 자동으로 Dispose 되게 함
            using (Graphics g = this.CreateGraphics()) 
            {
                g.DrawLine(drawingPen, lastMousePosition, e.Location);
            }
            lastMousePosition = e.Location; // 다음 선을 그릴 시작점을 현재 위치로 업데이트
        }
    }

    private void DrawingForm_MouseUp(object sender, MouseEventArgs e)
    {
        isDrawing = false;
        // 그리기 완료 후 폼을 새로 고치지 않으면, 다른 창에 가려졌다 다시 나타날 때 그려진 선들이 사라질 수 있습니다.
        // 영구적으로 그리려면 폼의 Paint 이벤트에서 다시 그려야 합니다. 여기서는 임시적인 그리기를 보여줍니다.
    }
}

④ 폼을 항상 다른 창 위에 유지

특정 폼을 다른 모든 창 위에 항상 표시되도록 설정할 수 있습니다. 이는 유틸리티, 미디어 플레이어 또는 특정 정보 표시 애플리케이션에서 유용합니다. TopMost 속성을 true로 설정하며, 필요에 따라 작업 표시줄에 폼을 표시하지 않도록 ShowInTaskbar 속성을 false로 설정할 수도 있습니다.

using System;
using System.Windows.Forms;

public partial class AlwaysOnTopForm : Form
{
    public AlwaysOnTopForm()
    {
        InitializeComponent();
        this.Load += new EventHandler(AlwaysOnTopForm_Load);
    }

    private void AlwaysOnTopForm_Load(object sender, EventArgs e)
    {
        // 폼이 항상 다른 창들 위에 표시되도록 설정합니다.
        this.TopMost = true;

        // 선택 사항: 폼을 Windows 작업 표시줄에 표시하지 않도록 설정합니다.
        this.ShowInTaskbar = false; 
    }
}