ClipHdib 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 ClipHdib( _
   ByVal workspace As FormDirector, _
   ByVal fullImageHdib As IntPtr _
) As IntPtr

'Usage
 
Dim instance As Field
Dim workspace As FormDirector
Dim fullImageHdib As IntPtr
Dim value As IntPtr
 
value = instance.ClipHdib(workspace, fullImageHdib)

public IntPtr ClipHdib( 
   FormDirector workspace,
   IntPtr fullImageHdib
)

public: IntPtr ClipHdib( 
   FormDirector* workspace,
   IntPtr fullImageHdib
)

public:
IntPtr ClipHdib( 
   FormDirector^ workspace,
   IntPtr fullImageHdib
)

Parameters

workspace: An object used to set environment settings, such as debugging and licensing. See the FormDirector class for more details.
fullImageHdib: 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 HDIB 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 fullImageHdib 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
ClipHbitmap Method
ClipImage Method
Location Property