LEADTOOLS Forms (Leadtools.Forms.DocumentWriters assembly)

EmfHandle Property

Show in webframe







The Windows Enhanced Meta File handle representation of the page.
Syntax
public IntPtr EmfHandle {get; set;}
'Declaration
 
Public Property EmfHandle As IntPtr
'Usage
 
Dim instance As DocumentPage
Dim value As IntPtr
 
instance.EmfHandle = value
 
value = instance.EmfHandle
public IntPtr EmfHandle {get; set;}

            

            
 
get_EmfHandle();
set_EmfHandle(value);
Object.defineProperty('EmfHandle');
public:
property IntPtr EmfHandle {
   IntPtr get();
   void set (    IntPtr value);
}

Property Value

An System.IntPtr structure that contains the unmanaged handle to the Windows Enhanced Meta File object.
Remarks

The EmfHandle property must contain a valid Windows Enhanced Meta File handle (EMF)--it cannot be IntPtr.Zero. This EMF handle is used in the DocumentWriter.AddPage method to create the visual representation of the new page added to the document being created.

The LEADTOOLS Document Writer toolkit will not use the EmfHandle after the call to DocumentWriter.AddPage returns. This handle needs to be deleted to free the resources associated with it (for example, using the Windows API DeleteEnhMetaFile).

The Windows Enhanced Meta File (EMF) objects can be obtained from various sources as shown in the following list:

The Dots/Inch (DPI) of the page is the same as the DPI stored in the EmfHandle property. Therefore, to create a page with 300 DPI, you must add a document page with an EMF that has a DPI of 300 (both horizontally or vertically although the LEADTOOLS Document Writer supports different values for the DPI). When using the PDF with image and text feature, set the DPI of the Leadtools.RasterImage object to the same DPI as the EMF handle using the RasterImage.XResolution and RasterImage.YResolution properties.

The LEADTOOLS Document Writer supports creating documents with zero or more empty pages inside them. Simply add a page with the DocumentPage.EmfHandle property set to the default value of IntPtr.Zero and call the DocumentWriter.AddPage method. The dimension of the empty page must be set before hand in the DocumentOptions.EmptyPageWidth and DocumentOptions.EmptyPageHeight and its resolution set to DocumentOptions.EmptyPageResolution. As many empty pages as desired can be added and in any index desired. To use empty pages, make sure the DocumentOptions.PageRestriction property is set to DocumentPageRestriction.Relaxed.

Example
For an example, refer to DocumentWriter.
Requirements

Target Platforms

See Also

Reference

DocumentPage Structure
DocumentPage Members
DocumentWriter Class
DocumentFormat Enumeration
Programming with LEADTOOLS Document Writers
Files to be Included with Your Application
Unlocking Special LEAD Features

 

 


Products | Support | Contact Us | Copyright Notices
© 2006-2014 All Rights Reserved. LEAD Technologies, Inc.

Leadtools.Forms.DocumentWriters requires a Document or Medical toolkit license and unlock key. For more information, refer to: Imaging Pro/Document/Medical Features