DOCERR: List of Functions That Are Valid in Metafiles

 Last reviewed: July 23, 1997
Article ID: Q84984
3.00 3.10 WINDOWS kbprg kbdocerr

The information in this article applies to:

  • Microsoft Windows Software Development Kit (SDK) for Windows versions 3.1 and 3.0

SUMMARY

Pages 2-41 and 2-42 of the "Microsoft Windows Software Development Kit (SDK) Reference Volume 1" for version 3.0 list the subset of Windows GDI functions that an application can use in a metafile under Windows 3.0. The list printed in the manual is incorrect.

Page 107 of the "Microsoft Windows Software Development Kit: Programmer's Reference, Volume 1: Overview," lists the functions that are valid in a metafile for Windows 3.1. This list is incomplete.

This article provides a corrected list of functions that an application can use in a metafile under Windows 3.1.

MORE INFORMATION

The following list of functions that are valid in a Windows 3.1 metafile is taken from page 107 of the "Windows SDK: Programmer's Reference, Volume 1: Overview": 

AnimatePalette           OffsetViewportOrg   SetBkMode
Arc                      OffsetWindowOrg     SetDIBitsToDevice
BitBlt                   PatBlt              SetMapMode
Chord                    Pie                 SetMapperFlags
CreateBrushIndirect      Polygon             SetPixel
CreateDIBPatternBrush    Polyline            SetPolyFillMode
CreateFontIndirect       PolyPolygon         SetROP2
CreatePatternBrush       RealizePalette      SetStretchBltMode
Ellipse                  RestoreDC           SetTextColor
Escape                   RoundRect           SetTextJustification
ExcludeClipRect          SaveDC              SetViewportExt
ExtTextOut               ScaleViewportExt    SetViewportOrg
FloodFill                ScaleWindowExt      SetWindowExt
IntersectClipRect        SelectClipRgn       SetWindowOrg
LineTo                   SelectObject        StretchBlt
MoveTo                   SelectPalette       StretchDIBits
OffsetClipRgn            SetBkColor          TextOut
The following table lists additional functions that are valid in a metafile under Windows 3.1: 

CreateDIBitmap           CreateSolidBrush    Rectangle
CreateFont               DeleteObject        ResizePalette
CreateHatchBrush         ExtFloodFill        SetPaletteEntries
CreatePalette            FillRgn             SetTextAlign
CreatePen                InvertRgn           SetTextCharacterExtra
CreatePenIndirect        PaintRgn
Although the following functions might function correctly in a metafile, they should not be used in a metafile: 

AbortDoc                 EndPage             StartPage
EndDoc                   StartDoc            ResetDC
Windows has a number of functions that are not supported in metafiles directly because they are used to put an object into a metafile. The region functions are a common example of this function category. An application can create an arbitrary region, either directly or by combining existing regions. When an application selects the handle to the region into a metafile DC (display context), Windows records a CREATEREGION record into the metafile.

An application can select a bitmap into a memory DC that is compatible with the display (not directly into the metafile), and then then call the BitBlt function to move the bitmap from the memory DC into the metafile DC. Windows saves the bitmap image in the metafile as a DIB (device-independent bitmap).

For more information, please refer to the online documentation for the Windows SDK or pages 106-109 of the "Windows SDK: Programmer's Reference, Volume 1: Overview" for version 3.1 manual.

* As a general rule, a metafile should be as device-independent as possible. Therefore, an application should not record into a metafile a GDI function that requires device units. Such functions include BitBlt, FillRgn, SetViewportExt, and SetViewportOrg.

Additional reference words: 3.00 3.10 docerr
KBCategory: kbprg kbdocerr
KBSubcategory: GdiMeta
Keywords : kb16bitonly

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: July 23, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.