1、Standard ECMA-234December 1995Standardizing Information and Communication SystemsPhone: +41 22 849.60.00 - Fax: +41 22 849.60.01 - URL: http:/www.ecma.ch - Internet: helpdeskecma.chApplication ProgrammingInterface for WindowsVolume 1Section 1 - GeneralSection 2 - Windows SubsystemSection 3 - Graphic
2、s SubsystemStandard ECMA-234December 1995Standardizing Information and Communication SystemsPhone: +41 22 849.60.00 - Fax: +41 22 849.60.01 - URL: http:/www.ecma.ch - Internet: helpdeskecma.chGL E-234-V1.DOC 07-03-96 15,44Application ProgrammingInterface for WindowsBrief HistoryThe APIW Standard is
3、a functional specification of the Microsoft Windows 3.1 application programming interface. It is basedon existing implementations (including Microsoft and others) and behavior. The goal of writing this specification is to define anenvironment in which: applications written to this baseline will be p
4、ortable to all implementations of the APIW Standard. the interface can be enriched through open standards processes to meet current and future user needs in a timely fashion.APIW uses the current C language binding, and reflects existing coding practices to ensure that current applications willconfo
5、rm to this standard. The APIs documented in this standard shall accurately reflect existing implementations of thewindows APIs. If an application that runs with an existing implementation uses one or more APIs contrary to the way it isdescribed in the standard, the standard will be changed to accura
6、tely reflect the behavior.The APIW Standard defines a set of application programming interfaces that allow for the creation of graphical applicationsspanning a wide range of capabilities. The standard groups these APIs into major functional areas including a window managerinterface, a graphics devic
7、e interface and interfaces necessary for accessing system resources and capabilities. The APIrequirements of todays major desktop applications are reflected in this specification and are the criteria for determining theAPIW content.The APIW Standard focuses on providing the necessary APIs for writin
8、g applications for the desktop, and also allowsadditional APIs to be bound to an application. This feature enables services outside the scope of a standard desktop applicationto be provided, for example, database, networking or other system services.The APIW Standard defines the basic graphical use
9、interface objects, such as buttons, scrollbars, menus, static and editcontrols, and the painting functions to draw them, such as area fill, and line and rectangle drawing. Finally, a rich set of textroutines in defined, from simple text output to more complex text output routines using multiple foun
10、ts and font styles, allsupporting the use of color.The APIW Standard is documented in five sections, corresponding loosely to the four functional subsystems represented by theAPI and the conformance clause. The four APIW sections cover window management, graphical interface, system services andan ap
11、plication support services section. These functions cover window creation and management, graphics routines to paint textand other graphics objects in those windows, functions to access system resources such as files and timers, and finally, commonsupport functions to accelerate the development of g
12、raphical window-based applications.The APIW Window Subsystem section of the standard covers the creation, deletion and management of the window, includingwindow positioning and sizing and the sending and receiving of messages. Within each of these window managementsubsections are routines that signi
13、ficantly extend the basic functions. With window creation, there are many types of windowsthat can be created including built-in classes and user-definable classes, that have the ability to modify the style of any one ofthe built-in classes. Additional functions are defined to affect the display of
14、a window, including functions to modify thewindows menu, scrollbars, and the display of carets or cursors within the window. With multiple overlapped windows beingdisplayed simultaneously, functions are defined to manage the position and size of those windows, as well as to control thevisibility of
15、a window and its associated icon when it is minimized.The APIW Window Subsystem section also defines a set of functions for managing a subset of the user interface, referred to asdialog boxes. These functions allow for the creation and management of the dialog box, as well as the user interaction wi
16、th thedialog box up to its closure. Utility functions are defined to make designing and using a dialog box easier. These utilitiesprovide common dialog box functions, such as group boxes and check boxes, as well as file interface functions to list files anddirectories. Each of these dialog boxes are
17、 controlled by the use of dialog box templates that are stored in resource files.The APIW Graphics Subsystem section covers all aspects of actually drawing in a window. These aspects include line drawing,text output, graphics primitives, such as rectangles and ellipses, as well as more sophisticated
18、 routines such as floodfill(),bitblts() and stretchblt(). The Graphics Device Interface defines bitmaps, icons, cursors and carets, as well as functions toprovide for a portable graphics file format called metafiles. The Graphics Device Interface defines a logical coordinate space tofurther abstract
19、 the underlying hardware and has functions to map between the logical and physical coordinate space. TheGraphics Device Interface defines utility functions for all drawing routines that use pens, brushes and regions to get precisecontrol over how graphical objects will be drawn.The APIW System Servi
20、ces section defines platform-independent routines for an application to query the system environmentand access system services. System services that may be accessed include memory, timers, the keyboard and the native filesystem. There are subsections that deal with resources, device I/O and system d
21、iagnostic routines. Resource managementallows for the loading and unloading of user- and system-defined resources, such as icons, bitmaps and strings. Device I/Oincludes both parallel and serial port input and output operations. System diagnostic routines enable an application ordiagnostic tool to e
22、xamine the state of an application, including memory utilization, task information and stack usage.The APIW Application Support Function section defines miscellaneous functions that can be used by a developer in anapplication. These utility functions define built-in services that a developer does no
23、t have to rewrite with each application.These service functions include debugging routines and simple user interface routines to provide graphical feedback to a user.They also include routines for file compression and decompression, standardized routines to retrieve application versioninformation an
24、d routines to manage initialization files.Adopted as an ECMA Standard by the General Assembly of December 1995.- i -Table of contentsSection 1 - General 11 Scope 12 Conformance 13 Normative references 14 Definitions 15 Formal notations 1Section 2 - Windows Subsystem 26 CallWindowProc 27 DispatchMess
25、age 28 GetMessage, PeekMessage 29 WaitMessage 410 GetMessagePos, GetMessageTime 411 InSendMessage, ReplyMessage 412 PostAppMessage, PostMessage, PostQuitMessage 513 SendMessage 614 SetMessageQueue 615 TranslateAccelerator 716 TranslateMDISysAccel 717 TranslateMessage 818 RegisterWindowMessage 819 Ge
26、tMessageExtraInfo 920 GetQueueStatus 921 RegisterClass, UnregisterClass 1022 GetClassInfo 1123 GetClassName 1224 GetClassWord, SetClassWord 1225 GetClassLong, SetClassLong 1326 SetWindowLong 1427 CreateWindow, CreateWindowEx 1528 DestroyWindow 1929 WindowProc 2030 DefDlgProc 2031 DefFrameProc 2132 D
27、efMDIChildProc 2133 DefWindowProc 2234 GetWindowWord 2235 GetWindowLong 2336 SetWindowWord 2437 BeginDeferWindowPos 2538 EndDeferWindowPos 2639 DeferWindowPos 2640 SetWindowPos 2741 ShowWindow, IsWindowVisible 28- ii -42 ArrangeIconicWindows 2943 OpenIcon 3044 BringWindowToTop 3045 CloseWindow 3146
28、IsIconic, IsZoomed 3147 ShowOwnedPopups 3148 IsWindow 3249 IsWindowEnabled, EnableWindow 3250 GetActiveWindow, SetActiveWindow 3351 GetCapture, SetCapture, ReleaseCapture 3352 GetFocus, SetFocus 3453 GetSysModalWindow, SetSysModalWindow 3454 AnyPopup 3555 GetLastActivePopup 3556 IsChild 3657 GetPare
29、nt, SetParent 3658 GetWindow, GetTopWindow, GetNextWindow 3659 MoveWindow 3760 GetDeskTopWindow 3861 GetWindowPlacement, SetWindowPlacement 3862 AdjustWindowRect, AdjustWindowRectEx 3963 GetClientRect, GetWindowRect 4064 GetWindowText, GetWindowTextLength, SetWindowText 4065 EnumWindows, EnumWindows
30、Proc 4166 EnumChildWindows, EnumChildProc 4267 FindWindow 4268 AppendMenu, InsertMenu, ModifyMenu 4369 RemoveMenu, DeleteMenu, DestroyMenu 4470 CreateMenu, CreatePopupMenu 4471 GetMenu 4472 DrawMenuBar 4573 GetSystemMenu 4574 CheckMenuItem, EnableMenuItem, HiliteMenuItem 4575 GetMenuItemID, GetSubMe
31、nu 4676 GetMenuState, GetMenuString 4777 GetMenuItemCount 4778 GetMenuCheckMarkDimensions 4779 SetMenuItemBitmaps 4880 TrackPopupMenu 4881 SetMenu 4982 IsMenu 4983 GetScrollPos, SetScrollPos 5084 GetScrollRange, SetScrollRange 5085 ShowScrollBar 51- iii -86 ScrollWindow 5187 EnableScrollBar 5288 Scr
32、ollDC 5389 ScrollWindowEx 5390 CreateCaret, DestroyCaret 5491 GetCaretBlinkTime, SetCaretBlinkTime 5592 GetCaretPos, SetCaretPos 5593 HideCaret, ShowCaret 5694 CreateCursor, DestroyCursor 5695 LoadCursor 5796 GetCursorPos, SetCursorPos 5797 ShowCursor 5898 GetCursor, SetCursor 5899 ClipCursor 59100
33、GetClipCursor 59101 CopyCursor 59102 SetProp, GetProp 60103 RemoveProp 60104 EnumProps 60105 EnumPropsProc 61106 GetClipboardViewer 61107 SetClipboardViewer 62108 ChangeClipboardChain 62109 OpenClipboard 62110 GetOpenClipboardWindow 63111 CloseClipboard 63112 EmptyClipboard 63113 GetClipboardOwner 6
34、4114 CountClipboardFormats 64115 EnumClipboardFormats 64116 GetPriorityClipboardFormat 65117 IsClipboardFormatAvailable 65118 RegisterClipboardFormat, GetClipboardFormatName 66119 GetClipboardData, SetClipboardData 66120 CallWndProc 68121 GetMsgProc 68122 MessageProc 69123 SysMsgProc 70124 AddAtom,
35、GlobalAddAtom 70125 DeleteAtom, GlobalDeleteAtom 71126 FindAtom, GlobalFindAtom 71127 GetAtomName, GetGlobalAtomName 71128 InitAtomTable 72129 CheckDlgButton 72- iv -130 CheckRadioButton 72131 CreateDialog, CreateDialogIndirect 73132 CreateDialogParam, CreateDialogIndirectParam 73133 DialogBox, Dial
36、ogBoxIndirect 74134 DialogBoxIndirectParam, DialogBoxParam 75135 DlgDirList, DlgDirListComboBox 75136 DlgDirSelect, DlgDirSelectComboBox 76137 EndDialog 76138 GetDialogBaseUnits 77139 GetDlgCtrlID 77140 GetDlgItem 77141 GetDlgItemInt, SetDlgItemInt 78142 GetDlgItemText, SetDlgItemText 78143 GetNextD
37、lgGroupItem, GetNextDlgTabItem 79144 IsDialogMessage 79145 IsDlgButtonChecked 80146 MapDialogRect 80147 SendDlgItemMessage 80148 DlgDirSelectEx 81149 DialogProc 81150 BeginPaint 82151 EndPaint 82152 ExcludeUpdateRgn 83153 GetUpdateRect 83154 GetUpdateRgn 83155 InvertRect 84156 UpdateWindow 84157 Val
38、idateRgn, InValidateRgn 85158 RedrawWindow 85159 LockWindowUpdate 87160 GetMapMode, SetMapMode 87161 GetPolyFillMode, SetPolyFillMode 88162 GetROP2, SetROP2 88163 GetBkColor, SetBkColor 89164 GetBkMode, SetBkMode 89165 GetBoundsRect, SetBoundsRect 90166 GetCurrentPosition, GetCurrentPositionEx 90167
39、 InvalidateRect, ValidateRect 91Section 3 - Graphics Subsystem 92168 CreateCompatibleDC 92169 CreateDC, CreateIC 92170 GetDC, GetWindowDC, GetDCEx 93171 DeleteDC 94172 ReleaseDC 95- v -173 SaveDC, RestoreDC 95174 ResetDC 95175 GetDCOrg 96176 CopyIcon 96177 DrawIcon 97178 DestroyIcon 97179 CreateIcon
40、 97180 UnrealizeObject 98181 PtVisible, RectVisible 98182 SelectObject 99183 DeleteObject 100184 EnumObjects, EnumObjectsProc 100185 GetObject 101186 GetStockObject 101187 IsGDIObject 102188 AnimatePalette 102189 CreatePalette 103190 GetNearestColor, GetNearestPaletteIndex 103191 GetPaletteEntries,
41、GetSystemPaletteEntries, SetPaletteEntries 104192 GetSystemPaletteUse, SetSystemPaletteUse 104193 RealizePalette 105194 SelectPalette 105195 GetSysColors 106196 SetSysColors 107197 UpdateColors 108198 ResizePalette 108199 CreateMetaFile, CloseMetaFile 109200 CopyMetaFile 109201 DeleteMetaFile 110202
42、 EnumMetaFile, EnumMetaFileProc 110203 GetMetaFile 111204 GetMetaFileBits, SetMetaFileBits, SetMetaFileBitsBetter 111205 PlayMetaFile, PlayMetaFileRecord 112206 GetViewportExt, GetViewportExtEx 112207 GetViewportOrg, GetViewportOrgEx 113208 OffsetViewportOrg, OffsetViewportOrgEx 113209 ScaleViewport
43、Ext, ScaleViewportExtEx 114210 SetViewportExt, SetViewportExtEx 115211 SetViewportOrg, SetViewportOrgEx 115212 DPtoLP, LPtoDP 116213 GetWindowExt, GetWindowExtEx 116214 GetWindowOrg, GetWindowOrgEx 116215 OffsetWindowOrg, OffsetWindowOrgEx 117216 ScaleWindowExt, ScaleWindowExtEx 117- vi -217 SetWind
44、owExt, SetWindowExtEx 118218 SetWindowOrg, SetWindowOrgEx 118219 MapWindowPoints 119220 WindowFromPoint 119221 ChildWindowFromPoint 120222 ClientToScreen, ScreenToClient 120223 CombineRgn 121224 CreateEllipticRgn, CreateEllipticRgnIndirect 121225 CreatePolygonRgn, CreatePolyPolygonRgn 122226 CreateR
45、ectRgn, CreateRectRgnIndirect 122227 CreateRoundRectRgn 123228 EqualRgn 123229 GetRgnBox 123230 OffsetRgn 124231 PtInRegion 124232 RectInRegion 124233 SetRectRgn 125234 ExcludeClipRect 125235 IntersectClipRect 125236 OffsetClipRect 126237 SelectClipRect 126238 GetClipBox 127239 CreateBrushIndirect 1
46、27240 CreateDIBPatternBrush 127241 CreateHatchBrush 128242 CreateSolidBrush 128243 CreatePen, CreatePenIndirect 129244 GetBrushOrg, GetBrushOrgEx 130245 SetBrushOrg 130246 CreatePatternBrush 131247 Arc, Chord, Pie 131248 LineDDA, LineDDAProc 132249 LineTo, MoveTo, MoveToEx, Polyline 132250 Polygon,
47、PolyPolygon 133251 Ellipse, Rectangle, RoundRect 134252 FrameRgn, FillRgn, InvertRgn, PaintRgn 134253 DrawFocusRect 135254 FillRect, FrameRect 135255 FloodFill, ExtFloodFill 136256 GetPixel, SetPixel 136257 CreateBitmap, CreateBitmapIndirect 137258 CreateCompatibleBitmap, CreateDiscardableBitmap 137
48、259 CreateDIBitmap 138260 GetBitmapBits, SetBitmapBits 139- vii -262 GetDIBits, SetDIBits 139263 SetDIBitsToDevice 141264 StretchDIBits 142265 PatBlt 143266 BitBlt, StretchBlt 143267 GetStretchBltMode, SetStretchBltMode 145268 GetBitMapDimension, GetBitMapDimensionEx 145269 SetBitMapDimension, SetBi
49、tMapDimensionEx 146270 AddFontResource 146271 RemoveFontResource 146272 CreateFont, CreateFontIndirect 147273 EnumFonts, EnumFontsProc 149274 EnumFontFamilies, EnumFontFamProc 150275 GetCharWidth, GetABCCharWidths 150276 GetFontData 151277 GetKerningPairs 151278 GetOutlineTextMetrics 152279 GetRasterizerCaps 152280 GetAspectRatioFilter, GetAspectRatioFilterEx 152281 SetMapperFlags 153282 DrawText 153283 TextOut, ExtTextOut, TabbedTextOut 155284 GetTextExtent, GetTextExtentPoint, GetTabbedTextExtent 156285 GetTextAlign, SetTextAlign 156286 SetTextColor, GetTextColor 157287 GetTextChar
