LVectorBase::ConvertToWMF

Summary

Converts a LEAD Technologies vector handle into a Windows metafile (WMF). When this function is completed, there are two copies of the drawing in memory: the WMF and the original LEAD vector. Freeing one will not affect the other.

Syntax

virtual L_INT LVectorBase::ConvertToWMF(hdc, phMetaFile, uDPI, pRect = NULL)

Parameters

HDC hdc

Handle to the device context responsible for the conversion.

HMETAFILE *phMetaFile

Pointer to a metafile handle to be updated with the converted vector.

L_UINT uDPI

Dots per inch that should be used to do the conversion.

const RECT *pRect

Pointer to a RECT structure that contains the dimensions, in .01 millimeter units, of the drawing to be stored in the metafile. If this parameter is NULL, the vector toolkit computes the dimensions of the smallest rectangle that bounds the vector drawing. This parameter should be provided whenever possible.

Returns

Comments

This function allocates a WMF handle and copies the LEAD vector to the WMF.

If this function is called with pRect containing these values:

pRect->left = 0;   
pRect->top = 0;   
pRect->right = 1000;   
pRect->bottom = 1000; 

the vector drawing will be converted to an WMF file with logical size 0 to 10 mm. in width and height.

This is very helpful when printing. For example, determine the printers printable area in millimeters. Divide that value by 100 and pass the resulting value as the right and bottom members of the RECT structure. The resulting WMF will have the same logical size as the printer, resulting in high image quality when printing the WMF file.

Required DLLs and Libraries

• LTVKRN
• For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions

• LVectorBase::ConvertFromEMF
• LVectorBase::ConvertToEMF
• LVectorBase::ConvertFromWMF

Topics

• Vector Conversion
• Vector Images: Converting/Changing Metafiles

Example

L_INT LVectorBase__ConvertToWMFExample( HWND hWnd, L_TCHAR *pszFile, HMETAFILE& hWMF) 
{ 
   L_INT          nRet; 
   LVectorBase    Vector; 
   HDC            hDC; 
 
   //Load the drawing  
   nRet = Vector.Load(pszFile); 
   if(nRet != SUCCESS) 
      return nRet; 
 
   //Convert to EMF  
   hDC = GetDC( hWnd ); 
 
   nRet = Vector.ConvertToWMF(hDC, &hWMF, 96); 
   if(nRet != SUCCESS) 
      return nRet; 
 
   ReleaseDC( hWnd, hDC ); 
 
   return SUCCESS; 
}