ClipHbitmap Method

Copies the pixels for a field from a full-page image into a new image.

Syntax

Visual Basic
C#
Managed Extensions for C++
C++/CLI

'Declaration
 
Public Function ClipHbitmap( _
   ByVal workspace As FormDirector, _
   ByVal fullImageHbitmap As IntPtr _
) As IntPtr

'Usage
 
Dim instance As Field
Dim workspace As FormDirector
Dim fullImageHbitmap As IntPtr
Dim value As IntPtr
 
value = instance.ClipHbitmap(workspace, fullImageHbitmap)

public IntPtr ClipHbitmap( 
   FormDirector workspace,
   IntPtr fullImageHbitmap
)

public: IntPtr ClipHbitmap( 
   FormDirector* workspace,
   IntPtr fullImageHbitmap
)

public:
IntPtr ClipHbitmap( 
   FormDirector^ workspace,
   IntPtr fullImageHbitmap
)

Parameters

workspace: An object used to set environment settings, such as debugging and licensing. See the FormDirector class for more details.
fullImageHbitmap: An image of the full form. This method will copy pixels from this image to the returned image.

Return Value

A handle to a new WIN32 HBITMAP whose width and height match the size of this field and which contains the pixels from that lie within the field. When you are finished using this image, you must delete it using the WIN32 function, DeleteObject(), or an equivalent.

Remarks

This method creates a new image whose size matches this field. It then finds the pixels in fullImageHbitmap that lie within the field and copies them to the new image.

This object has several different implementations of this method, each using a different format for the image. This allows you to work with the image format that is most convenient to you.

Reference

Field Class
Field Members
ClipBitmap Method
ClipHdib Method
ClipImage Method
Location Property