LoadMetafile Method

Summary

Loads the specified RTF file as a Windows Enhanced Metafile.

Syntax

C++/CLI

Python

public IntPtr LoadMetafile( 
   string fileName, 
   int pageNumber 
)

public: 
IntPtr LoadMetafile(  
   String^ fileName, 
   int pageNumber 
)

def LoadMetafile(self,fileName,pageNumber):

Parameters

fileName
The source RTF file.

pageNumber
The 1-based page number to load.

Return Value

The Windows Enhanced Metafile this method creates.

Remarks

This method uses the following members of the current CodecsRasterizeDocumentLoadOptions set in RasterCodecs.Options.RasterizeDocument.Load to determine the page size, resolution and margins:

Also, it uses the following members of the current CodecsRtfLoadOptions set in RasterCodecs.Options.Rtf.Load to determine the back color to use:

CodecsRtfLoadOptions.BackColor

So you must set these options according to your application needs before calling this method. The number of pages inside the RTF file will depend on the Rasterize Document options.

You must destroy the Windows Enhanced Metafile (EMF) handle this method creates manually using the DeleteEnhMetaFile Windows API.

Example

using Leadtools; 
using Leadtools.Codecs; 
 
using Leadtools.ImageProcessing.Core; 
 
[DllImport("Gdi32")] 
private static extern int DeleteEnhMetaFile(IntPtr hemf); 
 
public void LoadRtfAsMetafileExample() 
{ 
   RasterCodecs codecs = new RasterCodecs(); 
 
   string srcFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1.rtf"); 
 
   // Load the source file as a metafile 
   IntPtr hemf = codecs.Options.Rtf.LoadMetafile(srcFileName, 1); 
 
   if (hemf != IntPtr.Zero) 
   { 
      // Use the metafile here 
 
      // Finally, delete it using the Windows API 
      DeleteEnhMetaFile(hemf); 
   } 
 
   // Clean up 
   codecs.Dispose(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS22\Resources\Images"; 
}

Requirements

Target Platforms

Reference

CodecsRtfOptions Class

CodecsRtfOptions Members

Download our FREE evaluation

Help Version 22.0.2023.5.5

Leadtools.Codecs Assembly

Introduction

Getting Started

Namespaces

Leadtools.Codecs Namespace

Assemblies