CopyRubberbandDIB Method

Description

Creates a copy of the current DIB bounded by the current rubberband.

Syntax

Visual Basic
Public Function CopyRubberbandDIB() As Long

Return Type

This method returns the global handle to the copied DIB. If the method fails, the return value is zero.

Remarks

This method will fail if a rubberband does not exist or if the new DIB could not be created. The DIB is typically assigned to the hDIB of another ImagXpress control.

Note that the receiver is responsible for freeing the DIB by issuing a GlobalFree on the DIB Handle. If the receiver is an ImagXpress control with the OwnDib property set to true, there is no need to issue the GlobalFree as ImagXpress does this for you.