关于工具条按钮文字的显示

/*****************************************************************/
/*          工具条研究手记（8）- 关于工具条按钮文字的显示        */
/*****************************************************************/

通常情况下，工具条按钮就是一个小的位图，并不显示文字。注意到每个按钮的ID都有一个对应的字符串资源，而且格式是两个字符串xxxxxx\nxxxx。第二个字符串比较短，一般用来作为tips显示，即当鼠标停留在按钮上面的时候，显示一个小的提示窗口。这个文字可以作为工具条按钮的文字和位图一起显示出来。函数SetButtonText用于给按钮添加文字，定义如下：

 BOOL SetButtonText( int nIndex, LPCTSTR lpszText );

其中nIndex给出按钮的序号，lpszText给出按钮的文字。如果工具条按钮的尺寸足够大，则显示图标以后，一般在图标的下方显示文字，比如“打开”，“保存”等。可以在主框架OnCreate函数中生成工具条以后，使用函数SetButtonText给按钮全部加上文字：

int CMainFrame::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
......
 m_wndToolBar.EnableDocking(CBRS_ALIGN_ANY);
 EnableDocking(CBRS_ALIGN_ANY);
 DockControlBar(&m_wndToolBar);
//------------------------------------------------------------------
//首先记录下没有文字的按钮大小
 // CSize NoTextButtonSize; 定义在头文件中
 CRect rect;
 m_wndToolBar.GetItemRect( 0, &rect);
 NoTextButtonSize.cx = rect.Width();
 NoTextButtonSize.cy = rect.Height();

//设置工具条按钮文字
 for (int i=0;i {
  CString strText;
  strText.LoadString(m_wndToolBar.GetItemID(i));
  int j = strText.Find("\n");
  if(j>=0)
  {
   CString strButton = strText.Right(strText.GetLength() - j - 1);
   m_wndToolBar.SetButtonText(i,strButton);
  }
  else
   m_wndToolBar.SetButtonText(i,"");

 }
//计算带有文字的按钮的尺寸，使用最长文字的那个按钮的尺寸：

 // CSize TextButtonSize; 定义在头文件中
 TextButtonSize.cx = TextButtonSize.cy = 0;
 for (i = m_wndToolBar.GetToolBarCtrl().GetButtonCount(); i >= 0; i-- )
 {
  m_wndToolBar.GetItemRect(i, &rect );

  rect.NormalizeRect();
  TextButtonSize.cx = __max( rect.Size().cx, TextButtonSize.cx );
  TextButtonSize.cy = __max( rect.Size().cy, TextButtonSize.cy );
 }

 //m_beShowText是一个BOOL变量，给出工具条按钮是否显示文字，可以保存在INI文件中
 //例如，在构造函数里面读出：
 // m_beShowText = AfxGetApp()->GetProfileInt("setting","ToolbarText",1);
 // 在析构函数里面保存：
 // AfxGetApp()->WriteProfileInt("setting","ToolbarText",m_beShowText);

 

 ModifyToolBar(m_beShowText); //调整按钮的尺寸

 return 0;
}

//ModifyToolBar是一个自定义函数，用于控制工具条按钮是否显示文字。
void CMainFrame::ModifyToolBar(BOOL beShowText)
{
 CSize sizeButton,sizeImage;

 //设置按钮尺寸，这个数值可以根据实际情况调整
 sizeButton.cx = beShowText ? TextButtonSize.cx : NoTextButtonSize.cx;
 sizeButton.cy = beShowText ? TextButtonSize.cy : NoTextButtonSize.cy;
 sizeImage.cx = 16; //图标的大小
 sizeImage.cy = 15;
 m_wndToolBar.SetSizes(sizeButton,sizeImage);

 RecalcLayout();
}

那么如果想设置多行文字显示，或者想在图片的右边显示文字怎么办呢？记住文字也可以做成图片的一部分，所以只要把需要显示的文字和图片拼在一起，然后设置成按钮的图片就可以了。如果想用代码实现也可以，需要自己动态生成图片，比如下面实现多行文字的代码：

// 显示多行工具条文字
BOOL CMTToolBar::ShowText(UINT nIDResource)
{
 //--------------------------------------------------------
 // 第一步：得到单个按钮的图像大小
 HINSTANCE hInst = AfxFindResourceHandle(MAKEINTRESOURCE(nIDResource), RT_TOOLBAR);
 HRSRC hRsrc = ::FindResource(hInst, MAKEINTRESOURCE(nIDResource), RT_TOOLBAR);
 if (hRsrc == NULL)
  return FALSE;

 HGLOBAL hGlobal = LoadResource(hInst, hRsrc);
 if (hGlobal == NULL)
  return FALSE;

 CToolBarData* pData = (CToolBarData*)LockResource(hGlobal);
 if (pData == NULL)
  return FALSE;
 ASSERT(pData->wVersion == 1);

 CSize sizeImage(pData->wWidth, pData->wHeight);

 UnlockResource(hGlobal);
 FreeResource(hGlobal);
 
 //--------------------------------------------------------
 // 第二步：根据工具条窗口dc，计算文字的最大行数，然后计算应该调整的工具条按钮的高度

 CToolBarCtrl& bar = GetToolBarCtrl();
 CDC *pdcCtrl = bar.GetDC();
 CDC dcDst;  // 目标DC , 用于生成新位图
 dcDst.CreateCompatibleDC(pdcCtrl);
 
 // 新建字体
 LOGFONT logFont;
 ZeroMemory(&logFont,sizeof(logFont));
 logFont.lfWidth = 6;
 logFont.lfHeight = 12;
 logFont.lfCharSet = GB2312_CHARSET;
 strcpy(logFont.lfFaceName, "宋体" );
 CFont fntNew;
 fntNew.CreateFontIndirect(&logFont);
 CFont *pfntOld = dcDst.SelectObject(&fntNew);

 // 新单个按钮的图片大小
 CSize sizeNewImage(sizeImage.cx, 0);

 // 创建字符串数组
 const int nCount = bar.GetButtonCount();
 CStringArray *pstrArray = new CStringArray[nCount];
 int nLines = 0;   // 文字行数
 int nIndex = 0;  
 int nCharHeight = 0; // 单个字符高度 
 TBBUTTON tb;
 int nBtnCount = 0;  // 按钮个数（除去分隔条）
 for (int i = 0; i < nCount; ++ i)
 {
  ZeroMemory(&tb, sizeof(TBBUTTON));
  bar.GetButton(i, &tb);

  // 如果是分隔条
  if ((tb.fsStyle & TBSTYLE_SEP) ==  TBSTYLE_SEP)
  { 
   continue;
  }

  CString strT;
  strT.LoadString(tb.idCommand);
  int nPos = strT.Find(_T('\n')) + 1;
  while(nPos > 0)
  {
   int nPos2 = strT.Find(_T('\n'), nPos);
   int nIndex;
   if(nPos2>nPos)
   {
    nIndex = pstrArray[nBtnCount].Add( strT.Mid(nPos, nPos2-nPos) );
    nPos = nPos2 + 1;
   }
   else if(strT.GetLength() > nPos)
   {
    nIndex = pstrArray[nBtnCount].Add( strT.Mid(nPos) );
    nPos = -1;
   }
   nLines = max(nLines, nIndex+1);
   CSize size = dcDst.GetTextExtent(pstrArray[nBtnCount][nIndex]);
   nCharHeight = max(size.cy, nCharHeight);
   sizeNewImage.cx = max(size.cx, sizeNewImage.cx);
  }
  nBtnCount ++;
 }
 // 换算成实际像素
 sizeNewImage.cy = nLines*nCharHeight;

 //--------------------------------------------------------
 //第三步：动态创建工具条按钮位图，并替换原来的Imagelist

 // 读取工具条位图资源
 CBitmap  bmpToolBar;
 BITMAP  bmBitmap;
 if (!bmpToolBar.Attach(LoadImage(AfxGetInstanceHandle(),
      MAKEINTRESOURCE(nIDResource),  IMAGE_BITMAP, 0, 0,
                          LR_DEFAULTSIZE|LR_CREATEDIBSECTION | LR_LOADMAP3DCOLORS )) ||
     !bmpToolBar.GetBitmap(&bmBitmap))
  return FALSE;

 // 取得位图总宽高
 int nWidth = bmBitmap.bmWidth;
 int nHeight = bmBitmap.bmHeight;

 // 新位图的总宽高
 int nWidthNew = sizeNewImage.cx * nBtnCount;
 sizeNewImage.cy += nHeight;
 int nHeightNew = sizeNewImage.cy;

 CDC dcSrc; // 源DC
 dcSrc.CreateCompatibleDC(pdcCtrl);
 CBitmap *pbmpOldSrc = dcSrc.SelectObject(&bmpToolBar);

 CBitmap bmpDst; // 新位图
 bmpDst.CreateCompatibleBitmap(&dcSrc, nWidthNew, nHeightNew);
 CBitmap *pbmpOldDst = dcDst.SelectObject(&bmpDst);

 // 先填充背景色
 dcDst.FillSolidRect(CRect(0, 0, nWidthNew, nHeightNew),  ::GetSysColor(COLOR_BTNFACE));
 dcDst.SetBkMode(TRANSPARENT); // 设置透明背景方式

 int nStartX = (sizeNewImage.cx-sizeImage.cx)/2; // 计算开始横坐标，用于居中处理
 // 开始制作工具条位图
 for( i = 0; i < nBtnCount; ++ i)
 {
  dcDst.BitBlt(i*sizeNewImage.cx+nStartX, 0, sizeImage.cx, sizeImage.cy,
      &dcSrc, i*sizeImage.cx, 0, SRCCOPY);
  int j;
  for(j = 0; j < pstrArray[i].GetSize(); j ++)
  {
   CSize size = dcDst.GetTextExtent(pstrArray[i][j]);
   int nStratX = (sizeNewImage.cx-size.cx)/2;
   dcDst.TextOut(i*sizeNewImage.cx+nStratX, sizeImage.cy+j*nCharHeight, pstrArray[i][j]);
  }
 }

 // 恢复DC并释放资源
 dcSrc.SelectObject(pbmpOldSrc);
 dcDst.SelectObject(pbmpOldDst);
 dcDst.SelectObject(pfntOld);
 bar.ReleaseDC(pdcCtrl);
 delete [] pstrArray;

 //--------------------------------------------------------
 //第四步，设置工具条

 // 重新设置大小
 SetSizes(sizeNewImage + CSize(7,7), sizeNewImage);
 // 替换工具条位图
 AddReplaceBitmap((HBITMAP)bmpDst.Detach());

 return TRUE;
}

上述代码中，把计算新的按钮图片高度 sizeNewImage.cy 改成计算新的按钮图片宽度sizeNewImage.cx，然后制作工具条位图的时候，把原始图片贴在左侧，把文字写在右侧，就实现右侧文字的工具条按钮了。
由于工具条按钮图片通常不变化，所以上述代码意义不大，可以作为学习参考。

 

//--------------------------------------
// End
// iwaswzq 2004/12/6