MFC使用GDI+编程基础【收集整理】
一、MFC使用GDI+编程设置
（1）增加静态库文件GdiPlus.lib
在VC2005“项目/*属性”菜单项，打开项目的属性页窗口，先选“所有配置”，再选“配置属性/链接器/输入”项。在右边上部的“附加依赖项”栏的右边，键入GdiPlus.lib 后按“应用”钮，最后按“确定”钮关闭对话框。
当然，我们也可以在代码中使用#pragma comment( lib, "gdiplus.lib" )实现对静态文件的引用。
（2）增加GDI+的头文件和命名空间
在需要用到GDI+的文件头加上下面两句
#include <gdiplus.h>
using namespace Gdiplus;
（3）增加成员变量
在应用程序类应用程序类(CGDIPlusDemoApp) 头文件中，声明一个成员ULONG PTR类型的变量：
ULONG_PTR m_gdiplusToken; // ULONG PTR 为int64 类型
（4）初始化操作
在该类的初始化函数CGDIPlusDemoApp::InitInstance() 中
加入以下代码来对GDI+进行初始化：
GdiplusStartupInput gdiplusStartupInput; //声明
GdiplusStartup(&m_gdiplusToken, &gdiplusStartupInput, NULL); //启动
注意：这两个语句必须加在应用程序类的InitInstance函数中的
CWinApp:: InitInstance ();
语句之前，不然以后会造成视图窗口不能自动重画、程序中不能使用字体等等一系列问题。
（5）关闭GDI+操作
在CGDIPlusDemoApp::ExitInstance() 函数（重写）中加入以下代码来关闭GDI +：
GdiplusShutdown(m_gdiplusToken);//关闭
====================================================
二、MFC使用GDI+编程实例
1、GDI+程序设计步骤：
(1)、在项目中引入GDI+的头文件，使用GDI+的命名空间。
(2)、初始化GDI+系统资源。
(3)、使用完毕之后，释放GDI+所使用的资源。
(4)、在编译时加入GDIplus.Lib库文件。
2、实例步骤：
（1）建立项目
打开Visual C++.NET，在菜单中点击“文件”|“新建”|“项目”，然后建立MFC的“单文档”应用程序，本文建立的项目名称为GDIPlusDemo。
（2）、在程序中使用GDI+命名空间
由于GDI+中使用了自己的命名空间（这可以从GDIplus.h头文件中看出GDI+对命名空间的定义），我们需要引入头文件，还要声明其命名空间，并且添加GDI+运行库（GDIplus.lib）支持。
具体方法是修改stdafx.h文件，在该头文件的结尾处加入下列的代码：
#include <GdiPlus.h> //引入GDI+头文件
using namespace Gdiplus; //使用GDI+的命名空间
#pragma comment( lib, "gdiplus.lib" ) //引入静态库文件
（3）、GDI+资源的初始化与销毁
在使用GDI+的资源之前，我们应该通过GdiplusStartup(启用GDI-资源)函数进行GDI+系统资源的初始化操作；而在程序结束前，我们也应该通过GdiplusShutdown(关闭GDI+资源)函数进行GDI+资源的销毁操作。
这两项工作，分别可以在CGDIPlusDemoApp应用类的InitInstance(初始化进程)函数和CGDIPlusDemoApp类的析构函数中进行。
首先需要在CGDIPlusDemoApp中增加一个全局变量，以表明对GDI+的一个引用，实现的代码如下：
ULONG_PTR gdiplusToken; //全局变量，表明对GDI+的一个引用
在CGDIPlusDemoApp的InitInstance（）函数中增加GDI+函数的初始化操作：
BOOL CGDIPlusDemoApp::InitInstance()
{
InitCommonControls();
//GDI+系统资源的初始化
GdiplusStartupInput gdiplusStartupInput;
GdiplusStartup(&gdiplusToken,&gdiplusStartupInput,NULL);
CWinApp::InitInstance(); // GDI+系统资源的初始化的代码需要放在该代码前
// 初始化OLE 库
if (!AfxOleInit())
{
……
}
}
最后，使用完GDI+后在CGDIPlusDemoApp::ExitInstance()函数中将其销毁：
int CGDIPlusDemoApp::ExitInstance()
{
// TODO: 在此添加专用代码和/或调用基类
GdiplusShutdown(gdiplusToken);
return CWinApp::ExitInstance();
}
全局变量gdiplusToken的作用是代表着对GDI+的一个引用。在使用GdiplusStartup函数时，该变量已经被初始化，在使用GdiplusShutdown函数时，通过对该变量gdiplusToken的访问，完成对GDI+资源的销毁工作。
经过上述三个步骤，一个完整的GDI+程序的框架已经搭建完毕，其他只需在CGDIPlusDemoView::OnDraw(CDC* pDC)函数中添加相应的代码就可以了。
====================================================
三、MFC使用GDI+编程基础
封装在GDI+ API中的各种C++类、函数、常量、枚举和结构，都被定义在Gdiplus.h头文件所包含的一系列头文件中。所以，采用MFC进行GDI+编程，必须包含Gdiplus.h头文件。
封装在GDI+类中方法，最后都需要调用GDI+平面API中的相关底层函数，才能完成实际的操作。所以，为了运行GDI+应用程序，在操作系统平台中，必须安装动态链接库Gdiplus.dll。
该动态链接库所对应的静态库文件为GdiPlus.lib，而且它不是C++和MFC的缺省链接库。所以，必须在项目设置，添加该库作为链接器输入的附加依赖项。
因为在Gdiplus.h头文件中，将所有的GDI+的类、函数、常量、枚举和结构等都定义在了命名空间Gdiplus中。所以，一般在GDI+程序中，都必须使用如下的命名空间声明：
using namespace Gdiplus;
例如：
#include <gdiplus.h>
using namespace Gdiplus;
……
1）GdiPlus.h代码
/*********************************************************************/
* Copyright (c) 1998-2001, Microsoft Corp. All Rights Reserved.
* Module Name:
* Gdiplus.h
* Abstract:
* GDI+ public header file
/*********************************************************************/
#ifndef _GDIPLUS_H
#define _GDIPLUS_H
struct IDirectDrawSurface7;
typedef signed short INT16;
typedef unsigned short UINT16;
#include <pshpack8.h> // set structure packing to 8
namespace Gdiplus
{
namespace DllExports {
#include "GdiplusMem.h"
};
#include "GdiplusBase.h"
#include "GdiplusEnums.h"
#include "GdiplusTypes.h"
#include "GdiplusInit.h"
#include "GdiplusPixelFormats.h"
#include "GdiplusColor.h"
#include "GdiplusMetaHeader.h"
#include "GdiplusImaging.h"
#include "GdiplusColorMatrix.h"
#include "GdiplusGpStubs.h"
#include "GdiplusHeaders.h"
namespace DllExports {
#include "GdiplusFlat.h"
};
#include "GdiplusImageAttributes.h"
#include "GdiplusMatrix.h"
#include "GdiplusBrush.h"
#include "GdiplusPen.h"
#include "GdiplusStringFormat.h"
#include "GdiplusPath.h"
#include "GdiplusLineCaps.h"
#include "GdiplusMetafile.h"
#include "GdiplusGraphics.h"
#include "GdiplusCachedBitmap.h"
#include "GdiplusRegion.h"
#include "GdiplusFontCollection.h"
#include "GdiplusFontFamily.h"
#include "GdiplusFont.h"
#include "GdiplusBitmap.h"
#include "GdiplusImageCodec.h"
}; // namespace Gdiplus
#include <poppack.h> // pop structure packing back to previous state
#endif // !_GDIPLUS_HPP
2）GDI+的初始化与清除
为了在MFC应用程序中使用采用C++封装的GDI+ API，我们必须在MFC项目的应用程序类中，调用GDI+命名空间中的GDI+启动函数GdiplusStartup和GDI+关闭函数GdiplusShutdown，来对GDI+进行初始化（装入动态链接库Gdiplus.dll，或锁定标志+1）和清除（卸载动态链接库Gdiplus.dll，或锁定标志-1）工作。它们一般分别在应用程序类的InitInstance和ExitInstance重载成员函数中调用。
函数GdiplusStartup和GdiplusShutdown，都被定义在GdiplusInit.h头文件中：
//GDI+的启动函数
Status WINAPI GdiplusStartup(
OUT ULONG_PTR *token,
const GdiplusStartupInput *input,
OUT GdiplusStartupOutput *output);
//GDI+的关闭函数
void GdiplusShutdown(ULONG_PTR token);
其中：
类型ULONG_PTR，是用无符号长整数表示的指针，被定义在basetsd.h头文件中：
typedef _W64 unsigned long ULONG_PTR;
输出参数token（权标），供关闭GDI+的函数使用，所以必须设置为应用程序类的成员变量（或全局变量，不提倡）。
结构GdiplusStartupInput和GdiplusStartupOutput，也都被定义在GdiplusInit.h头文件中：
struct GdiplusStartupInput
{
UINT32 GdiplusVersion; // Must be 1，必须是1
DebugEventProc DebugEventCallback; // Ignored on free builds，
BOOL SuppressBackgroundThread; // FALSE unless you're prepared to call
// the hook/unhook functions properly
BOOL SuppressExternalCodecs; // FALSE unless you want GDI+ only to use
// its internal image codecs.
GdiplusStartupInput(
DebugEventProc debugEventCallback = NULL,
BOOL suppressBackgroundThread = FALSE,
BOOL suppressExternalCodecs = FALSE)
{
GdiplusVersion = 1;
DebugEventCallback = debugEventCallback;
SuppressBackgroundThread = suppressBackgroundThread;
SuppressExternalCodecs = suppressExternalCodecs;
}
};
struct GdiplusStartupOutput
{
NotificationHookProc NotificationHook;
NotificationUnhookProc NotificationUnhook;
};
GDI+启动输入结构指针参数input，一般取缺省构造值即可，即（设：无调试事件回调过程、不抑制背景线程、不抑制外部编解码）：
input = GdiplusStartupInput(NULL, FALSE, FALSE);
GDI+启动输出结构指针参数output，一般不需要，取为NULL即可。
注意，采用MFC进行GDI+ API编程时，在使用任何GDI+的功能调用之前，必须先调用GDI+启动函数GdiplusStartup来进行初始化GDI+的工作；在完成所有的GDI+功能调用之后，必须调用GDI+关闭函数GdiplusShutdown来进行清除GDI+的工作。
例如，创建一个名为GdipDraw的MFC单文档应用程序项目，在项目属性中添加GdiPlus.lib库作为链接器输入的附加依赖项
// GdipDraw.h 头文件
……
class CGdipDrawApp : public CWinApp
{
public:
CGdipDrawApp();
ULONG_PTR m_gdiplusToken;
……
};
// GdipDraw.cpp 实现文件
……
#include <gdiplus.h>
sing namespace Gdiplus;
……
BOOL CGdipDrawApp::InitInstance()
{
// 如果一个运行在 Windows XP 上的应用程序清单指定要
// 使用 ComCtl32.dll 版本 6 或更高版本来启用可视化方式，
//则需要 InitCommonControlsEx()。否则，将无法创建窗口。
INITCOMMONCONTROLSEX InitCtrls;
InitCtrls.dwSize = sizeof(InitCtrls);
// 将它设置为包括所有要在应用程序中使用的
// 公共控件类。
InitCtrls.dwICC = ICC_WIN95_CLASSES;
InitCommonControlsEx(&InitCtrls);
/*注意：下面这两个语句必须加在CWinApp:: InitInstance ();语句之前，不然以后会造成视图窗口不能自动重画、程序中不能使用字体等等一系列问题。*/
GdiplusStartupInput gdiplusStartupInput;
GdiplusStartup(&m_gdiplusToken, &gdiplusStartupInput, NULL);
CWinApp::InitInstance();
……
}
……
int CGdipDrawApp::ExitInstance() // 该函数是自己利用属性窗口，添加的重写函数
{
GdiplusShutdown(m_gdiplusToken);
return CWinApp::ExitInstance();
}
3）几何辅助类
在GDI+ 的API中，定义了许多绘图的辅助类，常用的有点、大小和矩形等几何类。它们都是没有基类的独立类，被定义在头文件GdiplusTypes.h中。下面逐个进行介绍：
（1）Point/Point F （点）
GDI+中，有两种类型的点：整数点（对应于Point类）和浮点数点（对应于PointF类）。下面分别加以介绍：
整数点类Point：
class Point {
public:
Point() {X = Y = 0;}
Point(const Point &point) {X = point.X; Y = point.Y;}
Point(const Size &size) {X = size.Width; Y = size.Height;}
Point(INT x, INT y) {X = x; Y = y;}
Point operator+(const Point& point) const {return Point(X + point.X, Y + point.Y);}
Point operator-(const Point& point) const {return Point(X - point.X, Y - point.Y);}
BOOL Equals(const Point& point) {return (X == point.X) && (Y == point.Y);}
public:
INT X; // 大写X、Y
INT Y;
};
其中：
typedef int INT; // 4字节有符号整数（windef.h）
注意，这里的点与GDI的区别：
POINT和CPoint：{x; y;} // 小写x、y
浮点数点类PointF：
class PointF {
public:
PointF() {
X = Y = 0.0f; }
PointF(const PointF &point) {
X = point.X; Y = point.Y; }
PointF(const SizeF &size) {
X = size.Width; Y = size.Height ;}
PointF(REAL x, REAL y) {
X = x; Y = y; }
PointF operator+(const PointF& point) const {
return PointF(X + point.X,Y + point.Y); }
PointF operator-(const PointF& point) const {
return PointF(X - point.X, Y - point.Y); }
BOOL Equals(const PointF& point) {
return (X == point.X) && (Y == point.Y); }
public:
REAL X;
REAL Y;
};
其中：
typedef float REAL; // 4字节浮点数（GdiplusTypes.h）
注意，浮点数版的几何对象和绘图函数，是GDI+新增的功能，这些在各种工程技术领域都非常有用。因为一般的实际图形设计，都是基于实数坐标的。包括机械（机床/汽车/轮船/飞机等）、建筑（房屋/桥梁/道路/堤坝等）和图形动画设计（形状/物体/人物/背景/轨迹等）等设计，都必须使用浮点参数和坐标系。
（2）Size/ SizeF（大小）
GDI+中，也有两种类型的大小（尺寸）：整数大小（对应于Size类）和浮点数大小（对应于SizeF类）。下面分别加以介绍：
整数大小类Size：
class Size {
public:
Size() {
Width = Height = 0; }
Size(const Size& size) {
Width = size.Width; Height = size.Height; }
Size(INT width, INT height) {
Width = width; Height = height; }
Size operator+(const Size& sz) const {
return Size(Width + sz.Width, Height + sz.Height); }
Size operator-(const Size& sz) const {
return Size(Width - sz.Width, Height - sz.Height); }
BOOL Equals(const Size& sz) const {
return (Width == sz.Width) && (Height == sz.Height); }
BOOL Empty() const {
return (Width == 0 && Height == 0); }
public:
INT Width; // 不是cx和cy
INT Height;
};
注意，这里的大小与GDI的区别：
SIZE和CSize：{cx; cy;} // 不是宽和高
浮点数大小类SizeF：
class SizeF {
public:
SizeF() {
Width = Height = 0.0f; }
SizeF(const SizeF& size) {
Width = size.Width; Height = size.Height; }
SizeF(REAL width, REAL height) {
Width = width; Height = height; }
SizeF operator+(const SizeF& sz) const {
return SizeF(Width + sz.Width, Height + sz.Height); }
SizeF operator-(const SizeF& sz) const {
return SizeF(Width - sz.Width, Height - sz.Height); }
BOOL Equals(const SizeF& sz) const {
return (Width == sz.Width) && (Height == sz.Height); }
BOOL Empty() const {
return (Width == 0.0f && Height == 0.0f); }
public:
REAL Width;
REAL Height;
};
（3）Rect/ Rect F（矩形）
GDI+中，也有两种类型的矩形：整数矩形（对应于Rect类）和浮点数矩形（对应于RectF类）。下面分别加以介绍：
整数矩形类Rect：
class Rect {
public:
Rect() {X = Y = Width = Height = 0;}
Rect(INT x, INT y, INT width, INT height);
Rect(const Point& location, const Size& size);
Rect* Clone() const;
VOID GetLocation(OUT Point* point) const;
VOID GetSize(OUT Size* size) const;
VOID GetBounds(OUT Rect* rect) const;
INT GetLeft() const {return X;}
INT GetTop() const {return Y;}
INT GetRight() const {return X+Width;}
INT GetBottom() const {return Y+Height;}
BOOL IsEmptyArea() const{return (Width <= 0) || (Height <= 0);}
BOOL Equals(const Rect & rect) const;
BOOL Contains(INT x, INT y) const;
BOOL Contains(const Point& pt) const;
BOOL Contains(Rect& rect) const;
VOID Inflate(INT dx, INT dy) {
X -= dx; Y -= dy;
Width += 2*dx; Height += 2*dy; }
VOID Inflate(const Point& point) {Inflate(point.X, point.Y);}
BOOL Intersect(const Rect& rect) {return Intersect(*this, *this, rect);}
static BOOL Intersect(OUT Rect& c, const Rect& a, const Rect& b);
BOOL IntersectsWith(const Rect& rect) const;
static BOOL Union(OUT Rect& c, const Rect& a, const Rect& b);
VOID Offset(const Point& point);
VOID Offset(INT dx, INT dy);
public:
INT X; // 不是left和top
INT Y;
INT Width; // 更不是right和bottom
INT Height;
};
注意，这里的矩形与GDI的区别：
RECT：{left; top; right; bottom;}; // 不是宽和高
虽然Rect中的(X, Y)等价于RECT的( left, top)，但是Rect中的(Width, Height)却不同于RECT的( right, bottom)。
浮点数矩形类RectF：
class RectF {
public:
RectF() {X = Y = Width = Height = 0.0f;}
RectF(REAL x, REAL y, REAL width, REAL height);
RectF(const PointF& location, const SizeF& size);
RectF* Clone() const;
VOID GetLocation(OUT PointF* point) const;
VOID GetSize(OUT SizeF* size) const;
VOID GetBounds(OUT RectF* rect) const;
REAL GetLeft() const;
REAL GetTop() const;
REAL GetRight() const;
REAL GetBottom() const;
BOOL IsEmptyArea() const;
BOOL Equals(const RectF & rect) const;
BOOL Contains(REAL x, REAL y) const;
BOOL Contains(const PointF& pt) const;
BOOL Contains(const RectF& rect) const;
VOID Inflate(REAL dx, REAL dy);
VOID Inflate(const PointF& point);
BOOL Intersect(const RectF& rect);
static BOOL Intersect(OUT RectF& c, const RectF& a, const RectF& b);
BOOL IntersectsWith(const RectF& rect) const;
static BOOL Union(OUT RectF& c, const RectF& a, const RectF& b);
VOID Offset(const PointF& point);
VOID Offset(REAL dx, REAL dy);
public:
REAL X;
REAL Y;
REAL Width;
REAL Height;
};
在GDI的MFC封装中，也有点、大小和矩形的
结构：（windef.h）
typedef struct tagPOINT {LONG x; LONG y;} POINT; // typedef long LONG;
typedef struct tagSIZE {LONG cx; LONG cy;} SIZE;
typedef struct tagRECT {LONG left; LONG top; LONG right; LONG bottom;} RECT;
类：（atltypes.h）
class CPoint : public tagPOINT {
public:
CPoint() throw();
CPoint(int initX, int initY) throw();
……
}
class CSize : public tagSIZE {
public:
CSize() throw();
CSize(int initCX, int initCY) throw();
……
}
class CRect : public tagRECT {
public:
CRect() throw();
CRect(int l, int t, int r, int b) throw();
……
}
可见，这几个类都是从对应的结构派生的。GDI中，之所以有了类还要保留结构，主要是考虑效率和与底层GDI API的兼容。
比较可知，GDI和GDI+都有对应的类，不过GDI+没有对应的结构（但有浮点数版类），而GDI则没有对应的浮点数版类（但却有结构）。
参考资料：
1、http://topic.csdn.net/u/20090301/18/60dacb46-9475-4bc0-a362-b37e84c72ec0.html
2、http://blog.csdn.net/touzani/archive/2007/06/17/1655790.aspx