| title | Graphic Objects | Microsoft Docs | ||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ms.custom | |||||||||||||||||||||||||||||||||||
| ms.date | 11/04/2016 | ||||||||||||||||||||||||||||||||||
| ms.reviewer | |||||||||||||||||||||||||||||||||||
| ms.suite | |||||||||||||||||||||||||||||||||||
| ms.technology |
|
||||||||||||||||||||||||||||||||||
| ms.tgt_pltfrm | |||||||||||||||||||||||||||||||||||
| ms.topic | article | ||||||||||||||||||||||||||||||||||
| f1_keywords |
|
||||||||||||||||||||||||||||||||||
| dev_langs |
|
||||||||||||||||||||||||||||||||||
| helpviewer_keywords |
|
||||||||||||||||||||||||||||||||||
| ms.assetid | 41963b25-34b7-4343-8446-34ba516b83ca | ||||||||||||||||||||||||||||||||||
| caps.latest.revision | 11 | ||||||||||||||||||||||||||||||||||
| author | mikeblome | ||||||||||||||||||||||||||||||||||
| ms.author | mblome | ||||||||||||||||||||||||||||||||||
| manager | ghogen | ||||||||||||||||||||||||||||||||||
| translation.priority.ht |
|
Windows provides a variety of drawing tools to use in device contexts. It provides pens to draw lines, brushes to fill interiors, and fonts to draw text. MFC provides graphic-object classes equivalent to the drawing tools in Windows. The table below shows the available classes and the equivalent Windows graphics device interface (GDI) handle types.
Note
GDI+ is included with Windows XP and is available as a redistributable for Windows NT 4.0 SP6, Windows 2000, Windows 98, and Windows Me. To download the latest redistributable, see http://www.microsoft.com/msdownload/platformsdk/sdkupdate/psdkredist.htm. For more information, see the GDI+ SDK documentation at: http://msdn.microsoft.com/library/default.aspurl=/library/gdicpp/GDIPlus/GDIPlus.asp.
This article explains the use of these graphic-object classes:
| Class | Windows handle type |
|---|---|
| CPen | HPEN |
| CBrush | HBRUSH |
| CFont | HFONT |
| CBitmap | HBITMAP |
| CPalette | HPALETTE |
| CRgn | HRGN |
Note
The class CImage provides enhanced bitmap support.
Each graphic-object class in the class library has a constructor that allows you to create graphic objects of that class, which you must then initialize with the appropriate create function, such as CreatePen.
Each graphic-object class in the class library has a cast operator that will cast an MFC object to the associated Windows handle. The resulting handle is valid until the associated object detaches it. Use the object's Detach member function to detach the handle.
The following code casts a CPen object to a Windows handle:
[!code-cppNVC_MFCDocViewSDI#5]
-
Define a graphic object on the stack frame. Initialize the object with the type-specific create function, such as
CreatePen. Alternatively, initialize the object in the constructor. See the discussion of one-stage and two-stage creation, which provides example code. -
Select the object into the current device context, saving the old graphic object that was selected before.
-
When done with the current graphic object, select the old graphic object back into the device context to restore its state.
-
Allow the frame-allocated graphic object to be deleted automatically when the scope is exited.
Note
If you will be using a graphic object repeatedly, you can allocate it once and select it into a device context each time it is needed. Be sure to delete such an object when you no longer need it.