wx.MetafileDC

This is a type of device context that allows a metafile object to be created (Windows only), and has most of the characteristics of a normal ** wx.DC ** .

The wx.MetafileDC.Close member must be called after drawing into the device context, to return a metafile. The only purpose for this at present is to allow the metafile to be copied to the clipboard (see wx.Metafile).

Adding metafile capability to an application should be easy if you already write to a wx.DC; simply pass the wx.MetafileDC to your drawing function instead. You may wish to conditionally compile this code so it is not compiled under X (although no harm will result if you leave it in).

Note that a metafile saved to disk is in standard Windows metafile format, and cannot be imported into most applications. To make it importable, call the function wx.MakeMetafilePlaceable after closing your disk-based metafile device context.

See also

wx.Metafile, wx.DC

Class Hierarchy

Inheritance diagram for class MetafileDC:

Methods Summary

__init__	Constructor.
Close	This must be called after the device context is finished with.

Class API

class wx.MetafileDC(DC)

Possible constructors:

MetafileDC(filename="")

This is a type of device context that allows a metafile object to be created (Windows only), and has most of the characteristics of a normal DC.

Methods

__init__(self, filename="")

Constructor.

If no filename is passed, the metafile is created in memory.

Parameters:

filename (string) –

---

Close(self)

This must be called after the device context is finished with.

A metafile is returned, and ownership of it passes to the calling application (so it should be destroyed explicitly).

Return type:

wx.Metafile