BB FlashBack SDK: FBEditor

DrawCurrentFrame

Description

Draws a bitmap of the current frame into a device context.

Similar to CopyCurrentFrame, but does not use the DrawMouseCursor property to determine cursor visibility.

This method is accessible to the Pro and Advanced editions of the SDK only.
 

Syntax

[C#/C++]
public Bool DrawCurrentFrame (long hDC, Bool DrawCursor)

[VB.NET]
Public Function DrawCurrentFrame(ByVal hDC As Long, ByVal DrawCursor As Boolean) As Boolean
 

Parameters

hDC (in) : handle to device context to draw the frame into

DrawCursor (in) : set to true to draw the cursor, or false to omit the cursor

Return Values

The method returns True is successful, False if not.
 

Remarks

The device context should be created as a display device, and a suitable bitmap created and selected into the device context before passing the DC handle to DrawCurrentFrame.

I.e. the C++ code could look something like this:

 

hdc = CreateDC (TEXT("DISPLAY"),null,null,null);

hbmp = CreateBitmap(...); // suitable size and color format

SelectObject(hdc, hbmp);

Editor->DrawCurrentFrame(hdc, True);
 

or this would copy the frame image to a window.

 

// the window defined by hwnd will receive the image
hdc = GetDC(hwnd);

Editor->DrawCurrentFrame(hdc, True);