ScnLib_SelectCaptureRegion()

ScnLib_SelectCaptureRegion()

标准版专业版超级版游戏版
C++ __declspec(dllimport) BOOL __stdcall ScnLib_SelectCaptureRegion(long *left, long *top, long *right, long *bottom, HWND *pHWND); ✘✔✔✔
C# [DllImport("ScnLib.dll")] public static extern bool ScnLib_SelectCaptureRegion(ref int left, ref int top, ref int right, ref int bottom, ref IntPtr Wnd);
Basic Public Declare Function ScnLib_SelectCaptureRegion Lib "ScnLib.dll" (ByRef left As Int32, ByRef top As Int32, ByRef right As Int32, ByRef bottom As Int32, ByRef Wnd As IntPtr) As Boolean
Delphi function ScnLib_SelectCaptureRegion(var left: Integer; var top: Integer; var right: Integer; var bottom: Integer; var Wnd: THandle): LongBool; stdcall; external 'ScnLib.dll';
  • 描述
    显示一个界面，让用户在屏幕上选择一个窗口或一个矩形区域。

  • 参数
    • left [out]
      屏幕选区矩形左上角的 x 坐标（以像素为单位）。
    • top [out]
      屏幕选区矩形左上角的 y 坐标（以像素为单位）。
    • right [out]
      屏幕选区矩形右下角的 x 坐标（以像素为单位）。
    • bottom [out]
      屏幕选区矩形右下角的 y 坐标（以像素为单位）。
    • Wnd [out]
      如果用户点击了一个窗口，则设置为选定的窗口句柄。如果用户按住鼠标左键并拖动一个矩形来选择屏幕上的任意区域，则它将被设置为零值。
      • 实际屏幕选区不包括矩形的右边界和底边界。
  • 返回值
    如果成功选择了一个窗口或矩形区域，则返回值为 TRUE。如果用户取消了选择，则返回值为 FALSE。

  • 备注
    通常用户会更希望录制屏幕上的一个窗口或一个矩形区域，因此您可能需要提供一个界面让用户轻松选择他们想要在屏幕上录制的位置。如果你不想自己去实现这样的接口，你就可以调用这个函数来利用SDK内置的屏幕区域选取接口。调用该函数后，整个桌面会变暗，鼠标光标所指向的窗口会高亮，您可以将鼠标光标移动到您的目标窗口，然后单击鼠标左键选择该窗口。或者，如果要选择任意矩形，可以将鼠标光标移动到目标矩形的左上角，然后按下鼠标左键，按住它并将鼠标光标移动到目标矩形的右下角，然后释放鼠标左键以完成选择。您可以随时单击鼠标右键或按 ESC 取消选择。并且屏幕右下角或右上角会有放大镜显示，可以帮助您精确选择矩形。您可以将选定的矩形坐标传递给 ScnLib_SetCaptureRegion() 以设置录制区域，或将其传递给 ScnLib_TakeScreenshotA/W() 以截取该区域图像。如果你得到一个选定的窗口句柄，你可以将它传递给 ScnLib_SetCaptureWnd() 来绑定捕获窗口。

  • 参见
    ScnLib_SetCaptureWnd(), ScnLib_SetCaptureRegion(), ScnLib_GetCaptureRegion(), ScnLib_ShowCaptureRegionFrame(), ScnLib_GetCaptureRegionFrameWnd(), ScnLib_TakeScreenshotA/W()

下载 SDK API 总览