MetafileHeader class

Applies to: desktop apps only

A MetafileHeader object stores properties of an associated metafile.

MetafileHeader has these types of members:

Methods

The MetafileHeader class has these methods.

MethodDescription
MetafileHeader::GetBounds

The MetafileHeader::GetBounds method gets the bounding rectangle for the associated metafile.

MetafileHeader::GetDpiX

The MetafileHeader::GetDpiX method gets the horizontal dots per inch of the associated metafile.

MetafileHeader::GetDpiY

The MetafileHeader::GetDpiY method gets the vertical dots per inch of the associated metafile.

MetafileHeader::GetEmfHeader

The MetafileHeader::GetEmfHeader method gets an ENHMETAHEADER3 structure that contains properties of the associated metafile.

MetafileHeader::GetEmfPlusFlags

The MetafileHeader::GetEmfPlusFlags method gets a flag that indicates whether the associated metafile was recorded against a video display device context.

MetafileHeader::GetMetafileSize

The MetafileHeader::GetMetafileSize method gets the size, in bytes, of the metafile.

MetafileHeader::GetType

The MetafileHeader::GetType method gets the type of the associated metafile.

MetafileHeader::GetVersion

The MetafileHeader::GetVersion method gets the version of the metafile.

MetafileHeader::GetWmfHeader

The MetafileHeader::GetWmfHeader method gets a METAHEADER structure that contains properties of the associated metafile.

MetafileHeader::IsDisplay

The MetafileHeader::IsDisplay method determines whether the associated metafile was recorded against a video display device context.

MetafileHeader::IsEmf

The MetafileHeader::IsEmf method determines whether the associated metafile is in the EMF format.

MetafileHeader::IsEmfOrEmfPlus

The MetafileHeader::IsEmfOrEmfPlus method determines whether the associated metafile is in either the EMF or EMF+ format.

MetafileHeader::IsEmfPlus

The MetafileHeader::IsEmfPlus method determines whether the associated metafile is in the EMF+ format.

MetafileHeader::IsEmfPlusDual

The MetafileHeader::IsEmfPlusDual method determines whether the associated metafile is in the EMF+ Dual format.

MetafileHeader::IsEmfPlusOnly

The MetafileHeader::IsEmfPlusOnly method determines whether the associated metafile is in the EMF+ Only format.

MetafileHeader::IsWmf

The MetafileHeader::IsWmf method determines whether the associated metafile is in the WMF format.

MetafileHeader::IsWmfPlaceable

The MetafileHeader::IsWmfPlaceable method determines whether the associated metafile is a placeable metafile.

 

Data Members

The following table lists the members exposed by the MetafileHeader object.

Data MembersTypeDescription
DpiXREALHorizontal resolution, in dots per inch, of the image stored in the associated metafile.
DpiYREALVertical resolution, in dots per inch, of the image stored in the associated metafile.
EmfPlusFlagsUINTValue that specifies the EMF+ flags associated with the metafile.
EmfPlusHeaderSizeINTSize, in bytes, of the EMF+ header.
HeightINTHeight, in pixels, of the image stored in the associated metafile.
LogicalDpiXINTLogical horizontal resolution, in dots per inch, of the image stored in the associated metafile.
LogicalDpiYINTLogical vertical resolution, in dots per inch, of the image stored in the associated metafile.
SizeUINTSize, in bytes, of the associated metafile.
TypeMetafileTypeElement of the MetafileType enumeration that specifies the type of the associated metafile.
VersionUINTVersion of the associated metafile.
WidthINTWidth, in pixels, of the image stored in the associated metafile.
XINTLeftmost coordinate of the image stored in the associated metafile.
YINTTopmost coordinate of the image stored in the associated metafile.
{WmfHeader, EmfHeader}unionTypes are METAHEADER and ENHMETAHEADER3 respectively.

 

Remarks

Metafiles provide a device-independent and application-independent way to share pictures. They contain records that describe a sequence of graphics APIs to invoke in a particular order with their associated graphics data. Metafiles can be recorded by an application and later played back by that application or by another one to reproduce a particular picture. They can also be used to send content to a print spooler. Enhanced metafiles support the ability to provide both Windows GDI+ and Windows Graphics Device Interface (GDI) descriptions of the same picture so that both GDI+ and down-level GDI applications can render it.

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.