CopyDIB64 Method

Description

Creates a copy of the current DIB for 64-bit.

Syntax

Visual Basic
Public Function CopyDIB64() As __int64

Return Type

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

Remarks

This method is intended for 64-bit environments; use this instead of the CopyDIB.

This method does not work with high-gray images as high-gray images cannot be DIBs by definition. Instead, use the CopyImage method to copy high-gray images.

If this method fails, in addition to the return value being zero, the ImagError property will have one of the following values: IX_Error_MemoryAlloc, IX_Error_NoImage, IX_Error_InvalidFormat, or IX_Error_NoCurrentBuffer.

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.