《Windows API每日一练》5.5 插入符号

当你向程序中输入文本时，通常会有下划线、竖线或方框指示你输入的下一个字符将出现在屏幕上的位置。你也许认为这是“光标”，但在编写Windows程序时，你必须避免这种习惯。在Windows中，它被称为“插入符号”（caret）。“光标”（cursor）特指表示鼠标位置的位图图像，即鼠标指针。

本节必须掌握的知识点：

关于插入符号的函数

第34练：文本编辑器插入符号

5.5.1 关于插入符号的函数

■Windows中有五个基本的插入符号函数：

●CreateCaret：创建和窗口关联的插入符号。

●SetCaretPos：设置窗口内的插入符号的位置。

●ShowCaret：显示插入符号。

●HideCaret：险藏插入符号。

●DestroyCaret：销毁插入符号。

■操作插入符的函数

此外，还有用于获得当前插入符号位置的函数（GetCaretPos）与获得和设置插入符号闪烁时间的函数（GetCaretBlinkTime 和 SetCaretBlinkTime）。

●GetCaretPos 函数的原型：

BOOL GetCaretPos(

LPPOINT lpPoint // 接收光标位置的指针

);

返回值：

如果函数调用成功，返回值为非零值（TRUE）。

如果函数调用失败，返回值为零（FALSE）。

使用 GetCaretPos 函数可以获取当前光标的位置，即光标在屏幕上的坐标。通过传递一个指向 POINT 结构的指针，函数将光标的坐标信息存储在该结构中。

示例代码：

#include <Windows.h>

int main() {

POINT caretPos;

// 获取光标位置

if (GetCaretPos(&caretPos)) {

// 输出光标的坐标

printf("Caret position: x = %d, y = %d\n", caretPos.x, caretPos.y);

} else {

// 获取光标位置失败

printf("Failed to get caret position.\n");

}

return 0;

}

●GetCaretBlinkTime函数原型：

UINT GetCaretBlinkTime();

返回值：

返回一个无符号整数，表示光标闪烁的时间间隔（以毫秒为单位）。

使用 GetCaretBlinkTime 函数可以获取当前系统中光标闪烁的时间间隔。光标闪烁是指光标在显示和隐藏之间的交替效果。

示例代码：

#include <Windows.h>

int main() {

UINT blinkTime = GetCaretBlinkTime();

// 输出光标闪烁时间间隔

printf("Caret blink time: %u ms\n", blinkTime);

return 0;

}

●SetCaretBlinkTime函数原型：

BOOL SetCaretBlinkTime(

UINT uMSeconds // 光标闪烁的时间间隔（以毫秒为单位）

);

返回值：

如果函数调用成功，返回值为非零值（TRUE）。

如果函数调用失败，返回值为零（FALSE）。

使用 SetCaretBlinkTime 函数可以设置光标闪烁的时间间隔。你可以将所需的时间间隔（以毫秒为单位）作为参数传递给该函数。

示例代码：

#include <Windows.h>

int main() {

UINT blinkTime = 500; // 设置光标闪烁时间间隔为 500 毫秒

// 设置光标闪烁时间间隔

if (SetCaretBlinkTime(blinkTime)) {

printf("Caret blink time set successfully.\n");

} else {

printf("Failed to set caret blink time.\n");

}

return 0;

}

■处理插入符

在Windows中，插入符号通常是一个字符大小的水平线或方框，或是与字符高度相一致的竖线。使用变宽字体的时候推荐使用竖线插入符号，比如Windows默认系统字体。因为变宽字体字符不是固定大小的，不能把水平线或者方框设置为字符的大小。

如果你的程序中需要插入符号，那么不应该简单地在窗口过程的WM_CREATE消息中创建它并在WM_DESTROY消息中销毁它。不建议你这样做的原因是一个消息队列仅能够支持一个插入符号。因此，如果你的程序有多于一个窗口，则多个窗口必须有效地共享同一个插入符号。

这并不像听起来那样有限制性。你想一下，仅当窗口具有输入焦点时，窗口中插入符号的显示才有意义。的确，闪烁的插入符号的存在是一种视觉提示：它让用户意识到他可以向程序中输入文本。因为任何时候仅有一个窗口具有输入焦点，所有多个窗口同时使插入符号闪烁是没有意义的。

程序能通过处理WM_SETFOCUS消息和WM_KILLFOCUS消息来决定它是否具有输入焦点。正如名称所暗示的，当窗口过程接收输入焦点时，它接收到一个WM_SETFOCUS 消息：当它失去输入焦点时，收到一个WM_KILLFOCUS消息。这些消息成对出现：窗口过程在接收到一条WM_KILLFOCUS消息前，总是会接收到一条WM_SETFOCUS消息。并且在窗口的生命期窗口过程总是接收到相同数目的WM_SETFOCUS消息和 WM_KILLFOCUS 消息。

使用插入符号的主要规则很简单：在窗口过程处理WM_SETFOCUS消息时调用 CreateCaret 函数，处理 WM_KILLFOCUS 消息时调用 DestroyCaret 函数。

还有一些其他规则：创建的插入符号是隐藏的。在调用CreateCaret之后，窗口过程必须调用ShowCaret使之可见。另外，如果窗口过程处理的是一个非WM_PAINT消息，但要在窗口内绘制某些东西时，它必须调用HideCaret隐藏插入符号。当它结束在窗口内的绘制之后，再调用ShowCaret来显示插入符号。HideCaret的效果是叠加的：如果你调用了HideCaret很多次，但没调用过ShowCaret，那么你必须再调用同样次数的ShowCaret才能使插入符号可见。

5.5.2 第34练：文本编辑器插入符号

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

034 WIN32 API 每日一练

第34个例子TYPER.C：文本编辑器---插入符号

GetFocus函数

CreateCaret函数

SetCaretPos函数

ShowCaret函数

HideCaret函数

DestroyCaret函数

GetCaretPos函数

WM_SETFOCUS消息

WM_KILLFOCUS消息

注：TYPER程序不允许使用双字节宽度的字符

无搜索，替换，保存文件，拼写检查，滚动，帮助等扩展功能。

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

#include <windows.h>

#define BUFFER(x,y) *(pBuffer + y * cxBuffer + x)

TCHAR * pBuffer = NULL;

LRESULT CALLBACK WndProc (HWND, UINT, WPARAM, LPARAM) ;

int WINAPI WinMain (HINSTANCE hInstance, HINSTANCE hPrevInstance,

PSTR szCmdLine, int iCmdShow)

{

static TCHAR szAppName[] = TEXT("Typer");

…(略)

return msg.wParam;

}

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

{

static DWORD dwCharSet = DEFAULT_CHARSET ;//#define DEFAULT_CHARSET 1

static int cxChar, cyChar, cxClient, cyClient,

cxBuffer, cyBuffer,xCaret, yCaret ;

//static TCHAR * pBuffer = NULL ;

HDC hdc ;

int x, y, i ;

PAINTSTRUCT ps ;

TEXTMETRIC tm ;

switch (message)

{

case WM_INPUTLANGCHANGE:

dwCharSet = wParam ;

//继续执行下去

case WM_CREATE:

hdc = GetDC (hwnd) ;

//创建逻辑字体

SelectObject ( hdc, CreateFont (0, 0, 0, 0, 0, 0, 0, 0,

dwCharSet, 0, 0, 0, FIXED_PITCH, NULL)) ;

//获取字体信息

GetTextMetrics (hdc, &tm) ;

cxChar = tm.tmAveCharWidth ;

cyChar = tm.tmHeight ;

DeleteObject (SelectObject (hdc, GetStockObject (SYSTEM_FONT))) ;

ReleaseDC (hwnd, hdc) ;

//继续执行下去

case WM_SIZE:

// 获取窗口大小，以像素为单位

if (message == WM_SIZE)

{

cxClient = LOWORD (lParam) ;

cyClient = HIWORD (lParam) ;

}

// 计算窗口大小(字符)

cxBuffer = max (1, cxClient / cxChar) ; //cxBuffer窗口字符宽度

cyBuffer = max (1, cyClient / cyChar) ; //cyBuffer窗口字符高度

// 为缓冲区分配内存并清除它

if (pBuffer != NULL)

free (pBuffer) ;

//创建保存窗口所有字符的缓冲区

pBuffer = (TCHAR *) malloc (cxBuffer * cyBuffer * sizeof (TCHAR)) ;

//初始化pBuffer为一个‘ ’空字符

for (y = 0 ; y < cyBuffer ; y++)

for (x = 0 ; x < cxBuffer ; x++)

BUFFER(x,y) = ' ' ;

// 插入符号定位左上角

xCaret = 0 ;

yCaret = 0 ;

if (hwnd == GetFocus ()) //插入符号为当前窗口---焦点窗口

//设置插入符号位置

SetCaretPos (xCaret * cxChar, yCaret * cyChar) ;

InvalidateRect (hwnd, NULL, TRUE) ; //重绘窗口

return 0 ;

//获得键盘焦点后发送到窗口

case WM_SETFOCUS:

// 创建和显示插入符号，指定大小，NULL表示实心

CreateCaret (hwnd, NULL, cxChar, cyChar) ;

SetCaretPos (xCaret * cxChar, yCaret * cyChar) ; //设置符号位置

ShowCaret (hwnd) ; //显示符号

return 0 ;

//在失去键盘焦点之前立即发送到窗口

case WM_KILLFOCUS:

// 隐藏和删除插入符号

HideCaret (hwnd) ; //隐藏符号

DestroyCaret () ; //删除符号

return 0 ;

//击键消息---光标移动的处理

case WM_KEYDOWN:

switch (wParam)

{

case VK_HOME:

xCaret = 0 ;

break ;

case VK_END:

xCaret = cxBuffer - 1 ;

break ;

case VK_PRIOR: //Page Up

yCaret = 0 ;

break ;

case VK_NEXT: //PageDown

yCaret = cyBuffer - 1 ;

break ;

case VK_LEFT:

xCaret = max (xCaret - 1, 0) ;

break ;

case VK_RIGHT:

xCaret = min (xCaret + 1, cxBuffer - 1) ;

break ;

case VK_UP:

yCaret = max (yCaret - 1, 0) ;

break ;

case VK_DOWN:

yCaret = min (yCaret + 1, cyBuffer - 1) ;

break ;

case VK_DELETE: //注意VK_BACK键当字符消息去处理，这里只处理VK_DELETE

//将该行从当前位置后面字符依次前移一格

for (x = xCaret ; x < cxBuffer - 1 ; x++)

BUFFER(x, yCaret) = BUFFER(x + 1, yCaret);

BUFFER(cxBuffer - 1, yCaret) = ' ';//该行最后一个设为空字符。

//绘图前必须先隐藏插入符

HideCaret(hwnd);

hdc = GetDC(hwnd);

SelectObject(hdc, CreateFont(0, 0, 0, 0, 0, 0, 0, 0,

dwCharSet, 0, 0, 0, FIXED_PITCH, NULL));

TextOut(hdc, xCaret * cxChar, yCaret * cyChar,

&BUFFER(xCaret, yCaret),

cxBuffer - xCaret); //重新输出该行xCaret后面的文字

DeleteObject(SelectObject(hdc, GetStockObject(SYSTEM_FONT)));

ReleaseDC(hwnd, hdc);

ShowCaret(hwnd);

break;

}

SetCaretPos(xCaret * cxChar, yCaret * cyChar);

return 0;

//字符消息

case WM_CHAR:

for (i = 0 ; i < (int) LOWORD (lParam) ; i++)

{

//转义字符处理

switch (wParam)

{

case '\b': // 退格

if (xCaret > 0)

{

xCaret--;

//1为repeat字段的值

SendMessage(hwnd, WM_KEYDOWN, VK_DELETE, 1);

}

break;

case '\t': //Tab键，8个字符长度

{

SendMessage (hwnd, WM_CHAR, ' ', 1) ;

} while (xCaret % 8 != 0) ;

break ;

case '\n': //换行符，改变y到下一行，x坐标没变。

if (++yCaret == cyBuffer)

yCaret = 0 ;

break ;

case '\r': // 回车

xCaret = 0;

if (++yCaret == cyBuffer)

yCaret = 0;

break;

//ESC键，清空屏幕 \xhh表示1到2位十六进制所代表的任意字符

case '\x1B':

for (y = 0; y < cyBuffer; y++)

for (x = 0; x < cxBuffer; x++)

BUFFER(x, y) = ' ';

xCaret = 0;

yCaret = 0;

InvalidateRect(hwnd, NULL, FALSE);

break;

default: // 字符编码

BUFFER(xCaret, yCaret) = (TCHAR)wParam;

HideCaret(hwnd);

hdc = GetDC(hwnd);

SelectObject(hdc, CreateFont(0, 0, 0, 0, 0, 0, 0, 0,

dwCharSet, 0, 0, 0, FIXED_PITCH, NULL));

TextOut(hdc, xCaret * cxChar, yCaret * cyChar,

&BUFFER(xCaret, yCaret), 1);

DeleteObject(

SelectObject(hdc, GetStockObject(SYSTEM_FONT)));

ReleaseDC(hwnd, hdc);

ShowCaret(hwnd);

if (++xCaret == cxBuffer)

{

xCaret = 0;

if (++yCaret == cyBuffer)

yCaret = 0;

}

break;

}

SetCaretPos (xCaret * cxChar, yCaret * cyChar) ;

return 0 ;

case WM_PAINT:

hdc = BeginPaint (hwnd, &ps) ;

SelectObject (hdc, CreateFont (0, 0, 0, 0, 0, 0, 0, 0,

dwCharSet, 0, 0, 0, FIXED_PITCH, NULL)) ;

for (y = 0 ; y < cyBuffer ; y++)

TextOut (hdc, 0, y * cyChar, & BUFFER(0,y), cxBuffer) ;

DeleteObject (SelectObject (hdc, GetStockObject (SYSTEM_FONT))) ;

EndPaint (hwnd, &ps) ;

return 0 ;

case WM_DESTROY:

if (pBuffer != NULL) free(pBuffer);

PostQuitMessage(0);

return 0;

}

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

}

/*************************************************************************

CreateCaret：创建和窗口关联的插入符号

SetCaretPos：设置窗口内的插入符号的位置

ShowCaret ：显示插入符号

HideCaret ：隐藏插入符号

DestroyCaret：销毁插入符号

GetCaretPos ：当前插入符号的位置

GetFocus函数：检索具有键盘焦点的窗口的句柄

**************************************************************************

WM_SETFOCUS消息：获得键盘焦点后发送到窗口

#define WM_SETFOCUS 0x0007

参数：wParam

失去键盘焦点的窗口句柄。此参数可以为NULL。

lParam：不使用此参数。

**************************************************************************

WM_KILLFOCUS消息：在失去键盘焦点之前立即发送到窗口

#define WM_SETFOCUS 0x0008

参数：wParam

失去键盘焦点的窗口句柄。此参数可以为NULL。

lParam：不使用此参数。

运行结果：

图5-7 文本编辑器插入符

总结

实例TYPER.C创建了一个简单的文本编辑器。

●窗口过程首先通过M_INPUTLANGCHANGE消息获取当前字符集，然后在WM_CREATE消息中选入新创建的逻辑字体，并获取新逻辑字体的字符宽和高。

●在WM_SIZE消息中，当窗口客户区大小发生变化时，使用空格字符清空窗口客户区，然后将插入符置于窗口客户区的左上角，然后重绘窗口。【注意】前提时当前窗口为焦点窗口。

●当窗口获得焦点时，窗口过程处理M_SETFOCUS消息，创建、设置并显示插入符。

●当窗口失去焦点时，窗口过程处理WM_KILLFOCUS消息，隐藏并删除插入符。

●在按键消息WM_KEYDOWN中，处理HOME、END、PageUp、PageDown和上下左右箭头键，计算插入符的新位置。处理Delete键稍微复杂一些，先将当前位置后面的字符依次前移一个位置，并在该行字符的结尾处添加一个空格。【注意】移动字符时，先隐藏插入符，再选入新创建的逻辑字体绘制字符，绘制完成后重新显示插入符。所有字符重新绘制完成后，重新将插入符置于该行字符的结尾处。

●窗口过程在WM_CHAR消息代码块绘制字符。我们把字符分为两类：

转义字符处理：

'\b'将字符位置减一，然后转为Delete按键消息处理。

'\t'：转换为空格字符消息处理。

'\n'：将字符yCaret加一（行数加一）。

'\r'：将字符xCaret清零（列数清零）。

'\x1B'：ESC键清空屏幕（窗口客户区输出空格），并将插入符坐标清零。

正常可见字符的处理：与Delete键的处理过程类似，先隐藏插入符，然后绘制字符后再重新显示插入符，再将插入符置于下一个位置。

●WM_PAINT消息选入新的逻辑字体绘制所有字符。

【注意】

实例创建的简单文本编辑器并不完善，并不支持复制、粘贴、剪切、选择等功能，也没有对应的菜单选项。我们将在后续的章节中逐步完善此文本编辑器。

此外，当我们输入中文字符时，需要收到将插入符后移一个位置，等待输入下一个字符。