LScreenCapture::SetCaptureAreaOptions

#include "ltwrappr.h"

virtual L_INT LScreenCapture::SetCaptureAreaOptions(pCaptureAreaOption)

pLEADCAPTUREAREAOPTION pCaptureAreaOption;

/* pointer to a LEADCAPTUREAREAOPTION structure */

Sets options for capturing an area.

Parameter

Description

pCaptureAreaOption

Pointer to a LEADCAPTUREAREAOPTION structure.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

Use this function to change the current area image capture options. For information on the default option settings, refer to LEADCAPTUREAREAOPTION.

Required DLLs and Libraries

LTDIS
LTSCR

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

LScreenCapture::GetCaptureAreaOptions, Class Members

Example

L_INT LScreenCapture__SetCaptureAreaOptionsExample(HWND hWnd)
{
   L_INT nRet;
   HDC hDC;
   RECT rcClientRect;
   LBitmap LeadBitmap;
   LScreenCapture screenCapture(&LeadBitmap);
   LEADCAPTUREAREAOPTION CaptureAreaOptions;
   nRet = screenCapture.GetCaptureAreaOptions(&CaptureAreaOptions);
   if(nRet == SUCCESS)
   {
      // Set capture area to Triangle type
      CaptureAreaOptions.uAreaType = CAPTURE_AREA_TRIANGLE;
      nRet = screenCapture.SetCaptureAreaOptions(&CaptureAreaOptions);
      if(nRet == SUCCESS)
      {
         // Current area will be captured using new settings
         nRet = screenCapture.CaptureArea();
         if(nRet == SUCCESS)
         {
            hDC = GetDC(hWnd);
            GetClientRect(hWnd, &rcClientRect);
            LeadBitmap.Paint()->SetDC(hDC);
            nRet = LeadBitmap.SetDstRect(&rcClientRect);
            if(nRet != SUCCESS)
               return nRet;
            nRet = LeadBitmap.Paint()->PaintDC();
            if(nRet != SUCCESS)
               return nRet;
            ReleaseDC(hWnd, hDC);
         }
         else
            return nRet;
      }
      else
         return nRet;
   }
   else
      return nRet;
   return SUCCESS;
}