1：MessageBox

 函数功能：

MessageBox 函数用于显示一个模态对话框，其中包含一个系统图标、 一组按钮和一个简短的特定于应用程序消息，如状态或错误的信息。
    消息框中返回一个整数值，该值指示用户单击了哪个按钮。
API 函数原型：
注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选参数。

 int WINAPI MessageBox(

  _In_opt_  HWNDhWnd,

  _In_opt_  LPCTSTRlpText,

  _In_opt_  LPCTSTRlpCaption,

  _In_     UINT uType

);

参数解析：

参数

uType参数定义解析

返回值：

举例：
#include <windows.h>

 

int WINAPI WinMain(HINSTANCEhInstance, HINSTANCE hPrevInstance, PSTR szCmdLine, int iCmdShow)

{

       MessageBox(NULL, TEXT("这是我在鱼C学的第一个程序！"), TEXT("打招呼"), MB_OKCANCEL| MB_ICONQUESTION | MB_DEFBUTTON2);

       return 0;

}

 

 

1：MessageBox

    Windows的窗口总是基于窗口类来创建的，窗口类同时确定了处理窗口消息的窗口过程（回调函数）。

在创建应用程序窗口之前，必须调用 RegisterClass 函数来注册窗口类。该函数只需要一个参数，即指向 WNDCLASS 窗口类的指针。因为 WNDCLASS 类包含了窗口所拥有的基本属性。

结构原型：
typedef struct tagWNDCLASSW {

    UINT       style;

    WNDPROC    lpfnWndProc;

    int        cbClsExtra;

    int        cbWndExtra;

    HINSTANCE  hInstance;

    HICON      hIcon;

    HCURSOR    hCursor;

    HBRUSH     hbrBackground;

    LPCWSTR    lpszMenuName;

    LPCWSTR    lpszClassName;

} WNDCLASSW, *PWNDCLASSW, NEAR*NPWNDCLASSW, FAR *LPWNDCLASSW;

成员解析：

style 类风格解析

1：MessageBox

 

函数功能：

CreateWindow 函数创建一个重叠式窗口、弹出式窗口或子窗口。它指定窗口类，窗口标题，窗口风格，以及窗口的初始位置及大小（可选的）。函数也指该窗口的父窗口或所属窗口（如果存在的话），及窗口的菜单。

若要使用除 CreateWindow 函数支持的风格外的扩展风格，则使用 CreateWindowEx 函数代替 CreateWindow 函数。

API 函数原型：

注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选参数。

HWND WINAPI CreateWindow(

  _In_opt_  LPCTSTRlpClassName,    // 窗口类名称

  _In_opt_  LPCTSTRlpWindowName,   // 窗口标题

  _In_     DWORD dwStyle,          // 窗口风格，或称窗口格式

  _In_     int x,                 // 初始 x 坐标

  _In_     int y,                 // 初始 y 坐标

  _In_     int nWidth,            // 初始 x 方向尺寸

  _In_     int nHeight,           // 初始 y 方向尺寸

  _In_opt_  HWNDhWndParent,        // 父窗口句柄

  _In_opt_  HMENUhMenu,            // 窗口菜单句柄

  _In_opt_  HINSTANCEhInstance,    // 程序实例句柄

  _In_opt_  LPVOIDlpParam          // 创建参数

);

 

 

参数解析：

dwStyle 窗口风格解析

返回值：

1. 如果函数成功，返回值为新窗口的句柄；
2. 如果函数失败，返回值为 NULL。

 

4：ShowWindow

 

函数功能：

ShowWindow 函数用于设置指定窗口的显示状态。

 

应用程序第一次调用 ShowWindow 时，应该使用 WinMain 函数的 nCmdshow 参数作为它的 nCmdShow 参数。在随后调用 ShowWindow 函数时，必须使用下列显示方式中的一个给定值，而不是由 WinMain 函数的 nCmdSHow 参数指定的值。

API 函数原型：

BOOL WINAPI ShowWindow(

   _In_  HWNDhWnd,

  _In_  intnCmdShow

);

参数解析：

在随后的调用中，nCmdShow 参数可以为下列值之一：

返回值：
1. 如果窗口之前可见，则返回值为非 0；
2. 如果窗口之前被隐藏，则返回值为 0。

 

 

 

5： UpdateWindow__更新窗口

 

函数功能：

UpdateWindow 函数绕过应用程序的消息队列，直接发送 WM_PAINT 消息给指定窗口的窗口过程。

如果窗口更新的区域不为空，UpdateWindow 函数通过发送一个 WM_PAINT 消息来更新指定窗口的客户区。如果更新区域为空，则不发送消息。

API 函数原型：

BOOL UpdateWindow(

  _In_  HWNDhWnd

);

参数解析：

返回值：
1. 如果函数调用成功，返回值为非 0；
2. 如果函数调用不成功，返回值为 0。

UpdateWindow, WindowsSDK, WindowsAPI, SDK教程, UpdateWindow详解

 

 

 

6：MSG 消息结构

MSG 消息结构

在 Windows 程序中，消息是由 MSG 结构体来表示的。

结构原型：

typedef struct tagMSG {

  HWND  hwnd;

  UINT  message;

  WPARAM wParam;

  LPARAM lParam;

  DWORD  time;

  POINT  pt;

} MSG, *PMSG, *LPMSG;

 

成员解析：

 

 

 

7： GetMessage

 

函数功能：

GetMessage 函数的作用是从当前线程的消息队列里取出一个消息并填入 MSG结构 中。

 

该函数只能获取调用线程的消息，不能获得其他线程的消息。成功获取消息后，线程将从消息队列中删除该消息。如果消息队列为空，函数会一直等待直到有消息到来才有返回值。

API 函数原型：
BOOL WINAPI GetMessage(

  _Out_    LPMSG lpMsg,

  _In_opt_  HWNDhWnd,

  _In_     UINT wMsgFilterMin,

  _In_     UINT wMsgFilterMax

);

参数解析：

返回值：

1. 如果函数取得 WM_QUIT 之外的其他消息，返回非零值；
2. 如果函数取得 WM_QUIT 消息，返回值是零；
3. 如果出现了错误，返回值是 -1。

 

8：TranslateMessage

 

函数功能：

TranslateMessage 函数将虚拟键消息转换为字符消息，字符消息被寄送到当前线程的消息队列里。

当下一次线程调用函数 GetMessage 或PeekMessage 时被读出。

API 函数原型：

BOOL WINAPI TranslateMessage(

  _In_  constMSG *lpMsg

);

参数解析：

返回值：

1. 如果消息被转换（字符消息被寄送到当前线程的消息队列里）则返回非零值；
2. 如果消息是 WM_KEYDOWN，WM_KEYUPWM_SYSKEYDOWN 或 WM_SYSKEYUP，返回非零值，不考虑转换；
3. 如果消息没被转换（字符消息没被寄送到调用线程的消息队列里）则返回值是零。

 

9： DispatchMessage

 

函数功能：

DispatchMessage 函数分派一个消息给窗口过程（回调函数），通常该消息从 GetMessage 函数获得。Windows 的控制权在该函数交给了应用程序。

API 函数原型：

LRESULT WINAPIDispatchMessage(

  _In_  constMSG *lpmsg

);

参数解析：

返回值：
1. 返回值是窗口过程返回的值；
2. 尽管返回值的含义依赖于被分派的消息，但返回值通常被忽略。

备注：
1. MSG 结构必须包含有效的消息值。
2. 如果参数 lpmsg 指向一个 WM_TIMER 消息，并且 WM_TIMER 消息的参数 lParam 不为 NULL，则调用 lParam 指向的函数，而不是调用窗口程序。

 

 

10：PAINTSTRUCT 结构

PAINTSTRUCT 结构包含一些窗口过程用来对客户区进行绘制的信息。

结构原型：

typedef struct tagPAINTSTRUCT{

  HDC  hdc;

  BOOL fErase;

  RECT rcPaint;

  BOOL fRestore;

  BOOL fIncUpdate;

  BYTErgbReserved[32];

} PAINTSTRUCT, *PPAINTSTRUCT;

 

成员解析：

11：RECT 结构

RECT 结构定义了一个矩形的左上角和右下角的坐标。

结构原型：

typedef struct _RECT {

  LONG left;

  LONG top;

  LONG right;

  LONG bottom;

} RECT, *PRECT;

成员解析：

12：BeginPaint

 

函数功能：

BeginPaint 函数为指定窗口进行绘画工作的准备，并用将和绘画有关的信息填充到一个 PAINTSTRUCT结构中。

API 函数原型：

HDC BeginPaint(

  _In_  HWND hwnd,

  _Out_  LPPAINTSTRUCTlpPaint

);

参数解析：

返回值：
1. 如果函数成功，返回值是指定窗口的“显示设备描述表”句柄；
2. 如果函数失败，返回值是 NULL，表明没有得到显示设备的内容。

备注：
1. BeginPaint 函数自动设置显示设备内容的剪切区域，而排除任何更新区域外的区域。该更新区域可以通过 InvalidateRect 或 InvalidateRgn 函数设置，也可以是系统在改变大小、移动、创建、滚动后设置的，或者其他的影响客户区的操作来设置的。
2. 如果更新区域被标记为可擦除的，BeginPaint 发送一个 WM_ERASEBKGND 消息给窗口。
3. 一个应用程序除了响应 WM_PAINT 消息外，不应该调用 BeginPaint。
4. 每次调用 BeginPaint 都应该有相应的 EndPaint 函数。
5. 如果被绘画的客户区中有一个 caret（caret：插入符。是窗口客户区中的一个闪烁的线，块，或位图。插入符通常表示文本或图形将被插入的地方。即一闪一闪的光标），BeginPaint 自动隐藏该符号，而保证它不被擦除。
6. 如果窗口类有一个背景刷，BeginPaint 使用这个刷子来擦除更新区域的背景。

 

13：GetClientRect 

 

函数原型：

GetClientRect 函数用于获取窗口客户区的坐标，客户区坐标指定客户区的左上角和右下角。

由于客户区坐标是相对窗口客户区的左上角而言的，因此左上角坐标为（0，0）

API 函数原型：

BOOL WINAPI GetClientRect(

  _In_  HWND hWnd,

  _Out_  LPRECTlpRect

);

参数解析：

返回值：
1. 如果函数成功，返回值是非 0；
2. 如果函数失败，返回值是 0。

14：DrawText

 

函数原型：

DrawText 函数在指定的矩形里写入格式化的正文，根据指定的方法对正文格式化（扩展的制表符，字符对齐、折行等）。

需要指定更多的格式选项，可以使用 DrawTextEx 函数。


API 函数原型：

int DrawText(

  _In_    HDC hDC,

  _Inout_  LPCTSTRlpchText,

  _In_    int nCount,

  _Inout_  LPRECTlpRect,

  _In_    UINT uFormat

);

 

 

参数解析：

uFormat 参数各种标志解析

返回值：
1. 如果函数调用成功，返回值是正文的高度（逻辑单位）；
2. 如果指定了 DT_VCENTER 或 DT_BOTTOM，返回值是 lpRect -> top 到绘制的正文的底部的偏移值；
3. 如果函数调用失败，返回值是 0。

备注：

1. 函数 DrawText 用设备环境中的字体选择、正文颜色和背景颜色来写正文。
2. DrawText 裁剪正文，使之不会出现在指定矩形的外面，除非指定了 DT_NOCLIP。
3. 除非使用 DT_SINGLELINE 格式化，否则其余的格式都认为正文有多行。 
4. 如果选择的字体对指定的矩形而言太大，DrawText 并不会试图去换成一种小字体。
5. 设备环境的正文对齐方式必须包括 TA_LEFT, TA_TOP 和 TA_NOUPDATECP 标志。 

 

15：EndPaint

 

函数原型：

EndPaint 函数标记指定窗口的绘画过程结束。

这个函数在每次调用 BeginPaint 函数之后被调用（释放设备描述表），但仅仅在绘画完成以后。

API 函数原型：

BOOL EndPaint(

  _In_  HWNDhWnd,

  _In_  constPAINTSTRUCT *lpPaint

);

参数解析：

返回值：
    该函数返回值始终是非 0。

 

 

16：PostQuitMessage

 

函数原型：

PostQuitMessage 函数向系统表明有个线程有终止（退出）请求。这个函数通常用来响应WM_DESTROY 消息。

API 函数原型：

VOID WINAPI PostQuitMessage(

  _In_  intnExitCode

);

参数解析：

返回值： 该函数没有返回值。


备注：
1. PostQuitMessage 函数的功能是发送一个 WM_QUIT 消息给线程的消息队列并立即返回。
2. 当线程从消息队列里取得 WM_QUIT 消息时，应当退出消息循环并将返回系统，返回给系统的退出值必须是消息WM_QUIT 的 wParam 参数（所以 WinMain 函数的返回值是 msg.wParam）。

 

17：DefWindowProc

 

函数功能：

DefWindowProc 函数调用缺省的窗口过程来处理那些窗口过程没有处理的任何消息，该函数是为了确保每个消息都被处理。
   DefWindowProc函数传入和窗口过程同样的参数。

API 函数原型：

LRESULT WINAPI DefWindowProc(

  _In_  HWNDhWnd,

  _In_  UINTMsg,

  _In_  WPARAMwParam,

  _In_  LPARAMlParam

);

 

参数解析：

返回值：
1. 返回值就是消息处理结果，它取决于发送的消息。

 

 

18： DestroyWindow 

 

函数功能：

DestroyWindow 用于销毁一个指定的窗口，该函数通过发送 WM_DESTROY 消息和 WM_NCDESTROY 消息使窗口无效并移除其键盘焦点。

DestroyWindow 函数还销毁窗口的菜单，清空线程的消息队列，销毁与窗口过程相关的定时器，解除窗口对剪贴板的拥有权，打断剪贴板器的查看链。

如果指定的窗口拥有子窗口或拥有其它窗口，该函数将自动先销毁其子窗口或所拥有的窗口，然后再销毁自身。


API 函数原型：

BOOL WINAPI DestroyWindow(

  _In_  HWNDhWnd

);

 

参数解析：

返回值：
1. 如果函数成功执行，返回值为非 0；
2. 如果函数执行失败，返回值为 0。

备注：
1. 一个线程不能使用本函数销毁别的线程创建的窗口。
2. 如果这个窗口是一个不具有 WS_EX_NOPARENTNOTIFY 样式的子窗口，则销毁窗口时将发WM_PARENTNOTIFY 消息给其父窗口。

 

19：TextOut

 

函数功能：

TextOut 函数使用当前选择的字体、背景颜色和文本颜色，将一个字符串绘画于窗口的指定位置。

API 函数原型：

注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选参数。

BOOL TextOut(

  _In_  HDChdc,

  _In_  intnXStart,

  _In_  intnYStart,

  _In_  LPCTSTRlpString,

  _In_  intcchString

);

参数解析：

返回值：
1. 如果函数调用成功，返回值为非 0；
2. 如果函数调用失败，返回值为 0。

备注：字符串对齐的基准点取决于当前的文本对齐模式。应用程序可以通过调用 GetTextAlign 获得当前的文本对齐模式，通过调用SetTextAlign 修改该模式。

 

 

20：GetTextAlign

 

GetTextAlign 函数获得指定的设备环境下的文字对齐方式的设置。

API 函数原型：

注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选参数。

UINT GetTextAlign(

  _In_  HDChdc

);

参数解析：

返回值：
1. 如果函数调用失败，返回值是 GDI_ERROR；
2. 如果函数调用成功，返回值是文字对齐标志的状态。

该返回值是下列值的组合：

 

若当前字体有一条缺省的垂直基线（如Kanji），下列值用于取代 TA_BASELINE 和 TA_CENTER：

备注：
1. 默认值是 TA_LEFT, TA_TOP 和 TA_NOUPDATECP
2. 限定矩形是指能将正文字符串的所有字符单元限定于其中的矩形
3. 限定矩形的尺寸可通过调用 GetTextExtentPoint32 来获得
4. 文字对齐标志决定 TextOut 和 ExtTextOut 如何将正文字符串与基准点对齐
5. 文字对齐标志不必是单个的标志位，可以等于0
6. 标志必须按相关的组来检查，如下：
    TA_LEFT, TA_RIGHT, andTA_CENTER

TA_BOTTOM, TA_TOP, and TA_BASELINE

TA_NOUPDATECP and TA_UPDATECP

如果当前字体有缺省的垂直基线，相关的标志如下所示：
    TA_LEFT, TA_RIGHT, andVTA_BASELINE

TA_BOTTOM, TA_TOP, and VTA_CENTER

TA_NOUPDATECP and TA_UPDATECP

7. 要验证一个特定的标志在返回值中被设置，应用程序必须执行以下步骤：
（例子：如何设置文本对齐模式）
    对该标志及其相关标志实施位OR操作；

对结果和返回值实施位AND操作；

检查结果值和标志是否相等。

 

21：SetTextAlign

 

函数功能：

SetTextAlign 函数为指定设备环境设置文字的对齐标志。

API 函数原型：

UINT SetTextAlign(

  _In_  HDChdc,

  _In_  UINTfMode

);

参数解析：

使用下面的列表中的掩码指定文本对齐方式：

若当前字体有一条缺省的垂直基线（如Kanji），下列值用于取代 TA_BASELINE 和 TA_CENTER：

默认值是TA_LEFT, TA_TOP 和 TA_NOUPDATECP。

返回值：
1. 如果函数调用失败，返回值是 GDI_ERROR；
2. 如果函数调用成功，返回值是文字对齐方式的前一个设置。

备注：
1. 限定矩形是指能将正文字符串的所有字符单元限定于其中的矩形
2. TextOut 和 ExtTextOut 函数用文字对齐标志来将一个正文字符串定位于显示器或者其他设备
3. 该标志指定了基准点与限定正文的矩形的位置关系，基准点可以是当前位置，也可是传给正文输出函数的一个点
4. 设置左对齐文本的做好方法可以是如下：

SetTextAlign (hdc, GetTextAlign(hdc) & (~TA_CENTER))

或者

SetTextAlign (hdc,TA_LEFT | <other flags>)

 

你当然可以使用 SetTextAlign (hdc, TA_LEFT) 来达到这个目的，但是这个方法会丢失所有的垂直基线或者从右到左的设置。
5. 调用 SetTextAlign 函数时，如果使用 TA_UPDATECP 标志，Windows 会忽略 TextOut 的 xStart 和 yStart 参数，而使用由 MoveToEx、LineTo 或更改目前位置的另一个函数设定的位置。

 

 

 

 

22：wsprintf

 

函数功能：

wsprintf 函数用于把数据格式化写入到指定的缓冲区里，输出缓冲区里的的值取决于格式说明符（即"%"），如果写入的是文字，此函数给写入的文字的末尾追加一个‘\0‘，函数的返回值是写入的长度，但不包括最后的‘\0‘

 

注意：实际编程中不要再使用该函数，请使用 StringCchPrintf 或StringCbPrint 代替。

API 函数原型：

int __cdecl wsprintf(

  _Out_  LPTSTRlpOut,

  _In_  LPCTSTR lpFmt,

  _In_   ...

);

 

参数解析：

返回值：
1. 如果函数调用成功，返回值与计划写入缓冲区的字符个数相等（不包含最后的‘\0‘）；
2. 如果函数调用失败，返回值小于计划写入缓冲区的字符个数，可通过调用 GetLastError 获取详细的错误信息。

 

 

23：StringCchPrintf

 

函数功能：

StringCchPrintf 函数用于把数据格式化写入到指定的缓冲区里，该函数要求提供目标缓冲区的大小，确保不会发生越界访问。

微软推荐使用该函数替代以下函数：

sprintf, swprintf, _stprintf

wsprintf

wnsprintf

_snprintf, _snwprintf,_sntprintf

API 函数原型：

HRESULT StringCchPrintf(

  _Out_  LPTSTRpszDest,

  _In_  size_t cchDest,

  _In_  LPCTSTR pszFormat,

  _In_  ...

);

 

参数解析：

返回值：

这个函数返回一个 HRESULT，而不是像 sprintf 一样返回存储在其目标缓冲区的字节数。我们强烈建议您使用 SUCCEEDED和 FAILED 宏来测试这个函数的返回值。

返回值可以是以下任意一个值：

备注：

使用 StringCchPrintf 函数需要添加头文件：strsafe.h



代码演示：

#include "strsafe.h"

 

......

 

TCHAR pszDest[30]; 

size_t cchDest = 30;

LPCTSTR pszFormat =TEXT("从你家到鱼C工作室需要 %f 公里！");

HRESULT hr =StringCchPrintf(pszDest, cchDest, pszFormat, 123.45);

 

......

 

 

 

24：strlen

 

函数功能：

lstrlen 函数用于计算指定字符串的长度（不包含‘\0），注意：实际编程中不要再使用该函数，请使用 StringCchLength 或StringCbLength 代替。
API 函数原型：
int WINAPI lstrlen(

  _In_  LPCTSTRlpString

);

参数解析：

返回值：
1. 该函数返回指定字符串的字符数；
2. 如果是空字符串，则返回 0。

安全建议：

错误的使用 lstrlen 函数将可能会危害到应用程序的安全：lstrlen 函数假定 lpString 参数是以‘\0‘结尾的字符串，如果事实上传入的参数不按套路出牌，则会造成缓冲区溢出，最终导致程序无法按照期望正常运行。

 

 

25：SUCCEEDED 和 FAILED 宏

 

宏功能：

SUCCEEDED 宏表示测试成功，FAILED 宏表示测试失败。

宏定义：

#define  SUCCEEDED(hr)  (((HRESULT)(hr))>= 0)

#define  FAILED(hr)  (((HRESULT)(hr))< 0)

参数解析：

返回值：
1. 如果 hr 的值大于等于 0，则结果为TRUE；
2. 如果 hr 的值小于 0，则结果为FALSE。

 

 

 

26：StringCchLength

 

函数功能：

StringCchLength 函数用于确定字符串是否超过了规定的长度，以字符为计算单位。

微软推荐使用该函数替代以下函数：

strlen, wcslen, _tcslen

API 函数原型：

HRESULT StringCchLength(

  _In_  LPCTSTR psz,

  _In_  size_t cchMax,

  _Out_  size_t*pcch

);

 

参数解析：

返回值：

这个函数返回一个 HRESULT，而不是指定字符串的字符个数。我们强烈建议您使用 SUCCEEDED 和 FAILED 宏来测试这个函数的返回值。

返回值可以是以下任意一个值：

备注：
1. 对比 StringCchLength 所替代的函数，StringCchLength 是可以使你的代码正确处理缓存区的一个附加功能。因为小的缓冲处理会牵连很多安全问题，例如缓存区溢出
2. 使用 StringCchLength 函数需要添加头文件：strsafe.h

 

 

 

27：StringCchCat 

 

函数功能：

StringCchCat 函数的功能是将一个字符串拼接到另一个字符串。StringCchCat 函数要求提供目标缓冲区的长度，以确保写入数据不会超出缓冲区的末尾。

微软推荐使用该函数替代以下函数：

strcat, wcscat, _tcsat

lstrcat

StrCat

StrCatBuff

API 函数原型：

HRESULT StringCchCat(

  _Inout_  LPTSTRpszDest,

  _In_    size_t cchDest,

  _In_    LPCTSTR pszSrc

);

参数解析：

返回值：
    这个函数返回一个 HRESULT，而不是拼接好的字符串指针。我们强烈建议您使用 SUCCEEDED 和 FAILED 宏来测试这个函数的返回值。

返回值可以是以下任意一个值：

28： lstrcat

函数功能：

lstrcat 函数的功能是将一个字符串拼接在另一个字符串后边。

注意：实际编程中不要再使用该函数，请使用 StringCchCat 代替。


API 函数原型：

LPTSTR WINAPI lstrcat(

  _Inout_  LPTSTRlpString1,

  _In_    LPTSTR lpString2

);

参数解析：

返回值：
1. 如果函数调用成功，返回指向拼接好的字符串指针；
2. 如果函数调用失败，返回值为 NULL，并且 lpString1 可能会变成非 ‘\0‘ 结束的字符串。
安全建议：
1. 不正确的使用 lstrcat 函数，可能会损害应用程序的安全性
2. lstrcat 函数使用结构化异常处理（SEH）来捕捉访问冲突和其他错误。当该函数捕获 SEH 错误，如果没有以‘\0‘结尾的字符串，则返回 NULL，且不把错误通知调用者。因此，把空间不足作为错误的条件是不安全的
3. lpString1 必须足够大，以增加 lpString2 和结束‘\0‘，否则可能发生缓冲区溢出
4. 在最坏的情况下，缓冲区溢出可能允许攻击者可执行代码注入到你的进程，尤其是当 lpString1 是一个基于堆栈的缓冲区

29：StringCchCopy

 

函数功能：

StringCchCopy 函数的功能是复制一个字符串到缓冲区。StringCchCopy 函数要求提供目标缓冲区的长度，以确保写入数据不会超出缓冲区的末尾。

微软推荐使用该函数替代以下函数：

strcpy, wcscpy, _tcscpy

lstrcpy

StrCpy

API 函数原型：

HRESULT StringCchCopy(

  _Out_  LPTSTRpszDest,

  _In_  size_t cchDest,

  _In_  LPCTSTR pszSrc

);

参数解析：

返回值：

这个函数返回一个 HRESULT，而不是指向缓冲区的指针。我们强烈建议您使用 SUCCEEDED 和 FAILED 宏来测试这个函数的返回值。

返回值可以是以下任意一个值：

 

30：lstrcpy

 

函数功能：

lstrcpy 函数的功能是复制一个字符串到缓冲区。

注意：实际编程中不要再使用该函数，请使用 StringCchCopy 代替。


API 函数原型：

LPTSTR WINAPI lstrcpy(

  _Out_  LPTSTRlpString1,

  _In_  LPTSTR lpString2

);

 

参数解析：

返回值：
1. 如果函数调用成功，返回指向缓冲区的指针；
2. 如果函数调用失败，返回值是 NULL，并且 lpString1 可能会变成非 ‘\0‘ 结束的字符串。

安全建议：

1. 不正确的使用 lstcpy 函数，可能会损害应用程序的安全性
2. lstrcpy 函数使用结构化异常处理（SEH）来捕捉访问冲突和其他错误。当该函数捕获 SEH 错误，如果没有以‘\0‘结尾的字符串，则返回 NULL，且不把错误通知调用者。因此，把空间不足作为错误的条件是不安全的
3. lpString1 必须足够大，以增加 lpString2 和结束‘\0‘，否则可能发生缓冲区溢出
4. 在最坏的情况下，缓冲区溢出可能允许攻击者可执行代码注入到你的进程，尤其是当 lpString1 是一个基于堆栈的缓冲区

 

 

31：GET_X_LPARAM和 GET_Y_LPARAM 宏

 

宏功能：

通过 lParam 参数获得相关消息触发的坐标 (x , y)

宏定义：

#define LOWORD(lp)          ((WORD)(((DWORD_PTR)(lp)) &0xffff))

#define HIWORD(lp)          ((WORD)((((DWORD_PTR)(lp)) >>16) & 0xffff))

 

#define GET_X_LPARAM(lParam)        ((int)(short)LOWORD(lParam))

#define GET_Y_LPARAM(lParam)        ((int)(short)HIWORD(lParam))

 

参数解析：

返回值：
1. GET_X_LPARAM(lParam) 返回坐标的 x 值；
2. GET_Y_LPARAM(lParam) 返回坐标的 y 值。

重要备注：
1. 使用该宏需要包含头文件：windowsx.h。
2. 不要再使用 LOWORD 和 HIWORD 去获取鼠标的坐标了，因为在多显示器的情况下会得到错误的坐标。

 

32：TEXTMETRIC 结构

 

TEXTMETRIC 结构

TEXTMETRIC 结构记录当前设备环境中有关字体的各种信息。

TEXTMETRIC 结构成员的值的单位取决于设备环境中当前选定的映射模式，默认的映射模式是MM_TEXT，所以它们的值是以像素为单位的。

结构原型：

typedef struct tagTEXTMETRIC

{

  LONG  tmHeight;

  LONG  tmAscent;

  LONG  tmDescent;

  LONG  tmInternalLeading;

  LONG  tmExternalLeading;

  LONG  tmAveCharWidth;

  LONG  tmMaxCharWidth;

  LONG  tmWeight;

  LONG  tmOverhang;

  LONG  tmDigitizedAspectX;

  LONG  tmDigitizedAspectY;

  TCHAR tmFirstChar;

  TCHAR tmLastChar;

  TCHAR tmDefaultChar;

  TCHAR tmBreakChar;

  BYTE  tmItalic;

  BYTE  tmUnderlined;

  BYTE  tmStruckOut;

  BYTE  tmPitchAndFamily;

  BYTE  tmCharSet;

} TEXTMETRIC, *PTEXTMETRIC;

成员解析：

 

 

33： GetTextMetrics

 

函数功能：

GetTextMetrics 函数将当前字体的信息填充到指定缓冲区（TEXTMETRIC结构）

API 函数原型：

BOOL GetTextMetrics(

  _In_  HDC hdc,

  _Out_  LPTEXTMETRIClptm

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是非 0；
2. 如果函数调用失败，返回值是 0。


备注：
1. 要确定一种字体是否为 TrueType 字体，可以通过调用 GetTextMetrics 函数，然后检查TEXTMETRIC.tmPitchAndFamily 的值是否为 TMPF_TRUETYPE
2. 注意，调用 GetDC 函数返回的是一个未初始化的 DC，它具有“系统”（一个位图字体）作为默认字体。因此你需要先选择一种字体到 DC

 

34：GetSystemMetrics

 

函数功能：

GetSystemMetrics 函数返回 Windows 中各种图形项（图标、鼠标指针、标题栏和滚动条等）的尺寸信息。

在不同的显卡和驱动中，这些尺寸是不一样的，为了在程序中做到与设备无关的图形输出，GetSystemMetrics是一个很重要的函数。

注意：GetSystemMetrics 函数获取的所有尺寸均以像素为单位。

API 函数原型：

注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选参数。

int WINAPI GetSystemMetrics(

  _In_  intnIndex

);

参数解析：

nIndex 参数是一个索引值，可以是以下列表中任意一个：

注意：

所有 SM_CX* 开头表示宽（横向），SM_CY* 开头表示高（纵向），如果是返回布尔类型的数据，用非 0 值表示 TRUE，用 0 表示 FALSE

注释：括号内代表宏的值

 

 

返回值：

1. 如果函数调用成功，返回值索引参数对应的配置信息；

2. 如果函数调用失败，返回值是 0。

 

 

 

 

 

35：SetScrollRange

 

函数功能：

SetScrollRange 函数设置所指定滚动条范围的最小值和最大值。

注意：SetScrollRange 函数提供了向后的兼容性。但新的应用程序应该提倡使用 SetScrollInfo 函数代替。

API 函数原型：
注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选参数。

BOOL SetScrollRange(

  _In_  HWNDhWnd,

  _In_  intnBar,

  _In_  intnMinPos,

  _In_  intnMaxPos,

  _In_  BOOLbRedraw

);

 

参数解析：

返回值：
1. 如果函数调用成功，返回值为非 0；
2. 如果函数调用失败，返回值为 0。

备注：
1. 将 SetScrollRange 函数中的 nMinPos 和 nMaxPos 参数设置为一样的值，可以达到隐藏滚动条的目的。但在处理滚动条消息时，应用程序不应该调用 SetScrollRange 函数来隐藏滚动条。新的应用程序应该调用ShowScrollBar 函数来隐藏滚动条。

2. 如果调用 SetScrollPos 函数之后马上调用 SetScrollRange 函数，则 SetScrollPos 函数中的 bRedraw 参数一定要设置为零值（FALSE），以防止滚动条被画两次。

 

3. 标准滚动条的缺省范围是 0 到100。滚动条控件的缺省值为 NULL（参数 nMinPos 和 nMaxPos 的值均为零）。两个范围值之间的不同之处在于由参数 nMinPos 和 nMaxPos 指定，不过不能超过 MAXLONG 定义的大小。

4. 因为说明滚动条位置的消息 WM_HSCROLL 和 WM_VSCROLL 是 16 位数据，所以那些只依赖于说明位置数据消息的应用程序在SetScrollRange 函数的参数 nMaxPos 中有一个实际最大值 65,535。但是，因为 SetScrolllnfo，SetScrollPos， SetScrollRange，GetScrolllnfo，GetScrollPos 和 GetScrollRange 函数都支持 32 位的滚动条位置数据，所以有一个解决 16 位 WM_HSCROLL 和WM_VSCROLL 消息阻碍的途径，请参见函数 GetScrolllnfo 的有关技术说明。

5. 如果参数 nBar 设置为 SB_CTL 并且参数 hWnd 所标识的不是一个标准的滚动条控件。系统将发送一个 SBM_SETRANGE 消息到窗体用以设置滚动条消息。这将允许 SetScrollRange 函数操作一个定制的伪滚动条控件。如果窗体没有处理SBM_SETRANGE 消息，SetScrollRange 函数将调用失败。

 

 

36：GetScrollPos

 

函数功能：

GetScrollPos 函数获取指定滚动条中滚动按钮的当前位置。当前位置是一个根据当前滚动范围而定的相对值。例如，如果滚动范围是 0~10，滚动按钮恰好在中间的位置，则其当前位置就为 50。

注意：该函数提供了向后兼容性，新的应用程序应该使用 GetScrollInfo 函数代替。


API 函数原型：

注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选参数。

int GetScrollPos(

  _In_  HWNDhWnd,

  _In_  intnBar

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是指定滚动条的当前位置；
2. 如果函数调用失败，返回值是 0。

备注：
1. GetScrollPos 函数可以使应用程序使用 32 位数据的滚动位置。尽管消息 WM_HSCROLL 和 WM_VSCROLL 只支持 16 位的数据，而 SetScrollPos，SetScrollRange，GetScrollPos 和 GetscrollRange 函数都支持 32 位的滚动条数据，因此，应用程序在处理任 WM_HSCROLL 或 WM_VSCROLL 消息时可以调用 GetScrollPos 函数来获得 32 位数据的滚动条位。

2. 为了获得在一个 WM_HSCROLL 或 WM_VSCROLL 消息的 SB_THUMBTRACK 请求码的滚动框（滑块）的 32位数据的位置，请使用 GetScrollInfo 函数。

 

 

 

 

37：GetScrollRange

 

函数功能：

GetScrollRange 函数获得指定滚动条的范围。

注意：GetScrollRange 函数提供了向后的兼容性。但新的应用程序应该提倡使用 GetScrollInfo 函数代替。

API 函数原型：
注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选参数。

BOOL GetScrollRange(

  _In_  HWND hWnd,

  _In_  int nBar,

  _Out_  LPINTlpMinPos,

  _Out_  LPINTlpMaxPos

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是非 0；
2. 如果函数调用失败，返回值是 0。


备注：
1. 如果指定的窗口没有标准的滚动条或不是滚动条控件，GetScrollRange 函数将零复制到 lpMinPos 和 lpMaxPos 参数中。

2. 标准滚动条的默认范围是 0 到 100。滚动条控件的缺省值为空。

3. 因为说明滚动条位置的消息 WM_HSCROLL 和 WM_VSCROLL 是 16 位数据，所以那些只依赖于说明位置数据消息的应用程序在SetScrollRange 函数的参数 nMaxPos 中有一个实际最大值 65,535。但是，因为 SetScrolllnfo，SetScrollPos， SetScrollRange，GetScrolllnfo，GetScrollPos 和 GetScrollRange 函数都支持 32 位的滚动条位置数据，所以有一个解决 16 位 WM_HSCROLL 和WM_VSCROLL 消息阻碍的途径，请参见函数 GetScrolllnfo 的有关技术说明。

4. 如果参数 nBar 设置为 SB_CTL 并且参数 hWnd 所标识的不是一个标准的滚动条控件。系统将发送一个 SBM_GETRANGE 消息到窗体用以设置滚动条消息。这将允许 GetScrollRange 函数操作一个定制的伪滚动条控件。如果窗体没有处理SBM_GETRANGE 消息，GetScrollRange 函数将调用失败。

 

 

 

 

 

 

 

38： LOWORD和 HIWORD 宏

 

宏功能：

获得指定 32 位数据的低 16位数据和高 16 位数据。

 

小甲鱼温馨提醒：不要使用 LOWORD 和 HIWORD 宏去获取鼠标的坐标，因为在多显示器的情况下会得到错误的坐标。应该使用 GET_X_LPARAM和 GET_Y_LPARAM 宏来获取。


宏定义：

#define LOWORD(lParam)     ((WORD)(((DWORD_PTR)(lParam)) & 0xffff))

#define HIWORD(lParam)     ((WORD)((((DWORD_PTR)(lParam)) >> 16) & 0xffff))

参数解析：

返回值：
1. LOWORD(lParam) 返回 lParam 的低16 位数据；
2. HIWORD(lParam) 返回 lParam 的高16 位数据。

39： WM_SIZE消息

 

消息含义：

当主窗口的客户区部分大小改变时，操作系统将给应用程序发送 WM_SIZE 消息。

应用程序通过窗口过程接收该消息（请关注：《Windows程序设计（SDK）》视频教学）。

消息定义：

#define WM_SIZE                       0x0005

 

参数解析：

wParam：指出窗口的新状态
wParam 参数可以是下列值之一：

lParam：指出当前客户区的大小（宽度和高度）

1. lParam 参数的低 16 位指定了新窗口的宽度；

2. lParam 参数的高 16 位制定了新窗口的高度。

 

小甲鱼温馨提醒：可以通过 LOWORD宏和 HIWORD宏来获取 lParam 参数的低 16 位和高16 位。


返回值：
1. 如果窗口过程响应该消息，必须返回 0。

 

 

40：WM_VSCROLL消息

 

消息含义：

当窗口的标准垂直滚动条有滚动事件发生时，操作系统向窗口的消息队列投入一条WM_VSCROLL 消息。

此消息也适用于触发垂直滚动条控件。

应用程序通过窗口过程接收该消息（请关注：《Windows程序设计（SDK）》视频教学）。

消息定义：

#define WM_VSCROLL                    0x0115

参数解析：

wParam：当 LOWORD(wParam) 的结果（取低 16 位）为SB_THUMBPOSITION 或 SB_THUMBTRACK 时，HIWORD(wParam) 的值（取高 16 位）是当前滑块在滚动框的位置。

小甲鱼温馨提示：

当 wParam 的低 16 位的值是 SB_THUMBTRACK 时，wParam 的高 16 位是用户拖动滑块的当前位置

当 wParam 的低 16 位的值是 SB_THUMBPOSITION 时，wParam 的高 16 位是用户松开鼠标按键时滑块的最终位置

对于其他的滚动操作，wParam 的高 16 位应该被忽略

LOWORD(wParam) 的结果（取低 16 位）代表了鼠标在滚动条上的动作，这个值被称之为“通知码”，由一个以“SB”开头的标识符定义。

该通知码是下列值之一：

lParam：如果该参数等于 0，说明它是标准的窗口滚动条；如果该参数等于滚动条窗口句柄，说明它是滚动条控件。

返回值：
1. 如果窗口过程响应该消息，必须返回 0。

 

 

 

41：WM_HSCROLL消息

 

消息含义：

当窗口的标准水平滚动条有滚动事件发生时，操作系统向窗口的消息队列投入一条WM_HSCROLL 消息。

此消息也适用于触发水平滚动条控件。

应用程序通过窗口过程接收该消息（请关注：《Windows程序设计（SDK）》视频教学）。


消息定义：

#define WM_HSCROLL                    0x0114

参数解析：

wParam：wParam：当 LOWORD(wParam) 的结果（取低 16 位）为SB_THUMBPOSITION 或 SB_THUMBTRACK 时，HIWORD(wParam) 的值（取高 16 位）是当前滑块在滚动框的位置。

小甲鱼温馨提示：

当 wParam 的低 16 位的值是 SB_THUMBTRACK 时，wParam 的高 16 位是用户拖动滑块的当前位置

当 wParam 的低 16 位的值是 SB_THUMBPOSITION 时，wParam 的高 16 位是用户松开鼠标按键时滑块的最终位置

对于其他的滚动操作，wParam 的高 16 位应该被忽略

LOWORD(wParam) 的结果（取低 16 位）代表了鼠标在滚动条上的动作，这个值被称之为“通知码”，由一个以“SB”开头的标识符定义。

该通知码是下列值之一：

lParam：如果该参数等于 0，说明它是标准的窗口滚动条；如果该参数等于滚动条窗口句柄，说明它是滚动条控件。

返回值：
1. 如果窗口过程响应该消息，必须返回 0。

 

 

 

42：InvalidateRect

 

函数功能：

InvalidateRect 函数向指定的窗体更新区域添加一个矩形，然后窗口客户区域的这一部分将被重新绘制。

API 函数原型：

注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选参数。

BOOL InvalidateRect(

  _In_  HWNDhWnd,

  _In_  constRECT *lpRect,

  _In_  BOOLbErase

);

参数解析：

返回值：

1. 如果函数调用成功，返回值是非 0；

2. 如果函数调用失败，返回值是 0。


备注：

1. 在下一个 WM_PAINT 消息产生前，所有 ValidateRect 或 ValidateRgn 函数产生的更新区域会被拼接成一个大的更新区域。
2. 当更新区域不为空并且窗口的消息队列中没有其他消息，系统向窗口过程发送 WM_PAINT 消息，令其重绘。
3. 如果任何一个更新区域的 bErase 参数为 TRUE，整个背景会被擦除重绘。

 

 

 

 

43：SCROLLINFO结构

 

SetScrollInfo 函数通过 SCROLLINFO 结构设置滚动条参数（或者 SBM_SETSCROLLINFO 消息），GetScrollInfo 函数也通过 SCROLLINFO 结构获得滚动条参数（或者 SBM_GETSCROLLINFO 消息）。

结构原型：

typedef struct tagSCROLLINFO {

  UINT cbSize;

  UINT fMask;

  int  nMin;

  int  nMax;

  UINT nPage;

  int  nPos;

  int  nTrackPos;

} SCROLLINFO, *LPCSCROLLINFO;

成员解析：

如在使用上有任何不同，可以参考小甲鱼的《Windows程序设计（SDK）》第 14 讲：滚动条3

 

 

 

 

 

44：SetScrollInfo

 

函数功能：

SetScrollInfo 函数用于设置滚动条的参数，其中包括：滚动范围的最小值和最大值，页面的大小，以及滑块的位置。如果需要，该函数还可以重绘滚动条。

API 函数原型：

int SetScrollInfo(

  _In_  HWNDhwnd,

  _In_  intfnBar,

  _In_  LPCSCROLLINFOlpsi,

  _In_  BOOLfRedraw

);

参数解析：

返回值
SetScrollInfo 函数的返回值是滚动按钮的当前位置。

备注：

SetScrollInfo 函数将会检查 SCROLLINFO结构中的 nPage 和 nPos 两个成员的值的范围（nPage 成员的值必须是 0 ~ nMax-nMin+1；nPos 成员的值必须是在 nMin 到 nMax - max(nPage-1, 0) 之间），如果任何一个值超过了范围，函数将在指定范围内为它设置一个值。

如在使用上有任何不同，可以参考小甲鱼的《Windows程序设计（SDK）》第 14 讲：滚动条3

 

 

 

 

45： GetScrollInfo

 

函数功能：

GetScrollInfo 函数用于获取滚动条的参数，其中包括：滚动范围的最小值和最大值，页面的大小，以及滑块的位置。

API 函数原型：

BOOL GetScrollInfo(

  _In_    HWND hwnd,

  _In_    int fnBar,

  _Inout_  LPSCROLLINFOlpsi

);

参数解析：

返回值：

1. 如果函数成功获取滚动条的参数，则返回值是非 0；
2. 如果函数没有获取滚动条的参数，则返回值是 0。

备注：
1. 尽管滚动条消息 WM_HSCROLL 和 WM_VSCROLL 可以通过 HIWORD(wParam) 取得滚动条的位置（当 LOWORD(wParam) 通知码为 SB_THUMBPOSITION 和 SB_THUMBTRACK 的时候），但得到是 16 位的滚动条位置。如果想要得到 32 位的滚动条数据，可以使用 GetScrollInfo 函数。

2. 为了在 WM_HSCROLL 或 WM_VSCROLL 的 SB_THUMBTRACK 通知码中获得滚动条滑块的 32 位的位置，可以通过调用 GetScrollInfo 函数并设置 SCROLLINFO结构 fMask 成员的值为 SIF_TRACKPOS 实现。GetScrollInfo 函数将滚动条滑块的位置存放在 SCROLLINFO 结构的 nTrackPos 成员中。这将使得用户在移动滑块时你可以及时获得滑块的位置。

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。

示例：

SCROLLINFO si;

case WM_HSCROLL:

   switch(LOWORD(wparam)) {

       case SB_THUMBTRACK:

         // Initialize SCROLLINFO structure

 

           ZeroMemory(&si, sizeof(si));

           si.cbSize = sizeof(si);

           si.fMask = SIF_TRACKPOS;

 

         // Call GetScrollInfo to get current tracking 

         //    position in si.nTrackPos

 

           if (!GetScrollInfo(hwnd, SB_HORZ, &si) )

               return 1; // GetScrollInfo failed

           break;

       .

       .

       .

    }

 

如在使用上有任何不同，可以参考小甲鱼的《Windows程序设计（SDK）》第 14 讲：滚动条3

 

 

 

 

46：ScrollWindow

函数功能：

ScrollWindow 函数滚动指定窗口的客户区内容。

注意：该函数提供了向后兼容性，新的应用程序应该使用 ScrollWindowsEx 函数代替。

API 函数原型：

注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选参数。

 

BOOL ScrollWindow(

  _In_  HWNDhWnd,

  _In_  intXAmount,

  _In_  intYAmount,

  _In_  constRECT *lpRect,

  _In_  constRECT *lpClipRect

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是非 0；
2. 如果函数调用失败，返回值是 0。


备注：

1. 如果在被滚动的窗口中含有插入符，ScrollWindow 函数将自动隐藏插入符，以防它被擦掉。当滚动结束后再恢复插入符，插入符的位置相应的被调整。

2. 未被 ScrollWindow 函数覆盖的区域不会被重绘，但该区域会与窗口更新区域组合，当应用程序最终收到 WM_PAINT 的消息时，组合区域统一重绘。为了在滚动操作的同时重画未覆盖区域，则应在调用 ScrollWindow 函数后马上调用UpdateWindow 函数。

3. 如果 lpRect 参数的值为 NULL，则窗口中的任何子窗口的位置由参数 XAmount 和 Yamount 的数值决定移动距离；窗口中无效的区域（未重绘）也会移动。

4. 当 lpRect 参数为 NULL 时，ScrollWindow函数可以执行得更快。

5. 如果 lpRect 参数不为 NULL，则窗口中的子窗口的位置不改变，窗口中无效的区域（未重绘）也不移动。为了防止 lpRect 参数不为 NULL 时更新的问题，需要在调用 ScrollWindow 函数前调用 UpdateWindow 函数重绘窗口。

/*-------------------------------------------------------------------

                【API档案】ScrollWindow 函数使用例子

                    鱼C工作室 -- www.fishc.com

--------------------------------------------------------------------*/

LRESULT CALLBACK WndProc(HWNDhwnd, UINT message, WPARAM wParam, LPARAM lParam)

{

       HDC hdc;

       PAINTSTRUCT ps;

       TEXTMETRIC tm;

       SCROLLINFO si;

 

       static int xClient;     // 客户区的宽度

       static int yClient;     // 客户区的高度

       static int xClientMax;  // 客户区内容显示的最大宽度（超过此宽度则加入滚动条）

 

       static int xChar;       // 字体的平均水平宽度

       static int yChar;       // 字体的垂直高度

       static int xUpper;      // 字体的大写字符的水平宽度

 

       static int xPos;        // 当前水平滚动条滑块的位置

       static int yPos;        // 当前垂直滚动条滑块的位置

 

       int i;                 // 循环计数器

       int x, y;              // 水平和垂直的坐标

 

       int FirstLine;          // 失效区域的第一行（需重绘的第一行）

       int LastLine;          // 失效区域的最后一行（（需重绘的最后一行））

       HRESULT hr;

       size_t abcLength;       // 用于存放 abc 数组的长度

 

       // 创建要显示的行（呃，打印的内容我就不翻译了吧...）

       #define LINES 28 

       static TCHAR *abc[] = {

               TEXT("anteater"),TEXT("bear"), TEXT("cougar"),

               TEXT("dingo"),TEXT("elephant"), TEXT("falcon"),

               TEXT("gazelle"),TEXT("hyena"), TEXT("iguana"),

               TEXT("jackal"),TEXT("kangaroo"), TEXT("llama"),

               TEXT("moose"),TEXT("newt"), TEXT("octopus"),

               TEXT("penguin"),TEXT("quail"), TEXT("rat"),

               TEXT("squid"),TEXT("tortoise"), TEXT("urus"),

               TEXT("vole"),TEXT("walrus"), TEXT("xylophone"),

               TEXT("yak"),TEXT("zebra"),

               TEXT("This line containswords, but no character. Go figure."),

               TEXT("")

       };

 

       switch (message)

       {

       case WM_CREATE:

               // 获得设备环境句柄

               hdc = GetDC(hwnd);

 

               // 获得文本中字体的大小 

               GetTextMetrics(hdc, &tm);

               xChar = tm.tmAveCharWidth;

               xUpper = (tm.tmPitchAndFamily& 1 ? 3 : 2) * xChar / 2;

               yChar = tm.tmHeight +tm.tmExternalLeading;

 

               // 释放设备环境句柄 

               ReleaseDC(hwnd, hdc);

 

               // 设置客户区的最大宽度 

               // （我们这里设置为 48 个小写字符的宽度 + 12 个大写字符的宽度）

               xClientMax = 48 * xChar + 12 *xUpper;

 

               return 0;

 

       case WM_SIZE:

               // 获得客户区的尺寸 

               yClient = HIWORD(lParam);

               xClient = LOWORD(lParam);

 

               // 设置垂直滚动条范围和页面大小（设置页面大小将决定滑块的粗细）

               si.cbSize = sizeof(si);

               si.fMask = SIF_RANGE | SIF_PAGE;

               si.nMin = 0;

               si.nMax = LINES - 1;

               si.nPage = yClient / yChar;

               SetScrollInfo(hwnd, SB_VERT,&si, TRUE);

 

               // 设置水平滚动条范围和页面大小（设置页面大小将决定滑块的粗细） 

               si.cbSize = sizeof(si);

               si.fMask = SIF_RANGE | SIF_PAGE;

               si.nMin = 0;

               si.nMax = 2 + xClientMax / xChar;

               si.nPage = xClient / xChar;

               SetScrollInfo(hwnd, SB_HORZ,&si, TRUE);

 

               return 0;

       case WM_HSCROLL:

               // 获得水平滚动条的所有信息

               si.cbSize = sizeof (si);

               si.fMask = SIF_ALL;

               GetScrollInfo(hwnd, SB_HORZ,&si);

 

               // 保存当前滑块位置，迟些进行比较

               xPos = si.nPos;

               switch (LOWORD(wParam))

               {

                      // 用户点击滚动条左边的三角形

               case SB_LINELEFT:

                      si.nPos -= 1;

                      break;

 

                      // 用户点击滚动条右边的三角形

               case SB_LINERIGHT:

                      si.nPos += 1;

                      break;

 

                      // 用户点击滑块左边的滚动条轴

               case SB_PAGELEFT:

                      si.nPos -= si.nPage;

                      break;

 

                      // 用户点击滑块右边的滚动条轴

               case SB_PAGERIGHT:

                      si.nPos += si.nPage;

                      break;

 

                      // 用户拖动滚动条

               case SB_THUMBTRACK:

                      si.nPos = si.nTrackPos;

                      break;

 

               default:

                      break;

               }

 

               // 设置滚动条滑块的新位置

               si.fMask = SIF_POS;

               SetScrollInfo(hwnd, SB_HORZ,&si, TRUE);

 

               // 获得滚动条滑块的位置，由于窗口调整，它可能不是同一个值

               GetScrollInfo(hwnd, SB_HORZ,&si);

 

               // 与此前的保存的值进行比较，如果不同则滚动窗口

               if (si.nPos != xPos)

               {

                      ScrollWindow(hwnd, xChar * (xPos - si.nPos), 0, NULL, NULL);

               }

 

               return 0;

 

       case WM_VSCROLL:

               // 获得垂直滚动条的所有信息

               si.cbSize = sizeof (si);

               si.fMask = SIF_ALL;

               GetScrollInfo(hwnd, SB_VERT,&si);

 

               // 保存当前滑块位置，迟些进行比较

               yPos = si.nPos;

               switch (LOWORD(wParam))

               {

                      // 用户点击键盘 Home 按键

               case SB_TOP:

                       si.nPos= si.nMin;

                      break;

 

                      // 用户点击键盘 End 按键

               case SB_BOTTOM:

                      si.nPos = si.nMax;

                      break;

 

                      // 用户点击滚动条上边的三角形

               case SB_LINEUP:

                      si.nPos -= 1;

                      break;

 

                      // 用户点击滚动条下边的三角形

               case SB_LINEDOWN:

                      si.nPos += 1;

                      break;

 

                       // 用户点击滑块上边的滚动条轴

               case SB_PAGEUP:

                      si.nPos -= si.nPage;

                      break;

 

                      // 用户点击滑块下边的滚动条轴

               case SB_PAGEDOWN:

                      si.nPos += si.nPage;

                      break;

 

                      // 用户拖动滚动条

               case SB_THUMBTRACK:

                      si.nPos = si.nTrackPos;

                      break;

 

               default:

                      break;

               }

 

               // 设置滚动条滑块的新位置

               si.fMask = SIF_POS;

               SetScrollInfo(hwnd, SB_VERT,&si, TRUE);

 

               // 获得滚动条滑块的位置，由于窗口调整，它可能不是同一个值

               GetScrollInfo(hwnd, SB_VERT,&si);

 

               // 与此前的保存的值进行比较，如果不同则滚动窗口

               if (si.nPos != yPos)

               {

                      ScrollWindow(hwnd, 0, yChar * (yPos - si.nPos), NULL, NULL);

                      UpdateWindow(hwnd);

               }

 

               return 0;

 

        caseWM_PAINT:

               // 准备绘制

               hdc = BeginPaint(hwnd, &ps);

 

               // 获得垂直滚动条的位置

               si.cbSize = sizeof (si);

               si.fMask = SIF_POS;

               GetScrollInfo(hwnd, SB_VERT,&si);

               yPos = si.nPos;

 

               // 获得水平滚动条的位置

               GetScrollInfo(hwnd, SB_HORZ,&si);

               xPos = si.nPos;

 

               // 计算需要重绘的区域

               FirstLine = max(0, yPos +ps.rcPaint.top / yChar);

               LastLine = min(LINES - 1, yPos +ps.rcPaint.bottom / yChar);

 

               for (i = FirstLine; i <=LastLine; i++)

               {

                      x = xChar * (1 - xPos);

                      y = yChar * (i - yPos);

 

                      // 使用安全字符串函数获得字符串长度

                      hr = StringCchLength(abc[i], 55, &abcLength);

                      if ((FAILED(hr)) | (abcLength == NULL))

                      {

                              // 获取字符串长度失败的提示...

                      }

 

                       // 在客户区绘制一行数据

                      TextOut(hdc, x, y, abc[i], abcLength);

               }

 

               // 绘制完毕

               EndPaint(hwnd, &ps);

               return 0;

       case WM_DESTROY:

               PostQuitMessage(0);

               return 0;

       }

       return DefWindowProc(hwnd, message, wParam, lParam);

}

 

 

 

 

47：ScrollWidnowEx

 

函数功能：  ScrollWindowEx函数滚动指定窗口的客户区内容。


API 函数原型：

int ScrollWindowEx(

  _In_  HWND hWnd,

  _In_  int dx,

  _In_  int dy,

  _In_  const RECT *prcScroll,

  _In_  const RECT *prcClip,

  _In_  HRGN hrgnUpdate,

  _Out_  LPRECTprcUpdate,

  _In_  UINT flags

);

参数解析：

flags 参数由下列标志组合：

返回值：

1. 如果函数调用成功，返回值是 SIMPLEREGION（矩形的无效区域），COMPLEXREGION（非矩形的无效区域；重叠的矩形）或 NULLREGION（没有无效区域）；
2. 如果函数调用失败，返回值是 ERROR。


备注：
1. 如果flags 参数的 SW_INVALIDATE 和 SW_ERASE 标志没有被设定，那么 ScrollWindowEx 函数不能使滚动过的区域失效。如果 flags 参数中任何一个标志被设置，ScrollWindowEx 函数就可以使该区域失效。这个区域就不会被更新直到应用程序调用 UpdateWindow 函数，或调用 RedrawWindow 函数（指定 RDW_UPDATENOW 或 RDW_ERASENOW 标志），或响应 WM_PAINT 消息。

2. 如果窗口拥有 WS_CLIPCHILDREN 类型，那么由 hrgnUpdate 和 prcUpdate 参数指定的返回区域描述了必须更新的滚动窗口的全部区域，包括所需更新子窗口的任何区域。

3. 如果 flags 参数的 SW_SCROLLCHILDREN 标志被设置，那么在子窗口的一部分被滚动时，系统将不能完全更新屏幕。位于矩形外边的滚动子窗体部分不被擦除，也不在它的新方向上被重绘。为了移动子窗体使之完全不在 prcScroll 参数指定的矩形中，可以使用 DeferWindowPos 函数。如果 SW_SCROLLCHILDREN 标志被设置并且插入符矩形和滚动矩形相交重叠，则光标也重新设置。

4. 所有输入和输出坐标（prcScroll, prcClip, prcUpdate 和 hrgnUpdate）均被定义为客户端，无论窗口是否具 CS_OWNDC 或 CS_CLASSDC 类型。必要的话，还可以使用 LPtoDP 和 DPtoLP 函数来转换逻辑坐标和设备坐标。

 

 

48：RGB 宏

 

宏功能：

RGB 宏有三个参数（byRed, byGreen, byBlue），功能是将这三个参数转换为COLORREF 颜色值。

注释：COLORREF 颜色被定义为 DWORD 类型（4 个字节），用于表示 RGB 颜色。

宏定义：

#define RGB(r,g,b)  ((COLORREF)(((BYTE)(r)|((WORD)((BYTE)(g))<<8))|(((DWORD)(BYTE)(b))<<16)))

参数解析：

小甲鱼忍不住罗嗦补充一句：色彩中不能再分解的基本色称之为原色，红绿蓝即三原色，将它们按照不同比例混合，可以搭配出所有的颜色。


返回值：
1. 返回三个参数转换后的 COLORREF 颜色值

备注：
1. 每个颜色可以指定的颜色值是 0 ~ 255，三个参数同时为 0，即黑色，同时为 255 即白色。
2. 通过 GetRValue、GetGValue和 GetBValue 宏可以分别从 COLORREF 颜色值中获得红色、绿色、蓝色的颜色值。

 

 

49：SetPixel

 

函数功能：

SetPixel 函数将指定坐标处的像素设为指定的颜色。

API 函数原型：

注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选参数。

COLORREF SetPixel(

  _In_  HDChdc,

  _In_  intx,

  _In_  inty,

  _In_  COLORREFcrColor

);

参数解析：

注释：COLORREF 颜色被定义为 DWORD 类型（4 个字节），用于表示 RGB 颜色。

返回值：
1. 如果函数调用成功，那么返回值就是函数设置像素的 RGB 颜色值（这个值可能与 crColor 指定的颜色有所不同，之所以有时发生这种情况是因为没有找到对指定颜色进行真正匹配造成的）；
2. 如果函数调用失败，那么返回值是 -1。

可以是以下值

备注：

1. 如果像素点坐标位于当前剪裁区之外，那么该函数执行失败。
2. 不是所有设备都支持 SetPixel 函数。有关详情，请参考 GetDeviceCaps。

 

 

 

 

50：GetRValue、GetGValue 和 GetBValue 宏

 

宏功能：

GetRValue、GetGValue 和 GetBValue 宏分别从 RGB 颜色值（COLORREF）中获得红色、绿色、蓝色的颜色值。


宏定义：

#define GetRValue(rgb)     (LOBYTE(rgb))

#define GetGValue(rgb)     (LOBYTE(((WORD)(rgb)) >> 8))

#define GetBValue(rgb)     (LOBYTE((rgb)>>16))

参数解析：

返回值：
1. 分别返回三原色（红色、绿色、蓝色）的颜色值。

备注：
颜色值的取值范围是 0 ~ 255

 

 

 

51：GetPixel

 

函数功能：

GetPixel 函数获得指定坐标处的像素的 RGB 颜色值。

API 函数原型：

注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选参数。

COLORREF GetPixel(

  _In_  HDChdc,

  _In_  intnXPos,

  _In_  intnYPos

);

参数解析：

返回值：
1. 返回值是 COLORREF 值，指定像素的 RGB（可以通过 GetRValue、GetGValue和 GetBValue 宏分别获得红、绿、蓝分别的色值）；
2. 如果指定的像素点在当前剪裁区之外；那么返回值是 CLR_INVALID。


备注：

1. 如果像素点坐标位于当前剪裁区之外，那么该函数执行失败。

2. 不是所有设备都支持 GetPixel 函数。有关详情，请参考 GetDeviceCaps。

3. 位图必须选入设备环境中，否则也会返回 CLR_INVALID

 

 

 

 

 

 

52：SetPixelV

 

函数功能：

SetPixelV 函数将指定坐标处的像素设为指定的颜色（与 SetPixel 一样，但效率高一些）。

API 函数原型：

注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选参数。

BOOL SetPixelV(

  _In_  HDChdc,

  _In_  intX,

  _In_  intY,

  _In_  COLORREFcrColor

);

参数解析：

注释：COLORREF 颜色被定义为 DWORD 类型（4 个字节），用于表示 RGB 颜色。


返回值：
1. 如果函数调用成功，返回值为非 0；
2. 如果函数调用失败，返回值为 0。


备注：
1. 不是所有设备都支持 SetPixelV 函数。有关详情，请参考 GetDeviceCaps。
2. SetPixelV 函数比 SetPixel 函数快，因为 SetPixelV 不需要返回实际绘制的像素值（返回布尔类型）。

 

 

 

 

53：GetDC

 

函数功能：

GetDC 函数用户获得指定窗口的客户区或整个屏幕的设备环境句柄，随后，你可以在 GDI 函数中使用该句柄在设备环境中绘图。

设备环境是一个不公开的数据结构，它的值供 GDI 函数内部使用。


API 函数原型：

注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选参数。

HDC GetDC(

  _In_  HWNDhWnd

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是指定窗口的客户区的设备环境句柄；
2. 如果函数调用失败，返回值是 NULL。

备注：
1. GetDC 函数根据指定类型的窗口获得普通的、典型的或特有的设备环境。
2. 对于普通的设备环境，GetDC 函数在每次调用的时候为它赋值默认属性；对于典型的和特有的设备环境，GetDC函数不改变先前设置的属性。
3. 在使用普通的设备环境绘图之后，必须调用 ReleaseDc函数释放该设备环境；典型的和特有的设备环境则不需要释放，设备环境的个数仅受有效内存的限制。
4. 有一点要特别注意，GetDC 函数对系统的开销相对比较大，如果你的应用程序里使用了几百个 GetDC 函数而又不通过 ReleaseDC 函数释放的话，那么你机器运行速度将是龟速。

 

 

 

 

 

 

 

54：ReleaseDC

 

函数功能：

ReleaseDC 函数用于释放设备环境，以供其他应用程序使用。

ReleaseDC 函数的效果取决于设备环境的类型，它只能释放普通的和窗口设备环境；对于典型的和特有的设备环境则无效。


API 函数原型：

注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选参数。

int ReleaseDC(

  _In_  HWNDhWnd,

  _In_  HDChDC

);

参数解析：

返回值：

返回值说明设备环境是否成功释放
1. 如果设备环境成功释放，返回 1；
2. 如果设备环境没有释放，返回 0。


备注：
1. 每次调用 GetWindowDC 函数和 GetDC 函数获得普通的设备环境之后，应用程序必须调用 ReleaseDC 函数来释放设备环境。
2. 应用程序不能调用 ReleaseDC 函数来释放由 CreateDC 函数创建的设备环境，CreateDC 创建的设备环境只能使用DeleteDC 函数来删除。
3. ReleaseDC 函数必须跟 GetDC 函数同在一个线程内调用。

 

 

 

 

 

 

55： GetWindowDC

 

函数功能：

GetWindowDC 函数用于获得的整个窗口（包括非客户区）的设备环境，例如标题栏、菜单、滚动条，以及边框。

一个窗口的设备环境允许在任何地方绘画，因为该设备环境的原点为窗口的左上角，而不是客户区。

GetWindowDC 函数每次获得设备环境时都为它赋值默认属性。

API 函数原型：

注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选参数。

HDC GetWindowDC(

  _In_  HWNDhWnd

);

参数解析：

 

小甲鱼注释：如果 hWnd 的值是 NULL，GetWindowDC 函数获得的是主显示器（多显示器的情况下）的设备环境，可以通过调用 EnumDisplayMonitors 和 CreateDC 函数获得其他显示器的设备环境。


返回值：
1. 如果函数调用成功，返回值是指定窗口的设备环境句柄；
2. 如果函数调用失败，返回值是 NULL。


备注：
1. GetWindowDC 函数获得的设备环境包含窗口的非客户区，在非客户区进行绘画是不推荐的。
2. 可以通过调用 GetSystemMetrics 函数来获得非客户区的各个部位（如标题栏、菜单或滚动条等）的尺寸。
3. GetDC 函数也可用于获得整个屏幕的设备环境。
4. 绘制结束后，必须调用 ReleaseDC 函数释放设备环境，如没有释放设备环境，对有绘画需求的应用程序将带来严重的影响。

 

56：CreateDC 

 

函数功能：

CreateDC 函数通过使用指定的名字为一个设备创建设备环境。

API 函数原型：

注释：_In_ 说明该参数是输入的，_out_ 说明该参数是输出的，_opt_ 说明该参数是可选参数。

HDC CreateDC(

  LPCTSTRlpszDriver,

  _In_  LPCTSTRlpszDevice,

  LPCTSTRlpszOutput,

  _In_  constDEVMODE *lpInitData

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是指定设备的设备环境句柄；
2. 如果函数调用失败，返回值是 NULL。
备注：

1. 注意，设备环境的句柄在任何时候都只能由单线程使用。
2. 对于 lpszDriver 和 lpszDevice 参数，可以通过调用 EnumDisplayDevices 函数获得显示设备的名字。
3. 如果你不再需要设备环境，请调用 DeleteDC 函数。

 

 

 

 

57：CreateCompatibleDC

 

函数功能：

CreateCompatibleDC 函数创建一个与指定设备兼容的内存设备环境（DC）。


API 函数原型：

注释：_In_ 说明该参数是输入的。

HDC CreateCompatibleDC(

  _In_  HDChdc

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是内存设备环境句柄；
2. 如果函数调用失败，返回值是 NULL。

备注：
1. 内存设备环境是仅在内存中的；当内存设备环境被创建时，它的显示界面是标准的一个单色像素宽和一个单色像素高；在一个应用程序可以使用内存设备环境进行绘图操作之前，它必须选择一个高和宽都正确的位图到设备环境中；可以通过调用 CreateCompatibleBitmap 函数指定高、宽和色彩组合以满足函数调用的需要。
2. 当一个内存设备环境被创建时，所有的特性都被设置为默认值；可以把内存设备环境当作一个普通的设备环境那样去使用：可以设置属性、获得当前的设置、为它选择画笔，刷子和区域。
3. CreateCompatibleDc 函数只适用于支持光栅操作的设备，应用程序可以通过调用 GetDeviceCaps 函数来确定一个设备是否支持这些操作。
4. 当不再需要内存设备环境时，可调用 DeleteDc 函数删除它。

 

 

 

 

58：CreateMetaFile

 

函数功能：

CreateMetaFile 函数用于创建一个图元文件的设备环境。

注意：该函数只兼容 Windows 格式的图元文件；对于新的应用程序，推荐使用功能更加卓越的增强型图元文件；调用 CreateEnhMetaFile 函数可以创建增强型图元文件对应的设备环境。


API 函数原型：

注释：_In_ 说明该参数是输入的。

HDC CreateMetaFile(

  _In_  LPCTSTRlpszFile

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是 Windows 格式的图元文件的设备环境句柄；
2. 如果函数调用失败，返回值是 NULL。

 

 

 

 

 

 

 

59： CloseMetaFile

 

函数功能：

CloseMetaFile 函数用于关闭指定图元文件的设备环境，并返回一个图元文件句柄。

注意：该函数只兼容 Windows 格式的图元文件；对于新的应用程序，推荐使用功能更加卓越的增强型图元文件；调用 CreateEnhMetaFile 函数可以创建增强型图元文件对应的设备环境（调用CloseEnhMetaFile 来关闭它）。


API 函数原型：

注释：_In_ 说明该参数是输入的。

HMETAFILE CloseMetaFile(

  _In_  HDChdc

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是 Windows 格式的图元文件句柄；
2. 如果函数调用失败，返回值是 NULL。

 

 

 

60：MoveToEx

 

函数功能：

MoveToEx 函数将当前绘图位置移动到某个具体的点，同时也可获得之前位置的坐标。

API 函数原型：

注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选参数。

BOOL MoveToEx(

  _In_  HDC hdc,

  _In_  int X,

  _In_  int Y,

  _Out_  LPPOINTlpPoint

);

 

参数解析：

返回值：
1. 如果函数调用成功，返回值是非 0；
2. 如果函数调用失败，返回值是 0。

备注：
1. MoveExTo 函数将影响所有的绘图函数。
2. 在默认的设备环境中，点 (0, 0) 为最初设定的当前位置。

 

 

 

 

61：LineTo

 

函数功能：

LineTo 函数使用当前画笔绘制一条线，线段从当前位置连到一个指定的点 (x, y)。

当这个函数调用完毕后，当前位置变成 (x, y)。

小甲鱼提示：所绘制的线段并不包含指定的点 (x, y)。

API 函数原型：

注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选参数。

BOOL LineTo(

  _In_  HDChdc,

  _In_  intnXEnd,

  _In_  intnYEnd

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是非 0；
2. 如果函数调用失败，返回值是 0。

 

 

 

 

62：POINT 结构

 

POINT 结构定义了一个点的 x 坐标和 y 坐标。

结构原型：

typedef struct tagPOINT {

  LONG x;

  LONG y;

} POINT, *PPOINT;

 

成员解析：

63：GetCurrentPositionEx 

 

函数功能：

GetCurrentPositionEx 函数用于获取逻辑坐标中的当前位置。

API 函数原型：

BOOL GetCurrentPositionEx(

  _In_  HDC hdc,

  _Out_  LPPOINTlpPoint

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是非 0；
2. 如果函数调用失败，返回值是 0。

 

 

 

64：Polyline

 

函数功能：

Polyline 函数将指定数组的连接点绘制成一系列线段（折线）。

API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL Polyline(

  _In_  HDChdc,

  _In_  constPOINT *lppt,

  _In_  intcPoints

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是非 0；
2. 如果函数调用失败，返回值是 0。


备注：
1. 该折线是使用当前画笔，通过将指定数组中的顶点依次连接绘制出来的。
2. 不像 LineTo 或 PolylineTo 函数，Polyline 函数既不会用到当前位置，也不会去修改它。

 

 

 

65：PolylineTo

 

函数功能：

PolylineTo 函数将指定数组的连接点绘制成一系列线段（折线）。


API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL PolylineTo(

  _In_  HDChdc,

  _In_  constPOINT *lppt,

  _In_  DWORDcCount

);

 

参数解析：

返回值：
1. 如果函数调用成功，返回值是非 0；
2. 如果函数调用失败，返回值是 0。

备注：
1. 不像 Polyline 函数，PolylineTo 函数会使用并修改当前位置。
2. 绘画时，会使用使用当前画笔，先从当前位置画一条线连接到 lppt 指定的第一个顶点的位置，然后画到下一个顶点，以此类推。
3. 绘画完成之后，会将当前位置移动到最后一个顶点的位置。
4. 如果该函数绘制了一个封闭的图形，那么该图形不会被填充。

 

 

 

66：PolyPolyline

 

函数功能：

PolyPolyline 函数用于同时绘制多条折线。

API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL PolyPolyline(

  _In_  HDChdc,

  _In_  constPOINT *lppt,

  _In_  constDWORD *lpdwPolyPoints,

  _In_  DWORDcCount

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是非 0；
2. 如果函数调用失败，返回值是 0。

备注：
1. 该函数绘制的一系类折线都是使用当前画笔完成。
2. 该函数绘制的图形并没有填充。
3. 该函数既不会用到当前位置，也不会去修改它。

 

 

 

 

67：GetDeviceCaps 

 

函数功能：

GetDeviceCaps 函数用于获得指定设备的一些特定信息。

API 函数原型：

注释：_In_ 说明该参数是输入的。

int GetDeviceCaps(

  _In_  HDChdc,

  _In_  intnIndex

);

参数解析：

nIndex 的索引值可以是以下值：

返回值：
1. 返回 nIndex 参数指定项的值；
2. 如果 nIndex 参数是 BITSPIXEL， 且设备是具有 15bpp 或 16bpp，返回值是16。

备注：
1. 如果 nIndex 参数的值是 SHADEBLENDCAPS：

对于打印设备：GetDeviceCaps 函数返回任何打印机的报告

对于显示设备：所有混合操作都支持，除了 SB_NONE，唯一的返回值是 SB_CONST_ALPHA 和 SB_PIXEL_ALPHA，这表明这些操作是否被加速

2. 在多显示器系统中，如果 hdc 是台式机，GetDeviceCaps 函数返回主显示器的功能。如果你想为其他显示器的信息，则必须使用多显示器的 API 函数或调用 CreateDC 函数得到一个 hdc 指定显示器的设备环境。

注意，一般显示 1 是主显示器，但并非总是如此。

3. GetDeviceCaps 提供了以下六个索引值为打印设备转义符：

4. 注意：

GetDeviceCaps 函数获得的信息来源于显示驱动程序。

如果显示驱动程序拒绝提供任何信息，GetDeviceCaps函数则通过计算固定数据得到信息。

如果显示驱动程序报告无效信息，GetDeviceCaps函数返回无效信息。

此外，如果显示驱动拒绝报告信息，GetDeviceCaps 函数可能计算不正确的信息，因为它假设是固定的 DPI（每英寸点数 96）或固定的大小（取决于显示驱动程序是否提供）。

不幸的是，实现在 Windows 显示驱动程序模型（WDDM）（在 Windows Vista 中引入）的显示驱动程序导致 GDI 拿不到信息，所以 GetDeviceCaps 函数必须通过计算得到信息。

 

68：PolyBezier

 

函数功能：

PolyBezier 函数用于绘制一个或多个贝塞尔曲线。

贝赛尔曲线是一种非常优美的曲线，一条贝赛尔样条由4个定义点定义：两个端点和两个控制点。

API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL PolyBezier(

  _In_  HDChdc,

  _In_  constPOINT *lppt,

  _In_  DWORDcPoints

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是非 0；
2. 如果函数调用失败，返回值是 0。


备注：
1. PolyBezier 函数通过使用由 lppt 参数指定的端点和控制点绘制一条或多条三次贝塞尔曲线。
2. 第一条贝塞尔曲线的四个点依次是：起点、第一控制点、第二控制点和终点；随后的每一条贝塞尔曲线则只需给出三个点，因为前一条贝塞尔曲线的终点会被当作后一条贝塞尔曲线的起点，以此类推。
3. 绘制一系列相连的贝塞尔曲线时，仅当第一条贝塞尔曲线的第二个控点、第一条贝塞尔曲线的终点（也就是第二条贝塞尔曲线的起点）与第二条贝塞尔曲线的第一个控点是线性关系时（即三点共线时），曲线在连接点处才是平滑的。

 

 

 

 

69： PolyBezierTo

 

函数功能：

PolyBezierTo 函数用于绘制一个或多个贝塞尔曲线。

贝赛尔曲线是一种非常优美的曲线，一条贝赛尔样条由4个定义点定义：两个端点和两个控制点。

API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL PolyBezierTo(

  _In_  HDChdc,

  _In_  constPOINT *lppt,

  _In_  DWORDcCount

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是非 0；
2. 如果函数调用失败，返回值是 0。


备注：
1. PolyBezierTo 函数通过使用由 lppt 参数指定的端点和控制点绘制一条或多条三次贝塞尔曲线。
2. 第一条贝塞尔曲线是从当前位置作为起点开始绘制，连接前三个点，分别是：第一控制点、第二控制点和终点；随后的每一条贝塞尔曲线则只需给出三个点，因为前一条贝塞尔曲线的终点会被当作后一条贝塞尔曲线的起点，以此类推。
3. PolyBezierTo 函数将移动当前位置到最后一条贝塞尔曲线的终点。

 

 

 

 

70：Rectangle 

 

函数功能：

Rectangle 函数用于绘制一个矩形。

该矩形用当前画笔绘制轮廓，用当前画刷填充。

 


API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL Rectangle(

  _In_  HDChdc,

  _In_  intxLeft,

  _In_  intyTop,

  _In_  intxRight,

  _In_  intyBottom

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是非 0；
2. 如果函数调用失败，返回值是 0。

备注：
1. 该函数既不使用当前位置，也不修改当前位置。
2. 写过图形程序的程序员通常熟悉边界偏差（off-by-one）的问题：一些图形程序系统画出的图形包含了右坐标和底坐标表示的点，一些则只画到右坐标和底坐标表示的点之前的一点。Windows 使用后一种方法。
3. 如果使用 PS_NULL 画笔，则矩形的尺寸高和宽比实际少一个像素。

 

 

 

 

71：Ellipse 

 

函数功能：

Ellipse 函数用于绘制一个椭圆，椭圆的中心是限定矩形的中心。

该椭圆用当前画笔绘制轮廓，用当前画刷填充。

 


API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL Ellipse(

  _In_  HDChdc,

  _In_  intxLeft,

  _In_  intyTop,

  _In_  intxRight,

  _In_  intyBottom

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是非 0；
2. 如果函数调用失败，返回值是 0。

备注：
该函数既不使用当前位置，也不修改当前位置。

 

 

 

 

72：RoundRect

 

函数功能：

RoundRect 函数用于绘制一个带圆角的矩形。该矩形用当前画笔绘制轮廓，用当前画刷填充。

 



API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL RoundRect(

  _In_  HDChdc,

  _In_  intxLeft,

  _In_  intyTop,

  _In_  intxRight,

  _In_  intyBottom,

  _In_  intxCornerEllipse,

  _In_  intyCornerEllipse

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是非 0；
2. 如果函数调用失败，返回值是 0。

备注：
该函数既不使用当前位置，也不修改当前位置。

 

 

 

73：Arc

 

函数功能：

Arc 函数用于绘制一个椭圆的圆弧。

 


API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL Arc(

  _In_  HDChdc,

  _In_  intxLeft,

  _In_  intyTop,

  _In_  intxRight,

  _In_  intyBottom,

  _In_  intxStart,

  _In_  intyStart,

  _In_  intxEnd,

  _In_  intyEnd

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是非 0；
2. 如果函数调用失败，返回值是 0。


备注：
1. 点 (xLeft, yTop) 和点 (xRight, yBottom) 指定限定矩形的位置。
2. 由指定的限定矩形形成的椭圆定义弧的曲线。
3. 弧的起始点 (xStart, yStart) 开始和终点 (xEnd, yEnd) 并不在椭圆上，而是定义为在椭圆的中心的延长线上（不懂的鱼油请看上图）。
4. 如果椭圆的起始点和终点是同一个点，那么将绘制整个椭圆。

 

 

 

74：Chord

 

函数功能：

Chord 函数绘制不仅绘制一条弧，还会连接弧的两个端点连接一条弦，最后构成一个弓形的封闭区域。

该弓形用当前画笔绘制轮廓，用当前画刷填充。

 


API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL Chord(

  _In_  HDChdc,

  _In_  intxLeft,

  _In_  intyTop,

  _In_  intxRight,

  _In_  intyBottom,

  _In_  intxStart,

  _In_  intyStart,

  _In_  intxEnd,

  _In_  intyEnd

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是非 0；
2. 如果函数调用失败，返回值是 0。

备注：
1. 弦对应的曲线（弧）由限定矩形画出的椭圆所指定。
2. 曲线（弧）的起始点 (xStart, yStart) 开始和终点 (xEnd, yEnd) 并不在椭圆上，而是定义为在椭圆的中心的延长线上（不懂的鱼油请看上图）。
3. 如果椭圆的起始点和终点是同一个点，那么将绘制整个椭圆。
4. 该函数既不使用当前位置，也不修改当前位置。

 

 

 

75：Pie

 

函数功能：

Pie 函数绘制一个由弧以及椭圆中心构成的扇形。该扇形用当前画笔绘制轮廓，用当前画刷填充。

 



API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL Pie(

  _In_  HDChdc,

  _In_  intxLeft,

  _In_  intyTop,

  _In_  intxRight,

  _In_  intyBottom,

  _In_  intxStart,

  _In_  intyStart,

  _In_  intxEnd,

  _In_  intyEnd

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是非 0；
2. 如果函数调用失败，返回值是 0。

备注：
1. 扇形对应的曲线（弧）由限定矩形画出的椭圆所指定。
2. 曲线（弧）的起始点 (xStart, yStart) 开始和终点 (xEnd, yEnd) 并不在椭圆上，而是定义为在椭圆的中心的延长线上（不懂的鱼油请看上图）。
3. 该函数既不使用当前位置，也不修改当前位置。

 

 

 

 

76：GetStockObject

 

函数功能：

GetStockObject 函数用于获得 Windows 预设的画笔、画刷、字体或者调色板的句柄。


API 函数原型：

注释：_In_ 说明该参数是输入的。

HGDIOBJ GetStockObject(

  _In_  intfnObject

);

参数解析：

fnObject 可取如下值之一：

返回值：
1. 如果函数调用成功，返回值是所申请的逻辑对象的句柄；
2. 如果函数调用失败，返回值是 NULL。


备注：

1. 不建议您使用该函数获得对话框和窗口的当前字体。应该使用 SystemParametersInfo 函数（SPI_GETNONCLIENTMETRICS参数）来获得当前字体，因为 SystemParametersInfo 函数将考虑到当前主题，并提供了标题栏，菜单和消息对话框的字体信息。
2. 仅在窗口风格为 CS_HREDRAW 和 CS_VREDRAW 中，才能使用 DKGRAY_BRUSH、GRAY_BRUSH 和 LTGRAY_BRUSH 对象。如果在其他风格的窗口中使灰色画刷，可能导致在窗口移动或改变大小之后出现画刷模式错位现象，原始画刷不能被调整。
3. HOLLOW_BRUSH 和 NULL_BRUSH 对象是一样的。
4. 不必要通过调用 DeleteObject 函数来删除 Windows 预设的对象。
5. DC_BRUSH 和 DC_PEN 都能与其他对象如 BLACK_BRUSH 和 BLACK_PEN 相互交换。具体请参考 GetDCBrushColor 函数、SetDCBrushColor 函数、GetDCPenColor 函数和 SetDCPenColor 函数。

 

 

 

77：SelectObject

 

函数功能：

SelectObject 函数用于选择一对象到指定的设备环境中，该新对象将替换先前的相同类型的对象。


API 函数原型：

注释：_In_ 说明该参数是输入的。

HGDIOBJ SelectObject(

  _In_  HDChdc,

  _In_  HGDIOBJhgdiobj

);

参数解析：

hgdiobj 参数的对象必需由以下的函数创建：

返回值：
1. 如果选择对象不是区域并且函数调用成功，那么返回值是被取代的对象的句柄；
2. 如果选择对象是区域并且函数执行成功，返回以下值之一：

3. 如果发生错误并且选择对象不是一个区域，那么返回值为 NULL，否则返回 HGDI_ERROR。


备注：

1. 该函数返回先前指定类型的选择对象。
2. 一个应用程序在它使用新对象进行绘制完成之后，应该用原始的默认对象替换新对象。
3. 应用程序不能同时选择一个位图到多个设备环境中。
4. ICM：如果被选择的对象是画笔或笔，那么就执行颜色管理。

 

 

 

78：CreatePen

 

函数功能：

CreatePen 函数用指定的样式、宽度和颜色创建一个逻辑画笔。创建的画笔随后可以被选择到设备环境中，并用于绘制直线和曲线。


API 函数原型：

注释：_In_ 说明该参数是输入的。

HPEN CreatePen(

  _In_  intfnPenStyle,

  _In_  intnWidth,

  _In_  COLORREFcrColor

);

参数解析：

fnPenStyle 参数指定画笔样式为如下值之一：

返回值：
1. 如果函数调用成功，返回值是新画笔的句柄；
2. 如果函数调用失败，返回值是 NULL。

备注：
1. 调用该函数创建新画笔之后，可以使用 SelectObject 函数将新画笔选入设备环境中。只有当画笔被选入设备环境，才能使用该画笔绘制线段或曲线。
2. 如果 nWidth 参数的值是 0，则画笔为一个像素宽度，不管当前的映射模式。
3. 如果 nWidth 参数的值大于 1，则fnPenStyle 参数的值必须为 PS_NULL, PS_SOLID 或 PS_INSIDEFRAME 的其中一个。
4. 如果 nWidth 参数的值大于 1，且fnPenStyle 参数的值为 PS_INSIDEFRAME，所有与该画笔相关联（除了折线和多边形）的封闭图形绘制，画笔宽度向内扩展。
5. 如果 nWidth 参数的值大于 1，且fnPenStyle 参数的值为 PS_INSIDEFRAME，如果指定的 RGB 颜色不存在，就进行抖动处理。
6. 如果你再也不需要该画笔，可以使用 DeleteObject 函数将其删除。

 

 

 

 

79：LOGPEN 结构

 

LOGPEN 结构

LOGPEN 结构定义了画笔、图形对象用于绘制线条和边框的宽度、样式和颜色。CreatePenIndirect 函数需要使用到 LOGPEN 结构。


结构原型：

typedef struct tagLOGPEN {

  UINT    lopnStyle;

  POINT   lopnWidth;

  COLORREFlopnColor;

} LOGPEN, *PLOGPEN;

成员解析：

lopnStyle 成员指定画笔样式为如下值之一：

备注：
1. 如果 lopnWidth 成员的值大于 1，且 lopnStyle 成员的值为 PS_INSIDEFRAME，所有与该画笔相关联（除了折线和多边形）的封闭图形绘制，画笔宽度向内扩展。
2. 如果指定的 RGB 颜色不存在，就进行抖动处理。
3. 如果 lopnWidth 成员的值小于等于 1，则 PS_INSIDEFRAME 样式与 PS_SOLID  相同。

 

 

 

 

80： CreatePenIndirect

 

函数功能：

CreatePenIndirect 函数根据指定的 LOGPEN结构创建一个画笔。

API 函数原型：

注释：_In_ 说明该参数是输入的。

HPEN CreatePenIndirect(

  _In_  constLOGPEN *lplgpn

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是新画笔的句柄；
2. 如果函数调用失败，返回值是 NULL。

备注：
1. 调用该函数创建新画笔之后，可以使用 SelectObject 函数将新画笔选入设备环境中。只有当画笔被选入设备环境，才能使用该画笔绘制线段或曲线。
2. 如果你再也不需要该画笔，可以使用 DeleteObject 函数将其删除。

 

 

 

 

81： DeleteObject

 

函数功能：

DeleteObject 函数用于删除一个逻辑画笔、画刷、字体、位图、区域或者调色板，释放所有与该对象有关的系统资源。

注意，在对象被删除之后，指定的句柄也就失效了。

API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL DeleteObject(

  _In_  HGDIOBJhObject

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是非 0；
2. 如果指定的句柄无效或者它已被选入设备环境，则返回值是 0。

备注：
1. 当一个绘画对象（如画笔或画刷）当前被选入一个设备环境中时，不要删除该对象。
2. 当一个画刷被删除时，与该画刷相关的位图并不被删除，该图必须单独地删除。

 

 

 

 

82：GetObject

 

函数功能：

GetObject 函数用于获得指定图形对象的信息。


API 函数原型：

注释：_In_ 说明该参数是输入的，__Out__ 说明该参数是输出的。

int GetObject(

  _In_  HGDIOBJ hgdiobj,

  _In_  int cbBuffer,

  _Out_  LPVOIDlpvObject

);

参数解析：

下边列出的是缓冲区获得的每种图形对象的信息类型（通过 hgdiobj 参数指定）

注释：lpvObject 参数指向的地址必须是 4 字节的倍数，否则 GetObject 函数调用失败。


返回值：
1. 如果函数调用成功，且 lpvObject 参数是一个有效的指针，则返回值是存储到缓冲区的字节数；
2. 如果函数调用成功，而 lpvObject 参数是 NULL，则返回值是需要存储到缓冲区的信息的字节数；
3. 如果函数调用失败，返回值是 0。


备注：

1. lpvObject 参数指向的缓冲区一定要足够大以接收图形对象的信息。
2. 如果 hgdiobj 参数指定一个由调用 CreateDIBSection 函数创建的位图，且指定的缓冲区足够大，则 GetObject 函数返回一个 DIBSECTION 结构。
3. 如果 hgdiobj 参数指定一个通过其他途径创建的位图，则 GetObject 只返回位图的宽、高和颜色格式信息，通过调用 GetDIBits 或 GetBitmapBits 函数可以得到位置的位值。
4. 如果 hgdiobj 参数指定一个逻辑调色板，则 GetObject 获得一个 2 字节的整数，该整数指定调色板中的项数，函数不会获得定义调色板的LOGPALETTE 结构，为了获得有关调色板项的信息，应用程序可以调用 GetPaletteEntries 函数。

 

 

 

 

83： GetCurrentObject

 

函数功能：

GetCurrentObject 函数用于获得被选入指定环境设备中的指定对象类型的句柄。

API 函数原型：

注释：_In_ 说明该参数是输入的。

HGDIOBJ GetCurrentObject(

  _In_  HDChdc,

  _In_  UINTuObjectType

);

参数解析：

uObjectType 参数可以是下边任意一值：

返回值：
1. 如果函数调用成功，返回值是指定对象的句柄；
2. 如果函数调用失败，返回值是 NULL。

备注：
    应用程序可以使用 GetCurrentObject 函数和 GetObject 函数来获得对当前选入给定设备环境的图形对象的描述。

 

 

 

 

84：SetDCBrushColor

 

函数功能：

SetDCBrushColor 函数用于设置指定设备环境中的画刷对象的颜色值。如果设备不能提供指定的颜色值，那么就把颜色设置为最近的物理颜色。


API 函数原型：

注释：_In_ 说明该参数是输入的。

COLORREF SetDCBrushColor(

  _In_  HDChdc,

  _In_  COLORREFcrColor

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是指定设备环境先前的画刷颜色值（COLORREF 类型）；
2. 如果函数调用失败，返回值是 CLR_INVALID。

备注：
1. 当在一个设备环境中选择系统预设的 DC_BRUSH 时，以后所有的绘图操作将使用设备环境中的画刷颜色，直到系统预设的画刷被取消选择为止，默认的 DC_BRUSH 颜色是 WHITE。
2. 该函数将返回先前的 DC_BRUSH 颜色，即使在设备环境中没有选择系统预设的画刷 DC_BRUSH。然而，除非系统预设的 DC_BRUSH 被选择入设备环境，否则绘图操作将不使用它。
3. 使用 DC_PEN 或 DC_BRUSH 参数的 GetStockObject 函数可以与 SetDCPenColor 函数和 SetDCBrushColor 函数互换。

 

 

 

 

85：SetDCPenColor

 

函数功能：

SetDCPenColor 函数用于设置指定设备环境中的画笔对象的颜色值。如果设备不能提供指定的颜色值，那么就把颜色设置为最近的物理颜色。

API 函数原型：

注释：_In_ 说明该参数是输入的。

COLORREF SetDCPenColor(

  _In_  HDChdc,

  _In_  COLORREFcrColor

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是指定设备环境先前的画笔颜色值（COLORREF 类型）；
2. 如果函数调用失败，返回值是 CLR_INVALID。

备注：
1. 该函数将返回先前的 DC_PEN 颜色，即使在设备环境中没有选择系统预设的画笔 DC_PEN。然而，除非系统预设的 DC_PEN 被选择入设备环境，否则绘图操作将不使用它。
2. 使用 DC_PEN 或 DC_BRUSH 参数的 GetStockObject 函数可以与 SetDCPenColor 函数和 SetDCBrushColor 函数互换。

 

 

 

 

86： GetDCBrushColor

 

函数功能：

GetDCBrushColor 函数用于获得指定设备环境的当前画刷颜色。

API 函数原型：

注释：_In_ 说明该参数是输入的。

COLORREF GetDCBrushColor(

  _In_  HDChdc

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是指定设备环境的当前画刷颜色（COLORREF 类型）；
2. 如果函数调用失败，返回值是 CLR_INVALID。

备注：
1. 有关设置指定设备环境的当前画刷颜色，请参考：SetDCBrushColor 函数。
ICM：如果ICM可用就执行颜色管理。

 

 

 

 

87：GetDCPenColor

 

函数功能：

GetDCPenColor 函数用于获得指定设备环境的当前画笔颜色。

API 函数原型：

注释：_In_ 说明该参数是输入的。

COLORREF GetDCPenColor(

  _In_  HDChdc

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是指定设备环境的当前画笔颜色（COLORREF 类型）；
2. 如果函数调用失败，返回值是 CLR_INVALID。

备注：
1. 有关设置指定设备环境的当前画刷颜色，请参考：SetDCPenColor 函数。
ICM：如果ICM可用就执行颜色管理。

 

 

 

 

 

 

 

88：SetBkColor

 

函数功能：

SetBkColor 函数用于设置当前的背景颜色。如果指定的颜色值超出了当前设备的表示范围，则设置为最近似的、设备可以表示的颜色。


API 函数原型：

注释：_In_ 说明该参数是输入的。

COLORREF SetBkColor(

  _In_  HDChdc,

  _In_  COLORREFcrColor

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是先前背景的颜色值（COLORREF 类型）；
2. 如果函数调用失败，返回值是 CLR_INVALID。

备注：

1. 该函数填充由 CreatePen 函数创建出来的非实线画笔之间的空隙（例如点线画笔，填充的是画笔间点和线的空隙，不是客户区的背景颜色哦）。
2. 该函数不会填充由 ExtCreatePen 函数创建出来的画笔。
3. 该函数也可以用于填充 TextOut 函数和 ExtTextOut 函数输出字符的背景颜色。
4. 如果背景颜色设置为不透明（OPAQUE）时，背景颜色用来填充非实线画笔风格的间隙、阴影画刷和字符的背景颜色。

 

 

 

 

 

 

 

89：SetBkMode

 

函数功能：

SetBkMode 函数用于设置字符、阴影画刷和非实线画笔的背景模式。

API 函数档案：

注释：_In_ 说明该参数是输入的。

int SetBkMode(

  _In_  HDChdc,

  _In_  intiBkMode

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是先前的背景模式；
2. 如果函数调用失败，返回值是 0。

备注：
1. 该函数将影响到由 CreatePen 函数创建的非实线画笔。
2. 该函数并不会影响到由 ExtCreatePen 函数创建的画笔。

 

 

 

 

90：SetROP2

 

函数功能：

SetROP2 函数用于设置当前的前景色混合模式（绘图模式）。GDI 使用前景色混合模式，将画笔的颜色和画线显示区域的颜色混合后显示出来。

API 函数原型：

注释：_In_ 说明该参数是输入的。

int SetROP2(

  _In_  HDChdc,

  _In_  intfnDrawMode

);

参数解析：

fnDrawMode 参数指定的混合模式可以是以下值之一：

返回值：
1. 如果函数调用成功，返回值是先前的混合模式（绘图模式）；
2. 如果函数调用失败，返回值是 0。

备注：
1. 当使用一个画笔进行绘制时，实际上是在将画笔的像素颜色和目标显示表面的像素颜色按位进行布尔运算。
2. 对像素颜色执行一个按位布尔运算称为“光栅操作”（Raster Operation, ROP），简称“ROP”，因为只涉及两种像素颜色（即画笔和屏幕），所以这里的布尔运算就被称为“二元光栅操作”，或者“ROP2”。
3. 混合模式（绘图模式）仅支持光栅设备，并不支持矢量设备。

 

 

 

 

91：GetROP2

 

函数功能：

GetROP2 函数用于获取指定设备环境的前景色混合模式（绘图模式）。GDI 使用前景色混合模式，将画笔的颜色和画线显示区域的颜色混合后显示出来。


API 函数原型：

注释：_In_ 说明该参数是输入的。

int GetROP2(

  _In_  HDChdc

);

 

参数解析：

返回值：
1. 如果函数调用成功，返回值是指定设备环境的前景色混合模式；
2. 如果函数调用失败，返回值是 0。

备注：

前景色混合模式可以是以下值：

 

 

 

92：Polygon

 

函数功能：

Polygon 函数用于绘制一个由直线相连的两个以上顶点组成的多边形。该函数用当前画笔绘制多边形的轮廓，用当前画刷和多边形填充模式填充多边形。


API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL Polygon(

  _In_  HDChdc,

  _In_  constPOINT *lpPoints,

  _In_  intnCount

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是非 0；
2. 如果函数调用失败，返回值是 0。

备注：
1. 该函数会自动连接最后一个顶点和第一个顶点，构成一个闭合的多边形（Polyline 函数不会这么做）。
2. 该函数并不会使用和改变当前位置。

 

 

 

 

93：PolyPolygon 

 

函数功能：

PolyPolygon 函数用于一系列多边形。该函数用当前画笔绘制多边形的轮廓，用当前画刷和多边形填充模式填充多边形。

该函数绘制的多边形可以重叠。

API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL PolyPolygon(

  _In_  HDChdc,

  _In_  constPOINT *lpPoints,

  _In_  constINT *lpPolyCounts,

  _In_  intnCount

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是非 0；
2. 如果函数调用失败，返回值是 0。

备注：
1. 该函数并不会使用和改变当前位置。

 

 

 

 

94：SetPolyFillMode

 

函数功能：

SetPolyFillMode 函数设置多边形的填充模式，用于填充多边形。

API 函数原型：

注释：_In_ 说明该参数是输入的。

int SetPolyFillMode(

  _In_  HDChdc,

  _In_  intiPolyFillMode

);

参数解析：

iPolyFillMode 参数指定的填充模式可以是以下值之一：

返回值：
1. 如果函数调用成功，返回值是先前的填充模式；
2. 如果函数调用失败，返回值是 0。


备注：
1. 在通常情况下，两种模式仅在绘制复杂、重叠的多边形才会有不同的显示（例如五角星）。

 
2. 当填充模式为 ALTERNATE，GDI 填充每条扫描线从多边形的奇数边到偶数边之间的区域。也就是说，GDI 依次填充多边形的第一、第二条边之间的区域，接着填充第三、第四条边之间的区域（第二、第三条边之间的区域留空），以此类推。
3. 当填充模式为 WINDING，GDI 填充所有能够一笔完成的多边形。

 

 

 

 

95：GetBkMode

 

函数功能：

GetBkMode 函数用于获得字符、阴影画刷和非实线画笔的背景模式。

API 函数原型：

注释：_In_ 说明该参数是输入的。

int GetBkMode(

  _In_  HDChdc

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是指定设备环境当前的背景模式（OPAQUE 或 TRANSPARENT）；
2. 如果函数调用失败，返回值是 0。

 

 

 

 

 

 

 

 

96： GetPolyFillMode 

 

函数功能：

GetPolyFillMode 函数用于获得当前的多边形填充模式。


API 函数原型：

注释：_In_ 说明该参数是输入的。

int GetPolyFillMode(

  _In_  HDChdc

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是指定设备环境的多边形填充模式；
2. 如果函数调用失败，返回值是 0。

备注：
1. 多边形的填充模式可以是以下值之一：

2. 关于两种填充模式的区别，请看 SetPolyFillMode 函数。

 

 

 

97：CreateSolidBrush

 

函数功能：

CreateSolidBrush 函数用于创建一个指定颜色的逻辑画刷。


API 函数原型：

注释：_In_ 说明该参数是输入的。

HBRUSH CreateSolidBrush(

  _In_  COLORREFcrColor

);

参数解析：

返回值：
1. 如果函数调用成功，返回值是新画刷的句柄；
2. 如果函数调用失败，返回值是 NULL。

备注：
1. 如果你再也不需要该画刷，可以使用 DeleteObject 函数将其删除。
2. 实心画刷实际上就是指系统用来绘制要填充图形的内部区域的位图。
3. 调用该函数创建新画刷之后，可以使用 SelectObject 函数将新画刷选入设备环境中。
4. 当要使用系统画刷的时候，应用程序应该使用 GetSysColorBrush(iIndex) 代替CreateSolidBrush(GetSysColor(nIndex))。因为GetSysColorBrush 函数会使用缓存好的画刷而不用重新创建一个新的。

ICM：在创建刷子时没有颜色操作。然而，当把该刷子选入ICM许可的设备环境中时，将进行颜色管理。

 

 

 

 

98：LOGBRUSH 结构

LOGBRUSH 结构定义了逻辑画刷的样式，颜色和图案。CreateBrushIndirect 函数和 ExtCreatePen 函数需要使用到该结构。

结构原型：

typedef struct tagLOGBRUSH {

  UINT     lbStyle;

  COLORREF  lbColor;

  ULONG_PTR lbHatch;

} LOGBRUSH, *PLOGBRUSH;

成员解析：

备注：
1. DIB（设备无关位图文件格式）包含 BITMAPINFO 结构以及紧跟着的存储像素阵列的数组。
2. 尽管 lbColor 成员指定了阴影画刷的前景色，但调用 SetBkMode 函数和 SetBkColor 函数可以控制背景颜色。

 

 

 

99：CreateHatchBrush

 

函数功能：

CreateHatchBrush 函数用于创建一个具有指定阴影样式和颜色的逻辑刷子。

API 函数原型：

注释：_In_ 说明该参数是输入的。

HBRUSH CreateHatchBrush(

  _In_  intfnStyle,

  _In_  COLORREFclrref

);

参数解析：

fnStyle 参数指定画刷的阴影样式如下：

 返回值：
1. 如果函数调用成功，返回值是新画刷的句柄；
2. 如果函数调用失败，返回值是 NULL。

备注：
1. 阴影画刷实际上就是指系统用来绘制要填充图形的内部区域的位图。
2. 调用该函数创建新画刷之后，可以使用 SelectObject函数将新画刷选入设备环境中。
3. 调用 SetBkColor 函数可以修改画刷图案的背景色。 
4. 调用 SetBkMode 函数可以影响搞该阴影画刷的渲染效果（如果是 OPAQUE 模式，背景颜色被用来填充线与线之间的空隙；如果是 TRANSPARENT模式，Windows 就只画出阴影线，不填充它们之间的空隙）。
5. 如果应用程序使用带阴影的刷子，用合适的颜色填充父窗口和子窗口的背景，那么在绘刷子窗口的背景之前，有可能需要设置刷子的起始点。要做到这一点，可以在应用程序中调用 SetBrushOrgEx 函数。
6. 如果你再也不需要该画刷，可以使用 DeleteObject 函数将其删除。

ICM：在创建刷子时没有颜色，然而在把该刷子选入到ICM许可的设备环境中时，将会完成颜色管理。