VC之GDI(转帖)

 VC之GDI(转帖)

VC之GDI（一）

以前在Delphi下用Canvas用惯了，很少直接使用GDI API，今天转换到VC下了，哪只有重新温习GDI了，首先先简单说说GDI体系结构。

GDI是微软设计的一套API，为应用程序提供设备无关的接口，包括视频显示、打印机、画图仪和传真机。GDI提供几百个Windows程序可以调用的函数。这些函数大多数是从Win32的子系统GDI32.DLL中导出。有兴趣的话找个工具看看GDI32.Dll的导出函数。

GDI的功能太多了，MSDN库就将GDI API分为17个领域（位图、画刷、剪裁、颜色、坐标和变换、设备上下文、填充形状、字体和文本、直线和曲线、元文件、多显示监视器、画图和绘图、路径、画笔、打印和打印池、矩形、区域）。除了这些分类外，还有一些没有文档记载的函数。有一些在DDK中说明，还有一些没文档但系统DLL使用的函数。

主要的Windows图形编程API就是GDI，这些API与设备无关，编写出来的程序可在不同的设备上运行。哪GDI怎样实现设备无关的呢？为了与图形设备驱动程序交互，windows图形系统采用了了称之为设备上下文的内部数据结构，是用指针链接在一起的结构和对象组成的网状结构。设备上下文有两个重要的作用，最主要的用途在于提供图形设备逻辑，使的设备驱动程序以上的事物，包括图形引挚、win32客户端以及用户应用程序都独立于设备。另一个用途是存储常用的绘图属性，比如前景色，画笔、刷子......，这样不同的绘图调用就不需要重复这些设置。Win32 GDI的客户端向用户应用程序屏蔽了真正的设备上下文，应用只得到了设备上下文的句柄，GDI在创建设备上下文时返回句柄，然后将句柄反馈给GDI，以查询新的绘图操作。

 

// 通过使用指定的名字为一个设备创建设备上下文环境
/*
CreateDC(LPCTSTR pszDriver,只能是"DISPLAY"、NULL、"WINSPOOL"            
           LPCTSTR pszDevice,可以是EnumDisplayDevices返回的显示设备名，也可是打印名(如////.//DISPLAY1)或NULL
           LPCTSTR pszOutput,用于可以接收打印作业的端口名,win32 API使用新的函数调用StartDoc传递端口名，因此必须为NULL
           CONST DEVMODE *pdvmInit  指向DEVMODE结构的指针，DocumentProperties函数检索指定设备获取已填充的结构，如果设备驱动程序使用用户指定的缺省初始化值。则lplnitData参数必须为Null
         );  
*/
  HDC hdc  =  CreateDC(_T( " DISPLAY " ), NULL, NULL, NULL); // 整个屏幕的设备上下文句柄
  MoveToEx(hdc, 0 , 0 ,NULL);
  LineTo(hdc, 100 , 100 );    // 绘制一条直线
  DeleteDC(hdc);

  

// 获取指定窗口客户区设备上下文句柄
/*
GetDC(HWND hWnd);
*/

   hdc  =  ::GetDC( this -> m_hWnd);
   MoveToEx(hdc, 0 , 0 ,NULL);
   LineTo(hdc, 100 , 100 );
   ::ReleaseDC( this -> m_hWnd,hdc);

 

 

// 获取指定窗口设备上下文件句柄
/*
BeginPaint(HWND hWnd,//窗口句柄
           CONST PAINTSTRUCT *lpPaint  //获取显示参数
          )

PAINTSTRUCT结构定义
typedef struct tagPAINTSTRUCT { 
 HDC hdc; 
 BOOL fErase; 
 RECT rcPaint; 
 BOOL fRestore; 
 BOOL fIncUpdate; 
 BYTE rgbReserved[32]; 
} PAINTSTRUCT, *PPAINTSTRUCT
*/

  PAINTSTRUCT ps;
  hdc  =  ::BeginPaint( this -> m_hWnd,  & ps);
  MoveToEx(hdc, 200 , 200 ,NULL);
  LineTo(hdc, 1300 , 1300 );
  ::EndPaint( this -> m_hWnd,  & ps);

VC之GDI（二)

接着练

GDI对像

Windows的GDI对象类型是通过MFC中的类来表示的，而CGdiObject正是所有GDI对象类的抽象基类，即Windows的GDI对象是通过CGdiObject派生类的C++对象来表示的。如：CBitmap、CBrush、CFont、CPallete、CPen、CRgn.......

GDI对象存储在什么地方呢？GDI对象存储在系统范围内的固定大小的对象表中，称之为对象句柄表，GDI对象表是一个固定大小的表，在win2000/NT允许最多有16384个GDI句柄。GDI对象有许多专用的例程以创建该类型的一个新的GDI对象。一旦创建完成GDI对象，GDI将返回一个GDI对象句柄，当GDI对象不用时，要用DeleteObject函数删除哦，但要确保没该对象没有处在设备上下文中，不然会导致潜在的GDI对象泄露。

HGDIOBJ SelectObject(HDC hdc,HGDIOBJ hgdiobj); // 将GDI对象和一个设备上下文相连接
BOOL DeleteObject(HGDIOBJ hgdiobj); // 删除GDI对象
DWORD GetObjectType(HGDIOBJ h); // 确定指定对象类型
int  GetObject(HGDIOBJ hgdiobj, int  cbBuffer,LPVOID lpvObject); // 将指定对象的信息写入到缓冲区

 

下面以CPen对象来练练上面的四个函数。

// SelectObject和DeleteObject用法

CPen p, * oldPen;
p.CreatePen(PS_SOLID, 1 ,RGB( 255 , 255 , 0 ));
HDC hdc = ::GetDC( this -> m_hWnd);
oldPen = (CPen * )SelectObject(hdc,p.GetSafeHandle());
MoveEx(hdc, 0 , 0 ,NULL);
LineTo(hdc, 100 , 100 );
SelectObject(hdc,oldPen);
DeleteObject(p.GetSafehandle());
::ReleaseDC( this -> m_hWnd,hdc);

 

/*
DWORD GetObjectType(HGDIOBj h);
返回值：
OBJ_BITMAP(位图Bitmap)
OBJ_BRUSH(刷子Brush)
OBJ_PAL(调色版Palette)
OBJ_PEN(画笔Pen)
OBJ_EXTPEN(扩展画笔Extended pen)
OBJ_REGION(区域 Regioin)
OBJ_DC(设备上下文 Device context)
OBJ_MEMDC(存储设备上下文Memory DC)
OBJ_METAFILE(元文件Metafile)
OBJ_METADC(元文件设备上下文Metafile DC)
OBJ_ENHMETAFILE(扩展元文件Enhanced metafile)
OBJ_ENHMATADC(扩展元文件设备上下文Enhanced metafileD C)
*/
CPen p;
p.CreatePen(PS_SOLID, 1 ,RGB( 255 , 255 , 0 ));

if (OBJ_PEN  ==  GetObjectType(p.GetSafeHandle()))
{
   MessageBox(_T( " CPen对象 " ), " 信息 " );
}

p.DeleteObject();

VC之GDI（三)

GDI画笔对象

GDI中的画笔对象包含了直线和曲线的宽度、形式、颜色、端点形状、交点以及样式。你画出来的线是啥颜色，好宽，都由它决定的。

缺省的DC画笔是单个象素宽的黑色画笔。一旦画笔被选入设备上下文后，只有颜色是可以改变的，可通过下面两个函数来访问设置和得到DC画笔颜色。

COLORREF GetDCPenColor(HDC hdc);
COLORREF SetDCPenColor(HDC hdc,COLORREF crColor);

 GetDCPenColor函数获取设备上下文中DC画笔的当前颜色，SetDCPenColor函数设置一个新的颜色，并返回旧的颜色。

hdc = ::GetDC( this -> m_hWnd);
COLORREF crCol;
crCol  =  GetDCPenColor(hdc); // 默认为黑色
MoveToEx(hdc, 0 , 200 ,NULL);
LineTo(hdc, 100 , 200 ); // 绘制一条黑色的直线
HGDIOBJ  hld = SelectObject(hdc,GetStockObject(DC_PEN));
SetDCPenColor(hdc,RGB( 255 , 0 , 0 ));
MoveToEx(hdc, 0 , 220 ,NULL);
LineTo(hdc, 100 , 220 ); // 绘制一条红色的直线
SelectObject(hdc,hOld);
::ReleaseDC( this -> m_hWnd,hdc);

 上面的GetStockObject是啥？

原来GDI定义了四种预定义的画笔对象，叫库存画笔，为了获取库存画笔，那就要用到GetStockObject这个函数了。GetStockObject(BLACK_PEN)黑色、GetStockObject(White_PEN)白色、GetStockObject(NULL_PEN)什么都不画、GetStockObject(DC_PEN)。

下面用下面两个函数来创建画笔。

HPEN CreatePen( int  fnPenStyle, int  nwidth,COLORREF crColor);
HPEN CreatePenIndirect(CONST LOGPEN  * lgPen);

fnPenStyle画笔样式有下面这些样式。

PS_SOLID---------------纯色，所有象素都画

PS_DASH---------------虚线

PS_DOT-----------------点画线

PS_DASHDOT---------虚线和点画线交替出现

PS_DASHDOTDOT---虚线和两交点画线交替出现

PS_NULL----------------不画线

PS_INSIDEFRAME----纯色，所有象素都画

hdc = ::GetDC( this -> m_hWnd);
HPEN p_SOLID,p_DASH,p_DOT,p_DASHDOT,p_DASHDOTDOT;
p_SOLID = CreatePen(PS_SOLID, 1 ,RGB( 255 , 0 , 0 ));
p_DASH = CreatePen(PS_DASH, 1 ,RGB( 255 , 0 , 0 ));
p_DOT = CreatePen(PS_DOT, 1 ,RGB( 255 , 0 , 0 ));
p_DASHDOT = CreatePen(PS_DASHDOT, 1 ,RGB( 255 , 0 , 0 ));
p_DASHDOTDOT = CreatePen(PS_DASHDOTDOT, 1 ,RGB( 255 , 0 , 0 ));
hOld = SelectObject(hdc,p_SOLID);
MoveToEx(hdc, 0 , 10 ,NULL);
LineTo(hdc, 10 , 10 );
SelectObject(hdc,p_DASH);
MoveToEx(hdc, 0 , 20 ,NULL);
LineTo(hdc, 0 , 20 );
SelectObject(hdc,p_DOT);
MoveToEx(hdc, 0 , 30 ,NULL);
LineTo(hdc, 0 , 30 );
SelectObject(hdc,p_DASHDOT);
MoveToEx(hdc, 0 , 40 ,NULL);
LineTo(hdc, 0 , 40 );
SelectObject(hdc,p_DASHDOTDOT);
MoveToEx(hdc, 0 , 50 ,NULL);
LineTo(hdc, 0 , 50 );
SelectObject(hdc,hOld);
DeleteObject(p_SOLID);
DeleteObject(p_DASH);
DeleteObject(p_DOT);
DeleteObject(p_DASHDOT);
DeleteObject(p_DASHDOTDOT);
::ReleaseDC( this -> m_hWnd,hdc);

VC之GDI（三续)

CreatePenIndirect函数

结构LOGPEN存储了逻辑画笔的三个参数，画笔样式、宽度、颜色。

typedef  struct  tagLOGPEN{
  UINT lopnStyle;      // 样式
  POINT lopnWidth;     // 宽度
  COLORREF lopnColor;  // 颜色
}LOGPEN, * PLOGPEN;

 

LOGPEN logpen;
HPEN p;
HGDIOBJ hOld;
HDC hdc  =  ::GetDC( this -> m_hWnd);
logpen.lopnWidth.x  =   1 ;
logpen.lopnColor  =  RGB( 255 , 0 , 0 );
logpen.lopnStyle  =  PS_SOLID;
p  =  CreatePenIndirect( & logpen);
hOld = SelectObject(hdc,p);
MoveToEx(hdc, 0 , 10 ,NULL);
LineTo(hdc, 50 , 10 );
SelectObject(hdc,hOld);
DeleteObject(p);
::ReleaseDC( this -> m_hWnd,hdc);

 

ExtCreatePen函数

      上面CreatePen和CreatePenIndirect（CreatePenIndirect也是调用的CreatePen函数）创建的画笔，当宽度大于一个象素时，画笔不能画真实形式的直线，例如虚线和点划线。绘制的直线画端是圆角的，这时这两个函数将不能满足需要了。这时就可用到ExtCreatePen函数。ExtCreaetPen可以创建几何画和装饰性画笔。

 

HPEN ExtCreatePen(DWORD dwPenStylek,
                  DWORD dwWidth,
                  CONST LOGBRUSH  * lplb,
                  DWORD dwStyleCont,
                  CONST DWORD  * lpStyle);

用ExtCreatePen创建装饰性画笔

dwPenStyle：为画笔类型和型式（类型包括PS_COSMETIC和PS_GEOMETRIC，PS_COSMETIC为装饰画笔，PS_GEOMETRIC为几何画笔，型式包括前面说的画笔的样式PS_SOLID....，在2000/nt以上还包括PS_USERSTYLE、PS_ALTERNATE）。

 

dwWidth：装饰性画笔只能画单个象素宽的线，因此dwWidth参数只能为1；

lplb：画笔的属性；

dwStyleCont：是自定义样式数组的个数。

lpStyle：自定义样式数组

    LOGBRUSH lb;
    HDC hdc  =  ::GetDC( this -> m_hWnd);
    HGDIOBJ hOld;
    
    lb.lbStyle  =  BS_SOLID; 
    lb.lbColor  =  RGB( 255 , 0 , 0 ); 
    lb.lbHatch  =   0 ; 
    HPEN p  =  ExtCreatePen(PS_COSMETIC  |  PS_SOLID, 1 ,  & lb,  0 ,NULL); 
    hOld  =  SelectObject(hdc,p);
    MoveToEx(hdc, 0 , 20 ,NULL);
    LineTo(hdc, 100 , 20 );
    SelectObject(hdc,hOld);
    DeleteObject(p);
    ::ReleaseDC( this -> m_hWnd,hdc);

下面使用PS_USERSTYLE来创建自定义的装饰性画笔，lpSyle数组中的第一个元素象素长度，第二个元素为间距长度，第三个元素为象素长度......，里面元素的单位为三个象素，例如{4,3,2,1}则绘出的线为12个象素的线，9象素的间距，6象素的线，3象素的间距。

    LOGBRUSH lb;
    HDC hdc  =  ::GetDC( this -> m_hWnd);
    HGDIOBJ hOld;
    DWORD cy[ 4 ]  =  { 4 , 3 , 2 , 1 };
    
    lb.lbStyle  =  BS_SOLID; 
    lb.lbColor  =  RGB( 255 , 0 , 0 ); 
    lb.lbHatch  =   0 ; 
    HPEN p  =  ExtCreatePen(PS_COSMETIC  |  PS_USERSTYLE, 1 ,  & lb,  4 , cy);  
    hOld  =  SelectObject(hdc,p);
    MoveToEx(hdc, 0 , 20 ,NULL);
    LineTo(hdc, 100 , 20 );
    SelectObject(hdc,hOld);
    DeleteObject(p);
    ::ReleaseDC( this -> m_hWnd,hdc);

使用ExtCreatePen建立几何画笔

 

    LOGBRUSH lb;
    HDC hdc  =  ::GetDC( this -> m_hWnd);
    HGDIOBJ hOld;
    DWORD cy[ 4 ]  =  { 4 , 3 , 2 , 1 };
    
    lb.lbStyle  =  BS_SOLID;
    lb.lbColor  =  RGB( 255 , 0 , 0 ); 
    lb.lbHatch  =   0 ; 
         // 创建一个平面端点几何画笔（PS_ENDCAP_FLAT平面端点，PS_ENDCAP_ROUND圆角端点)
    HPEN p  =  ExtCreatePen(PS_GEOMETRIC  |  PS_SOLID  |  PS_ENDCAP_FLAT, 16 ,  & lb,  0 , NULL);  
    hOld  =  SelectObject(hdc,p);
    MoveToEx(hdc, 0 , 20 ,NULL);
    LineTo(hdc, 100 , 20 );
    SelectObject(hdc,hOld);
    DeleteObject(p);
    ::ReleaseDC( this -> m_hWnd,hdc);

VC之GDI（四）

GDI画刷对象

GDI中的画刷对象的颜色决定了区域填充中前景色。

缺省的DC画刷是白色画刷。一旦画笔被选入设备上下文后，可通过下面两个函数来访问设置和得到DC画笔颜色。

GDI预定义了7个库存画刷，可以使用GetStockObject函数带入以下参数获取库存画刷。

BLACK_BRUSH---------------黑色画刷

DKGRAY_BRUSH-------------暗灰色画刷

GRAY_BRUSH----------------灰色画刷

LTGRAY_BRUSH-------------浅灰色画刷

WHITE_BRUSH--------------白色画刷

NULL_BRUSH----------------空画刷

DC_BRUSH------------------DC画刷

COLORREF GetDCBrushColor(HDC hdc);
COLORREF SetDCBrushColor(HDC hdc,COLORREF clColor);

 GetDCBrushColor函数获取设备上下文中DC画刷的当前颜色，SetDCBrushColor函数为当关DC画刷设置一个新的颜色，并返回旧的颜色。

 自定义画刷

 

HBRUSH CreateSolidBrush(COLORREF clColor);                             // 创建纯色画刷
HBRUSH CreateHatchBrush( int  fnStyle,COLORREF crRef);                   // 创建阴影画刷
HBRUSH CreatePatternBrush(HBITMAP hbmp);                               // 创建位图画刷
HBRUSH CreateDIBPatternBrushPt(CONST VOID  * lpPackedDIB,UINT iUsage);   // 创建设备无关位图画刷
HBRUSH CreateDIBPatternBrush(HGLOBAL hglbDIBPacked,UINT iUsage);       // 创建设备无关位图画刷
HBRUSH GetSysColorBursh( int  nIndex);                                   // 创建系统颜色画刷