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.

Platforms

Win32, x64.

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);
   screenCapture.SetBitmap(&LeadBitmap);
   // 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;
}