windows画图常用函数 二

SetMapMode()

简介


　　函数功能描述:该函数设置指定设备环境的映射方式，映射方式定义了将逻辑单位转换为设备单位的度量单位，并定义了设备的X、Y轴的方向。
　　函数原型：int SetMapMode(HDC hdc, int fnMapMode)；
编辑本段
参数：


　　hdc：指向设备环境的句柄。
　　fnMapMode：指定新的映射方式，此参数可以是下面列出的任何一个值。
　　MM_ANISOTROPIC：逻辑单位转换成具有任意比例轴的任意单位，用SetWindowExt和SetViewportExt函数可指定单位、方向和比例。
　　MM_HIENGLISH：每个逻辑单位转换为0.001英寸，X的正方向向右，Y的正方向向上。
　　MM_HIMETRIC：每个逻辑单位转换为0.01毫米，X正方向向右，Y的正方向向上。
　　MM_ISOTROPIC：逻辑单位转换成具有均等比例轴的任意单位，即沿X轴的一个单位等于沿Y轴的一个单位，用SetWindowExt和SetViewportExt函数可以指定该轴的单位和方向。图形设备界面（GDI）需要进行调整，以保证X和Y的单位保持相同大小（当设置窗口范围时，视口将被调整以达到单位大小相同）。
　　MM_LOENGLISH：每个逻辑单位转换为0.01英寸，X正方向向右，Y正方向向上。
　　MM_LOMETRIC：每个逻辑单位转换为0.1毫米，X正方向向右，Y正方向向上。
　　MM_TEXT：每个逻辑单位转换为一个图素，X正方向向右，Y正方向向下。
　　MM_TWIPS；每个逻辑单位转换为打印点的1/20（即1/1400英寸），X正方向向右，Y方向向上。
　　返回值：如果函数调用成功，返回值指定先前的映射方式，否则，返回值为零，若想获得更多错误信息，请调用GetLastError函数。

详见：http://baike.baidu.com/view/1031335.htm

//---------------------------------------------------------------

SetWindowExtEx()

函数原型：
　　BOOL SetWindowExtEx( __in HDC hdc, __in int nXExtent, __in int nYExtent, __out LPSIZE lpSize);
参       数：
　　HDC
　　A到设备上下文句柄。
　　nXExtent
　　窗口的水平范围的逻辑单位。
　　nYExtent
　　窗口的垂直程度的逻辑单位。
　　lpSize[输出]
　　一个指向指针的尺寸在逻辑结构，接收单位的上一个窗口范围。如果lpSize是NULL，这个参数是无法使用。
编辑本段
返回值


　　如果函数成功，返回值为非零。
　　如果函数失败，返回值为零。

详见：http://baike.baidu.com/view/3353830.htm

//---------------------------------------------------------------

SetViewportExtEx()

　　函数功能：该函数用指定的值来设置指定设备环境坐标的X轴、Y轴范围。
　　函数原型：BOOL SetViewportExtEx(HDC hdc, int nXExtent, int nYExtent, LPSIZE lpSize)；
　　参数：
　　hdc：指向设备描述表的句柄。
　　nXExtent：指定观察口以设备单位为单位的水平轴的范围。
　　nYExent：指定观察口以设备单位为单位的垂直轴的范围。
　　lpSize：指向Size结构的指针，先前的设备单位为单位的视口范围存放在此结构中，如lpSize值为NULL，则什么也没返回。
　　返回值：如果函数调用成功，返回值为非零值，否则为零。
　　备注：当设置下面的映射方式时，对函数SetWindowExtEx和SetViewportExtEx的调用被忽略：
　　MM_HIENGLISH; MM_HIMETRIC; MM_LOENGLISH; MM_LOMETRIC; MM_TEXT; MM_TWIPS
　　当设置MM_ISOTROPIC方式时，应用程序在调用SetViewportExtEx之前必须调用SetWindowExtEx函数。
　　速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件：wingdi.h；库文件：gdi32.lib。

详见：http://baike.baidu.com/view/1080513.htm

//---------------------------------------------------------------

SetViewportOrgEx()

简介：
　　SetViewportOrgEx说明哪个设备点映射到窗口原点(0,0)
　　BOOL SetViewportOrgEx(
　　HDC hdc, // 设备内容HANDLE
　　int X, // 新Viewport的x坐标
　　int Y, // 新Viewport的y坐标
　　LPPOINT lpPoint // 原来的Viewport的坐标
　　);
　　参数：
　　hdc:[输入]设备内容的HANDLE
　　X:[输入]新的viewport原点的设备单位的x坐标
　　Y:[输入]新的viewport原点的设备单位的y坐标
　　lpPoint:
　　[输出]指向一个POINT结构用来接收原先的viewport原点坐标，坐标是设备单位的。如果lpPoint是NULL，这个参数不使用。
　　返回值：
　　如果返回成功返回非0，如果失败，返回0。
　　备注：
　　这个函数（连同SetViewportExtEx和SetWindowExtEx）帮助定义逻辑坐标空间（也就是一个窗口）到设备坐标空间映射（viewport）。SetViewPortOrgEx指定哪个设备点映射到逻辑点(0,0).它有移动坐标轴的功能，从而使逻辑点(0,0)不再指向左上角了。
　　//映射逻辑点 (0,0) 到设备点 (xViewOrg, yViewOrg)
　　SetViewportOrgEx ( hdc, xViewOrg, yViewOrg, NULL)
　　这就是SetViewportOrgEx的作用。总的来说，你使用一个函数或另一个函数，但不能都使用，而不管你使用SetWindowOrgEx还是SetViewportOrgEx，设备点(0,0)总是在左上角。

详见：http://baike.baidu.com/view/1031341.htm

//---------------------------------------------------------------

CreatePen()

　　[声明]
　　BOOL CreatePen(int nPenStyle, int nWidth, COLORREF crColor);
　　BOOL CreatePen(int nPenStyle, int nWidth, const LOGBRUSH* pLogBrush,
　　int nStyleCount = 0, const DWORD* lpStyle = NULL);　
　　[说明]
　　用指定的样式、宽度和颜色创建一个画笔
　　[参数表]
　　nPenStyle ------ Long，指定画笔样式，可以是下述常数之一
　　PS_SOLID
　　画笔画出的是实线
　　PS_DASH
　　画笔画出的是虚线（nWidth必须是1）
　　PS_DOT
　　画笔画出的是点线（nWidth必须是1）
　　PS_DASHDOT
　　画笔画出的是点划线（nWidth必须是1）
　　PS_DASHDOTDOT
　　画笔画出的是点-点-划线（nWidth必须是1）
　　PS_NULL
　　画笔不能画图
　　PS_INSIDEFRAME
　　画笔在由椭圆、矩形、圆角矩形、饼图以及弦等生成的封闭对象框中画图。如指定的准确RGB颜色不存在，就进行抖动处理
　　nWidth --------- Long，以逻辑单位表示的画笔的宽度
　　crColor -------- Long，画笔的RGB颜色
　　[返回值]
　　Long，如函数执行成功，就返回指向新画笔的一个句柄；否则返回零
　　[其它]
　　一旦不再需要画笔，记得用DeleteObject函数将其删除
　　示例：
　　采用GDI绘图
　　HDC hdc;//设备场景DC
　　PAINTSTRUCT ps;
　　HEPN hPen;
　　HPEN hPenOld;
　　hdc = BeginPaint( hWnd , &ps );
　　hPen = CreatePen( PS_SOLID , 3 , RGB( 255 , 0 , 0 );
　　hPenOld = ( HPEN )SelectObject ( hdc , hPen );
　　MoveToEx ( hdc , 20 , 10 , NULL );
　　LineTo( hdc , 200 ,100);
　　SelectObject (hdc , hOldPen);
　　DeleteObject ( hPen );
　　EndPaint ( hWnd , &ps );

详见：http://baike.baidu.com/view/1706960.htm?fromTaglist

//---------------------------------------------------------------

TextOut()

函数功能


　　该函数用当前选择的字体、背景颜色和正文颜色将一个字符串写到指定位置。
编辑本段
使用方法


函数原型
　　BOOL TextOut(
　　HDC hdc,           // 设备描述表句柄
　　int nXStart,       // 字符串的开始位置 x坐标
　　int nYStart,       // 字符串的开始位置 y坐标
　　LPCTSTR lpString,  // 字符串
　　int cbString       // 字符串中字符的个数
　　);
参数
　　hdc
　　[输入] 设备环境的句柄
　　nXStart
　　[输入] 指定用于字符串对齐的基准点的逻辑X坐标。
　　nYStart
　　[输入] 指定用于字符串对齐的基准点的逻辑Y坐标。
　　lpString
　　[输入] 指向将被绘制字符串的指针。此字符串不必为以\0结束的，因为cbString中指定了字符串的长度。
　　cbString
　　[输入] 指定了字符串的长度。
返回值
　　如果函数调用成功，返回值为非零值。
　　如果函数调用失败，返回值为0。
　　Windows NT：若想获得更多错误信息，请调用GetLastError函数。

详见：http://baike.baidu.com/view/1080789.htm

//---------------------------------------------------------------

SetBkColor()

函数功能


　　该函数用指定的颜色值来设置当前的背景色，如果指定的颜色值超出了当前设备的表示范围，则设置为最近似的、设备可以表示的颜色。
编辑本段
函数原型


　　COLORREF SetBkColor( HDC hdc, COLORREF crColor );
编辑本段
参数说明


　　hdc: 设置上下文句柄
　　crColor: 标识新的背景颜色值。如果想要获得COLORREF的值，请使用RGB宏。
编辑本段
返回值


　　如果函数成功，返回值是原背景色的COLORREF值。如果函数失败，则返回CLR_INVALID。想要获得更多信息，请调用GetLastError函数。
　　速查：
　　Windows NT/2000: 需要 Windows NT 3.1 或更高版本.
　　Windows 95/98: 需要 Windows 95 或更高版本.
　　Header: 在头文件Wingdi.h中声明;请包含 Windows.h.
　　Library: Use Gdi32.lib.程序例

详见：http://baike.baidu.com/view/1983872.htm

//---------------------------------------------------------------

SetBkMode()

基本概述


原型：
　　一是MFC里面封装的CDC类：
　　CDC::SetBkMode
　　int SetBkMode( int nBkMode );
　　API函数SetBkMode声明如下：
　　int SetBkMode(
　　HDC hdc, // handle of device context
　　int iBkMode // flag specifying background mode
　　);
参数：
　　hDC是当前设备的句柄。
　　mode是要设置的模式，其值可以为OPAQUE和TRANSPARENT。
　　输出的字符串时，发现存在背景色，这样的输出是破坏背景的。那需要使用什么方法来保持背景不变，而又能输出红色的字符串呢？比如按钮的文字颜色是黑色的，而背景是灰色的。这就需要使用SetBkMode函数来设置DrawText函数的输出方式，显示设备共有两种输出方式：OPAQUE和TRANSPARENT。OPAQUE的方式是用当前背景的画刷的颜色输出显示文字的背景，而TRANSPARENT是使用透明的输出，也就是文字的背景是不改变的。
　　对透明的理解：在窗体或控件输出的字符串或图形是有背景色的。而窗体或控件也是有背景色的。这两种背景色一般是不同的， 这样输出图形或字符串时，两种背景（窗体或控件的背景色、符串或图形的背景色）重叠在一起了，影响美观，为了不让这两种背景重叠，可以设置背景模式为TRANSPARENT（透明的），即让输出的字符串或图形的背景色不可见。可以这样理解：把输出的字符串或图形的背景色看成是一物体，窗体或控件看成另一物体，字符串或图形在窗体或控件前面挡住窗体或控件了（因为输出 的字符串或图形是画在窗体或控件上的，所以可以这么类比），但是透过字符串或图形能看到窗体或控件。即字符串或图形的背 景色所代表的物体是透明的。
编辑本段
SetBkMode与SetBkColor理解


　　以前总不是太明白这几者之间的关系：SetBkMode, SetBkColor, wndclass.hbrBackground,
　　说实在的， 还是拿程序说话， 写个程序就能明白了……
　　我们以前一次的一个程序来说明：
　　/* 画笔练习程序, by netrookie, ChinaUnix.
　　* 请参考《windows程序设计》第五章：图形基础，画笔部分

详见：http://baike.baidu.com/view/1877315.htm

//---------------------------------------------------------------

SetTextColor()

函数名 SetTextColor()
　　功能 设置指定设备环境(HDC)的字体颜色
　　说明 Windows API函数
　　原型 WINGDIAPI COLORREF WINAPI SetTextColor (HDC, COLORREF)
　　也可以理解成 DWORD SetTextColor (HDC, DWORD),其中DWORD是关于颜色的参数，常用RGB()获取
　　例如：
　　SetTextColor(HDC,RGB(255,0,0));
　　当然设备环境(HDC)要通过BeginPaint(HWND,&PAINTSTRUCTURE)或GetDC(HWND)获得。
　　SetTextColor(int r [, int g, int b])
　　版本
　　1.3
　　内容
　　定义文字使用的颜色。可以使用RGB色彩或灰阶模式来定义。这个功能可以在一页之前建立，而且那个色彩值会保留在一页到另一页。
　　参数
　　r
　　若果g 和 b有提供数值，这个功能就是(红色的色彩)。如果没有提供任何数据在g 和 b，这个功能就是(灰阶的色彩). 数值为 0 至 255 之间。
　　g
　　绿色的色彩 (0 至 255 之间).
　　b
　　蓝色的色彩 (0 至 255 之间).

详见：http://baike.baidu.com/view/1751398.htm

//---------------------------------------------------------------