setcapture

“setcapture”是MATLAB中的一个命令，用于捕获当前图形窗口的图像。

在Windows编程中，SetCapture和ReleaseCapture是两个常用的API函数，它们主要用于处理鼠标捕获和释放，这两个函数通常用于实现窗口的拖动功能，或者在应用程序中实现自定义的鼠标捕获区域，本文将详细介绍这两个函数的用法和原理。

SetCapture函数

1、函数原型

BOOL SetCapture(HWND hWnd);

2、参数说明

hWnd：要捕获鼠标的窗口句柄，如果此参数为NULL，则表示取消当前线程的鼠标捕获。

3、返回值

如果函数成功，返回值为非零；如果函数失败，返回值为零，若要获取更多的错误信息，可以调用GetLastError函数。

4、使用示例

include <windows.h>
LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM);
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, PSTR szCmdLine, int iCmdShow)
{
    static TCHAR szAppName[] = TEXT("MouseCapture");
    HWND hwnd;
    MSG msg;
    WNDCLASS wndclass;
    wndclass.style = CS_HREDRAW | CS_VREDRAW;
    wndclass.lpfnWndProc = WndProc;
    wndclass.cbClsExtra = 0;
    wndclass.cbWndExtra = 0;
    wndclass.hInstance = hInstance;
    wndclass.hIcon = LoadIcon(NULL, IDI_APPLICATION);
    wndclass.hCursor = LoadCursor(NULL, IDC_ARROW);
    wndclass.hbrBackground = (HBRUSH)(COLOR_WINDOW + 1);
    wndclass.lpszMenuName = NULL;
    wndclass.lpszClassName = szAppName;
    if (!RegisterClass(&wndclass))
    {
        MessageBox(NULL, TEXT("This program requires Windows NT!"), szAppName, MB_ICONERROR);
        return 0;
    }
    hwnd = CreateWindow(szAppName, TEXT("Mouse Capture Example"),
                        WS_OVERLAPPEDWINDOW, CW_USEDEFAULT, CW_USEDEFAULT,
                        CW_USEDEFAULT, CW_USEDEFAULT, NULL, NULL, hInstance, NULL);
    ShowWindow(hwnd, iCmdShow);
    UpdateWindow(hwnd);
    while (GetMessage(&msg, NULL, 0, 0))
    {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }
    return msg.wParam;
}
LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
{
    switch (message)
    {
    case WM_LBUTTONDOWN:
        SetCapture(hWnd); // 设置鼠标捕获到窗口句柄为hWnd的窗口上
        return 0;
    case WM_RBUTTONDOWN:
        ReleaseCapture(); // 释放鼠标捕获，恢复到默认状态（整个屏幕）
        return 0;
    case WM_DESTROY:
        PostQuitMessage(0);
        return 0;
    }
    return DefWindowProc(hWnd, message, wParam, lParam);
}

ReleaseCapture函数

1、函数原型

BOOL ReleaseCapture();

2、参数说明无，该函数没有参数。

3、返回值同SetCapture函数，如果函数成功，返回值为非零；如果函数失败，返回值为零，若要获取更多的错误信息，可以调用GetLastError函数。