LScreenCapture::SetCaptureOptionDlg

#include "ltwrappr.h"

virtual L_INT LScreenCapture::SetCaptureOptionDlg(hParentWnd, uFlags)

HWND hParentWnd;

/* handle to the parent window */

L_UINT uFlags;

/* flags to determine function behavior */

Brings up the capture option dialog box and sets the capture options.

Parameter

Description

hParentWnd

Handle to the parent window of the capture option dialog box

uFlags

Flags that determine the options dialog. Possible values are:

 

Value

Meaning

 

NONE

[0x0000] No "?" help button will be shown.

 

SCRDLG_SETCAPTUREOPTION_CONTEXTHELP

[0x0001] Capture options dialog context help.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

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:

Class Members, LScreenCapture::ScreenCaptureHelpCallBack

Example

// ScreenCapture Help Callbacks
class LUserScreenCapture : public LScreenCapture
{
   HWND m_hWnd;
public:
   LUserScreenCapture(HWND hWnd){m_hWnd = hWnd;}
   virtual ~LUserScreenCapture(){};
   virtual L_VOID ScreenCaptureHelpCallBack(L_UINT32 uFlag, L_INT nCtlID);
};
// This callback will be called once the help button is pressed
L_VOID  LUserScreenCapture::ScreenCaptureHelpCallBack(L_UINT32 uFlag, L_INT nCtlID)
{
   UNREFERENCED_PARAMETER(uFlag);
   UNREFERENCED_PARAMETER(nCtlID);
   //
   // set your code here...
   //
}
L_INT LScreenCapture__SetCaptureOptionDlgExample(HWND hWnd)
{
   L_INT nRet;
   HDC hDC;
   RECT rcClientRect;
   LBitmap LeadBitmap;
   LUserScreenCapture screenCapture(hWnd);
   screenCapture.EnableCallBack(TRUE);
   // display a dialog to select capture options
   nRet = screenCapture.SetCaptureOptionDlg(hWnd, SCRDLG_SETCAPTUREOPTION_CONTEXTHELP);
   if(nRet == SUCCESS)
   {
      // capture ActiveWindow- HotKey = F11
      // Press the hotkey after calling the function to activate capture
      nRet = screenCapture.CaptureActiveWindow();
      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;
   return SUCCESS;
}