文本编辑
1、CreateSolidCaret
CWnd::CreateSolidCaret
void CreateSolidCaret( int nWidth, int nHeight );
参数
|
nWidth 指定了插字符的宽度（逻辑单位）。如果这个参数为0，则宽度被设为系统定义的窗口边框宽度。 nHeight 指定了插字符的高度（逻辑单位）。如果这个参数为0，则高度被设为系统定义的窗口边框高度。
|
内容
说明
这个函数为系统插字符创建一个实心矩形，并声明对插字符的所有权。插字符的形状可以是线条，也可以是方块。
参数nWidth和nHeight指定了插字符的宽度和高度（逻辑单位）；实际的宽度和高度（以像素为单位）依赖于映射模式。
使用SM_CXBORDER和SM_CYBORDER索引调用Windows的GetSystemMetrics函数可以获得系统的窗口边框宽度或高度。使用窗口边框的宽度和高度以确保插字符在高分辨率显示中能够看得见。
CreateSolidCaret成员函数自动销毁原来的插字符形状，如果有的话，而并不考虑哪个窗口拥有这个插字符。在被创建之后，插字符是隐藏的。要显示插字符，必须调用ShowCaret成员函数。
2、GetTextMetrics
函数功能：
该函数把程序当前的字体信息，存放到TEXTMETRIC（即MSDN原文中的specified buffer）中。
函数原型：
BOOL GetTextMetrics(HDC hdc, LPTEXTMETRIC lptm)；
参数：
hdc：设备环境句柄。
lptm：指向结构TEXTMETRIC的指针，该结构用于获得字体信息。
返回值：
如果函数调用成功，返回值非零，如果函数调用失败，返回值是0。
Windows NT\2000\XP：若想获得更多错误信息，请调用GetLastError函数。
Windows 95/98/Me:对于这样的版本,需要去下载Microsoft layer提供的MSLU（详见：2008年12月的MSDN）.
需要：
Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本；
头文件：wingdi.h；
库文件：gdi32.lib；
Unicode：在Windows NT环境下实现为Unicode和ANSI两种版本。
包含的头文件：afxwin.h
示例：
BOOL GetTextMetrics(
LPTEXTMETRIC lpMetrics
） const;
参数结构为
TEXTMETRIC Structure
The TEXTMETRIC structure has the following form:
typedef struct tagTEXTMETRIC { /* tm */
int tmHeight; int tmAscent;
int tmDescent;
int tmInternalLeading;
int tmExternalLeading;
int tmAveCharWidth;
int tmMaxCharWidth;
int tmWeight;
BYTE tmItalic;
BYTE tmUnderlined;
BYTE tmStruckOut;
BYTE tmFirstChar;
BYTE tmLastChar;
BYTE tmDefaultChar;
BYTE tmBreakChar;
BYTE tmPitchAndFamily;
BYTE tmCharSet;
int tmOverhang;
int tmDigitizedAspectX;
int tmDigitizedAspectY;
} TEXTMETRIC;
The TEXTMETRIC structure contains basic information about a physical font. All sizes are given in logical units; that is, they depend on the current mapping mode of the display context.
For more complete information about this structure, see TEXTMETRIC in the Win32 SDK documentation.
3、CreateCaret
函数功能
该函数为系统插入标记创建一个新的形状，并且将插入标记的属主关系指定给特定的窗口。插入标记的形状。可以是线、块或位图。
函数原型：BOOL CreateCaret（HWND hWnd，HBIBMAP hBitmap，int nWidth，int nHeight）；
参数
hWnd：指定拥有插入标记的窗口。
hBitmap：标识用于定义插入标记形状的位图。如果该参数为NULL，那么插入标记是实心的（原色），如果该参数为（HBITMAP）1，那么插入标记是灰色的。如果该参数是位图句柄，那么插入标记就是指定的位图。位图句柄必须已中由CreateBitmap、CreatDIBitmap或LoadBitmap函数创建。
如果hBitmap为位图句柄，那么CreateCaret函数将忽略参数nWidth和nHeight，因为该位图定义了自己的宽度和高度。
nWidth：按逻辑单位指定插入标记的宽度，如果该参数为零，那么宽度就设为系统定义的窗口边界宽度。如果hBitmap是位图句柄，那么函数CreateCaret忽略该参数。
nHeight：按逻辑单位指定插入标记的高度。如果该参数为零，那么高度就设为系统定义的窗口边界高度如果hBitmap是位图句柄，那么函数CreateCaret忽略该参数。
返回值：如果函数执行成功，返回值为非零；如果函数执行失败，那么返回值为零。若想获取更多错误 信息，请调用GetLastError函数。
备注：参数nWidth和nHeight指定了插入标记的宽度和高度，这些值按逻辑单位表示；按像素表示的真正 宽度和高度与窗口的映射模式有关。
CreateCaret函数自动清除前一个插入标记的形状，不考虑拥有该插入标记的窗口。新创建的插入标记一直隐藏，直到应用程序调用ShowCaret函数使该插入标记可见为止。
可以通过使用GetSystemMetrics函数，并指定SM_CXBORDER和SM_CYBORDER值来检索系统窗口边界的宽度或高度。使用窗口边界的宽度或高度可以保证插入标记在高分辨率屏幕上可见。
对于Windows CE：Windows CE不支持hBitmap参数，并且该参数应设为NULL。Windows CE缺省的是实心（Solid）插入标记。
速查:Windows NT:3.1及以上版本;Windows:95及以上版本；Windows CE:1.0及以上版本；头文件：winuser.h；库文件:user32.lib。
4、GetTextExtent
函数功能：使用该函数获得所选字体中指定字符串的高度和宽度
函数原型一：CSize GetTextExtent(LPCTSTR lpszString, int nCount) const；
参数：
lpszString是字符串的指针
nCount是指定字符在字符串中的数目
函数原型二： CSize GetTextExtent( const CString& str) const;
参数：
str是一个字符串对象，包含指定的字符。
返回值：
以逻辑单位返回字符串的尺寸，保存在一个CSize对象中。
注意： GetTextExtent 与 GetTextMetrics的区别
对于GetTextExtent 获取的是某个特定的字符串在窗口中显示时所占据的宽度和高度
对于GetTextMetrics 获取的是设备描述表中当前字体的度量信息
5、SelectClipPath
函数功能：该函数选择当前的路径作为设备环境的一个剪切区域。通过使用特定的模式把新的区域与任何存在的剪切区域合并。
函数原型：BOOL SelectClipPath(HDC hdc, int iMode)；
参数：
hdc：设备环境句柄。
iMode：定义使用路径的方法，具取值如下：
RGN_AND：新的剪切区包括当前剪切区域与当前路径的一个交集（重叠区域）。
RGN_COPY：新的剪切区域就是当前的路径。
RGN_DIFF：新的剪切区域包含除了当前路径外的当前剪切区域。
RGN_OR：新的剪切区域包含当前剪切区域与当前路径的并集。
RGN_XOR：新的剪切区域包含当前剪切区域与当前路径的并集但不包含重叠的区域。
返回值：如果函数执行成功，返回非零值；如果函数执行失败，返回值为零。
Windows NT：若想获得更多错误信息，请调用GetLastError函数。GetLastError函数可能会返回如下的代码：
ERROR_CAN_NOT_COMPLETE;ERROR_INYALID_PARAMETER;ERROR_NOT_ENOUGH_MEMORY。
注释：由hdc参数标识的设备环境必须包含一个闭合路径。
速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件：wingdi.h；库文件：gdi32.lib
6 SetCaretPos
函数功能：该函数将插入标记移动到指定的坐标上。如果拥有该插人标记的窗口是使用CS_OWNDC类样式创建的，那么指定的坐标依据与该窗口相关的设备环境的映射模式而定。
函数原型：BOOL SetCaretPos（int X，int Y）；
参数：
X：指定插入标记新的X坐标。
Y：指定插入标记新的Y坐标。
返回值：如果函数执行成功，那么返回值为非零；如果函数执行失败，那么返回值为零。若想获取更多错误信息，请调用GetLastError函数。
备注：函数SetCaretPos不管插入标记是否隐藏都将移动它。系统为每个队列提供一个插入标记。窗口只能对自己拥有的插入标记进行位置的设置。
速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本：头文件：Winuser.h；库文件：user32.lib。
示例：
HWND hwnd, // window handle
int x; // horizontal coordinate of cursor
int y; // vertical coordinate of cursor
int nWidth; // width of cursor
int nHeight; // height of cursor
char *lpszChar; // pointer to character
case WM_SETFOCUS:
// Create a solid black caret.
CreateCaret(hwnd, (HBITMAP) NULL, nWidth, nHeight); // Adjust the caret position, in client coordinates. SetCaretPos(x, y); // Display the caret. ShowCaret(hwnd);
break;
7、DrawText
函数功能
该函数的功能是在指定的矩形里写入格式化文本，根据指定的方法对文本格式化（扩展的制表符，字符对齐、折行等）
要指定额外的格式化选项，请使用DrawTextEx函数。
函数原型
int DrawText(
HDC hDC, // 设备描述表句柄
LPCTSTR lpString, // 将要绘制的字符串
int nCount, // 字符串的长度
LPRECT lpRect, // 指向矩形结构RECT的指针
UINT uFormat // 正文的绘制选项
);
编辑本段参数
hdc：
[输入]设备环境句柄。
lpString：
[输入]指向将被写入的字符串的指针，如果参数nCount是-1，则字符串必须是以\0结束的。 如果uFormat包含DT_MODIFYSTRING，则函数可为此字符串增加4个字符，存放字符串的缓冲区必须足够大，能容纳附加的字符。
nCount：
[输入]指向字符串中的字符数。如果nCount为-1，则lpString指向的字符串被认为是以\0结束的，DrawText会自动计算字符数。
lpRect：
[输入/输出]指向结构RECT的指针，其中包含文本将被置于其中的矩形的信息（按逻辑坐标）。
uFormat：
[输入]指定格式化文本的方法。它可以下列值的任意组合，各值描述如下：
|
值
|
说明
|
|
DT_BOTTOM
|
将正文调整到矩形底部。此值必须和DT_SINGLELINE组合。
|
|
DT_CALCRECT
|
决定矩形的宽和高。
如果正文有多行，DrawText使用lpRect定义的矩形的宽度，并扩展矩形的底部以容纳正文的最后一行。
如果正文只有一行，则DrawText改变矩形的右边界，以容纳下正文行的最后一个字符。
出现上述任何一种情况，DrawText返回格式化正文的高度，而不是绘制正文。
|
|
DT_CENTER
|
使正文在矩形中水平居中。
|
|
DT_EDITCONTROL
|
复制多行编辑控制的正文显示特性。
特殊地，为编辑控制的平均字符宽度是以同样的方法计算的，此函数不显示只是部分可见的最后一行。
|
|
DT_END_ELLIPSIS
|
对于显示的文本，如果结束的字符串的范围不在矩形内，它会被截断并以省略号标识。
如果一个字母不是在字符串的末尾处超出了矩形范围，它不会被截断并以省略号标识。
字符串不会被修改，除非指定了DT_MODIFYSTRING标志。
|
|
DT_EXPANDTABS
|
扩展制表符，每个制表符的缺省字符数是8。
DT_WORD_ELLIPSIS, DT_PATH_ELLIPSIS和DT_END_ELLIPSIS不能和此参数一起使用
|
|
DT_EXTERNALLEADING
|
在行的高度里包含字体的外部标头，通常，外部标头不被包含在正文行的高度里。
|
|
DT_HIDEPREFIX
|
忽略正文中的前缀字符（&），并且前缀字符后面的字母不会出现下划线。其它前缀字符的调用方式不受影响。
输入的字符串： "A&bc&&d"
正常： "Abc&d"
DT_HIDEPREFIX: "Abc&d"
|
|
DT_INTERNAL
|
用系统字体来计算正文度量。
|
|
DT_LEFT
|
正文左对齐。
|
|
DT_MODIFYSTRING
|
修改给定的字符串来匹配显示的正文。
此标志必须和DT_END_ELLIPSIS 或 DT_PATH_ELLIPSIS同时使用。
|
|
DT_NOCLIP
|
无裁剪绘制。当DT_NOCLIP使用时DrawText的使用会有所加快。
|
|
DT_NOFULLWIDTHCHARBREAK
|
在宽字符的字符串中防止行断开，因此折行规则相当于单字符的字符串。
例如，我们可以用在韩国版的windows中，为图标标签提供更好的可读性。
除非指定DT_WORDBREAK，否则此值没有作用。
|
|
DT_NOPREFIX
|
关闭前缀字符的处理。
通常DrawText解释助记前缀字符，&为给其后的字符加下划线，解释&&为显示单个&。指定DT_NOPREFIX，这种处理被关闭。
|
|
DT_PATH_ELLIPSIS
|
对于显示的正文，替换字符串在椭圆中的字符，以确保结果能在合适的矩形内。
如果该字符串包含反斜杠（\）字符，DT_PATH_ELLIPSIS尽可能的保留最后一个反斜杠之后的正文。
字符串不会被修改，除非指定了DT_MODIFYSTRING标志。
|
|
DT_PREFIXONLY
|
仅仅在（&）前缀字符的位置下绘制一个下划线。不绘制字符串中的任何其他字符。
输入的字符串： "A&bc&&d"
正常： "Abc&d"
DT_PREFIXONLY:" _ "
|
|
DT_RIGHT
|
正文右对齐。
|
|
DT_RTLREADING
|
当选择进设备环境的字体是希伯来文或阿拉伯文字体时，为双向正文安排从右到左的阅读顺序都是从左到右的。
|
|
DT_SINGLELINE
|
显示正文的同一行，回车和换行符都不能折行。
|
|
DT_TABSTOP
|
设置制表，参数uFormat的15"C8位（低位字中的高位字节）指定每个制表符的字符数，每个制表符的缺省字符数是8。
注意：DT_CALCRECT, DT_EXTERNALLEADING, DT_INTERNAL,
DT_NOCLIP, DT_NOPREFIX值不能和DT_TABSTOP值一起使用。
|
|
DT_TOP
|
正文顶端对齐。
|
|
DT_VCENTER
|
使正文在矩形中垂直居中。
(DreamSmart注：此值必须和DT_SINGLELINE连用，否则GDI无法计算目的矩形)
|
|
DT_WORDBREAK
|
断开字。当一行中的字符将会延伸到由lpRect指定的矩形的边框时，此行自动地在字之间断开。一个回车一换行也能使行折断。
|
|
DT_WORD_ELLIPSIS
|
截短不符合矩形的正文，并增加省略号。
|
编辑本段返回值
如果函数调用成功，返回值是正文的高度（逻辑单位）。如果指定了DT_VCENTER或DT_BOTTOM，返回值是lpRect->top到绘制的正文的底部的偏移值。
如果函数调用失败，返回值是0
Windows NT：若想获得更多错误信息，请调用GetLastError函数。
编辑本段备注
函数DrawText用设备环境中的字体选择、正文颜色和背景颜色来写正文。DrawText裁剪正文，不会出现在指定矩形的外面，除非指定了DT_NOCLIP。除非使用DT_SINGLELINE格式化，否则其余的格式都认为正文有多行。
如果选择的字体对指定的矩形而言太大，DrawText不会试图去换成一种小字体。
DrawText支持纵和方向均为0的字体。
设备环境的正文对齐方式必须包括TA_LEFT, TA_TOP和TA_NOUPDATECP标志。
Windows CE：如果为参数uFormat指定DT_CALCRECT值，必须为lpRect指向的RECT结构设置right和bottom成员。Windows CE不支持uFormat为DT_EXTERNALLEADING。
编辑本段速查
Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本；头文件：wingdi.h；库文件：gdi32.lib；Unicode：在Windows NT环境下以Unicode和ANSI两种方式实现。
编辑本段在K线图中的运用
格式：drawtext（条件表达式子，位置，‘文字’）；
含义：当条件满足时，在指定的位置显示需提示的汉字；
编写时注意事项：位置要与价格相适应，如果价格在5000，那么位置处用50是显示不出文字的；
文字前后的标点是英文状态下输入的，不能用中文状态输入。
