社区首页 >专栏 >【Windows编程】系列第十篇：文本插入符

【Windows编程】系列第十篇：文本插入符

程序员互动联盟

发布于 2018-03-14 06:57:20

1.8K00

代码可运行

文章被收录于专栏：程序员互动联盟程序员互动联盟

运行总次数：0

代码可运行

大家知道，在使用微软的编程环境创建工程时会让你选择是控制台模式还是Windows应用程序。如果选择控制台的console模式，就会在运行时出现一个黑洞洞的字符模式窗口，里面就有等待输入一闪一闪的插入符。输入光标从DOS时代就存在，但是在Win32中赋予了更强大的功能。下图就是Windows的CMD窗口，其中的输入点就是插入光标：

要注意的是这里的插入符或插入光标并不是Windows中另外一个“光标”，这里是指示插入字符的位置，而不是用于鼠标，手写输入等可以定位、移动的光标（Cursor），而是插入符Caret，本文也成为插入光标，注意插入二字，为了方便，以下在本文中也简称为光标或插入符，但要注意此光标非彼光标。

为什么会有插入光标（插入符）？了解了这个基本问题，就成功了一半了。我们知道计算机可以通过键盘来输入各种字符和控制符，那么自然就存在一个问题，输入的字符应该放到屏幕的什么位置？这个就是光标产生的原因，光标实际上就是一个字符插入标识。简单的说就是我们想把字符输入到哪个位置，就先把插入符设置到那里，设置时其实就是告诉电脑输入的字符你给我在哪里显示！从这个我们也可以推断，插入符在同一时刻只能有一个。

光标相关API函数

要使用光标，首先得创建一个光标，创建光标的API函数为：

BOOL CreateCaret(HWND hWnd, HBITMAP hBitmap, int nWidth, int nHeight);

hWnd参数表示光标是属于哪个窗口。

hBitmap参数是一个位图的句柄，计算机将使用这个句柄的位图来作为光标的形状。

既然光标是给使用电脑的人插入字符用的，那就得有形状让使用者能看到，因此光标需要有一个可见的小图标。当然为了不同的情况和需求，Windows让我们可以自定义光标的形状。常见的位图创建或者加载API函数如CreateBitmap、CreateDIBitmap、LoadBitmap等都可以创建或加载一个位图，将句柄作为该参数。

nWidth和nHeight分别是位图的宽和高。

光标创建之后是不会自动显示的，也就是默认是隐藏状态，需要主动调用下面的显示函数：

BOOL ShowCaret(HWND hWnd);

当然有显示光标也可以隐藏光标：

BOOL HideCaret(HWND hWnd);

以上两个函数的参数很简单，都是要显示窗口的句柄。

要设置插入符的位置，使用下面API函数：

BOOL SetCaretPos(int X, int Y);

参数X、Y分别是相对于窗口客户区的坐标。

我们可以用如下API函数获取当前光标的位置：

BOOL GetCaretPos(LPPOINT lpPoint);

参数lpPoint返回当前光标所在的位置。

我们知道光标会闪烁，这个闪烁的时间间隔是可以设置的，我们可以用如下API来设置和获取插入光标的闪烁时间：

BOOL SetCaretBlinkTime(UINT uMSeconds);
UINT GetCaretBlinkTime(VOID);

参数uMSeconds为闪烁的间隔毫秒数。

最后不再使用时需要销毁光标：

BOOL DestroyCaret(VOID);

光标处理相关消息

与插入光标相关的消息主要有WM_SETFOCUS、WM_KILLFOCUS。通常在WM_SETFOCUS中创建和显示光标，而在WM_KILLFOCUS中销毁光标。一般应有中再结合WM_KEYDOWN和WM_CHAR消息，实现文本的输入。

光标应用实例

以下是一个简单的虚拟终端，我们常见的很多终端软件都是这样来实现的，比如常见的SecureCRT、Tera Term、XShell、putty等等。本实例就是用了插入光标来实现字符输入、插入，部分关键代码如下，完整实例代码请猛戳左下角阅读原文：

#include <windows.h>

//处理字符输入
static void DrawChar(HDC hDC, int x, int y, TCHAR *str, int num)
{
    RECT rect;
    SelectObject(hDC, GetStockObject(SYSTEM_FIXED_FONT));
    SetTextColor(hDC, TextColor);
    SetBkMode(hDC, TRANSPARENT);
    rect.left = x;
    rect.top = y;
    rect.right = x + num * nCharWidth;
    rect.bottom = y + nCharHeight;
    FillRect(hDC, &rect, (HBRUSH)GetStockObject(BLACK_BRUSH));
    TextOut(hDC, nCaretPosX * nCharWidth, nCaretPosY * nCharHeight, &TEXTMATRIX(nCaretPosX, nCaretPosY), nLineChars - nCaretPosX);
}

static LRESULT CALLBACK VTWndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
{
int x, y;
HDC hDC;

switch (message)
{
case WM_CREATE:
   hDC = GetDC(hWnd);
   SelectObject(hDC, GetStockObject(SYSTEM_FIXED_FONT));
   GetTextMetrics(hDC, &tm);
   ReleaseDC(hWnd, hDC);
   nCharWidth = tm.tmAveCharWidth;
   nCharHeight = tm.tmHeight;
   TextColor = RGB(255, 255, 255);
   nCaretOffsetY = 12;
   return 0;

case WM_SIZE:
   nVTWidth = LOWORD(lParam);
   nLineChars = max(1, nVTWidth/nCharWidth);
   nVTHeight = HIWORD(lParam);
   nRowChars = max(1, nVTHeight/nCharHeight);
        
   if (pTextMatrix != NULL)
   {
     free(pTextMatrix);
   }
   pTextMatrix = (TCHAR *)malloc(nLineChars * nRowChars);
   if (pTextMatrix)
   {
     for (y=0; y<nRowChars; y++)
     {
       for (x=0; x<nLineChars; x++)
       {
         TEXTMATRIX(x, y) = TEXT(' ');
       }
     }
   }
   SetCaretPos(0, nCaretOffsetY);
   return 0;

case WM_LBUTTONDOWN:
   SetFocus(hWnd);
   break;

case WM_KEYDOWN:
   switch (wParam)
   {
   case VK_HOME:  
     nCaretPosX = 0;
     break; 

   case VK_END: 
     nCaretPosX = nLineChars - 1;
     break; 

   case VK_PRIOR: 
     nCaretPosY = 0; 
     break; 

   case VK_NEXT:
     nCaretPosY = nRowChars -1; 
     break; 

   case VK_LEFT: 
     nCaretPosX = max(nCaretPosX - 1, 0); 
     break; 

  case VK_RIGHT:  
     nCaretPosX = min(nCaretPosX + 1, nLineChars - 1); 
     break; 

  case VK_UP:  
     nCaretPosY = max(nCaretPosY - 1, 0); 
     break; 

  case VK_DOWN: 
     nCaretPosY = min(nCaretPosY + 1, nRowChars - 1); 
     break; 

  case VK_DELETE:  
     for (x = nCaretPosX; x < nLineChars; x++) 
       TEXTMATRIX(x, nCaretPosY) = TEXTMATRIX(x + 1, nCaretPosY); 
     TEXTMATRIX(nLineChars - 1, nCaretPosY) = ' '; 
     HideCaret(hWnd); 
     hDC = GetDC(hWnd); 
     DrawChar(hDC, nCaretPosX * nCharWidth, nCaretPosY * nCharHeight,&TEXTMATRIX(nCaretPosX, nCaretPosY), nLineChars - nCaretPosX/nCharWidth);
     ReleaseDC(hWnd, hDC); 
     ShowCaret(hWnd); 
   break; 
 } 
 SetCaretPos(nCaretPosX * nCharWidth, nCaretPosY * nCharHeight + nCaretOffsetY); 
    return 0;

case WM_SHOWWINDOW:
  SetFocus(hWnd);
  break;

case WM_SETFOCUS:
  CreateCaret(hWnd, NULL, nCharWidth, 2);
  SetCaretPos(nCaretPosX * nCharWidth, nCaretPosY * nCharHeight + nCaretOffsetY);
  ShowCaret(hWnd);
  break;

case WM_KILLFOCUS:
case WM_DESTROY:
  HideCaret(hWnd);
  DestroyCaret();
  break;

case WM_CHAR:
  switch (wParam)
  {
    case 0x08: 
     if (nCaretPosX > 0)
     {
        nCaretPosX--;
        SendMessage(hWnd, WM_KEYDOWN, VK_DELETE, 1L);
     }
     break;
    case 0x09: 
     do
     {
       SendMessage(hWnd, WM_CHAR, TEXT(' '), 2L);
     } while (nCaretPosX % 4 != 0);
     break;
    case 0x0D: 
      nCaretPosX = 0;
       if (++nCaretPosY == nRowChars)
       {
          nCaretPosY = 0;
       }
       break;
     case 0x1B:
     case 0x0A: 
       MessageBeep((UINT)-1);
       break;
     default:
       TEXTMATRIX(nCaretPosX, nCaretPosY) = (TCHAR)wParam;
       HideCaret(hWnd);
       hDC = GetDC(hWnd);
       DrawChar(hDC, nCaretPosX * nCharWidth, nCaretPosY * nCharHeight, &TEXTMATRIX(nCaretPosX, nCaretPosY), 1);
       ReleaseDC(hWnd, hDC);
       ShowCaret(hWnd);
       if (++nCaretPosX == nLineChars)
       {
           nCaretPosX = 0;
           if (++nCaretPosY == nRowChars)
           {
              nCaretPosY = 0;
           }
       }
       break;
    }
    SetCaretPos(nCaretPosX * nCharWidth, nCaretPosY * nCharHeight + nCaretOffsetY);
    return 0;

 case WM_PAINT:
 {
    PAINTSTRUCT ps;
    hDC = BeginPaint(hWnd, &ps);
    SelectObject(hDC, GetStockObject(SYSTEM_FIXED_FONT));
    SetBkMode(hDC, TRANSPARENT);
    SetTextColor(hDC, TextColor);
    for (y=0; y<nLineChars; y++)
    {
      TextOut(hDC, 0, y * nCharHeight, &TEXTMATRIX(0, y), nLineChars);
    }
    EndPaint(hWnd, &ps);
 }
 return 0;
 default:
  break;
 }

 return DefWindowProc (hWnd, message, wParam, lParam);}