DeleteMetaFile

  BOOL DeleteMetaFile(hmf)    
  HMETAFILE hmf;    

The DeleteMetaFile function invalidates the handle that identifies a windows-format metafile.

Parameters

hmf

Identifies a windows-format metafile.

Return Value

The return value is TRUE if the function was successful. Otherwise, it is FALSE.

Comments

This function is provided for compatibility purposes only. A windows-format metafile does not support the new curve, path, and transformation functions such as PolyBezier, BeginPath, and SetWorldTransform. Applications that use these new functions and use metafiles to store pictures created by these functions should call the enhanced-format metafile-functions instead.

If the metafile identified by hmf is stored in memory (rather than on disk), its contents will be lost when DeleteMetaFile is called.

An application can convert a windows-format metafile into a enhanced-format metafile by calling the SetWinMetaFileBits function.

See Also

GetMetaFile, CreateMetaFile, CopyMetaFile, SetWinMetaFileBits