细谈SetButtonInfo函数及其用途

SetButtonInfo用于设置某个按钮,它的接口定义如下:

下面是它的几个接口函数说明:

void CToolBar::SetButtonInfo(int nIndex, UINT nID, UINT nStyle, int iImage)

注意CToolBarCtrl类也有这个函数,但是它们的定义是完全不同的,实际上,CToolBar::SetButtonInfo的代码如下:

void CToolBar::SetButtonInfo(int nIndex, UINT nID, UINT nStyle, int iImage)

{

ASSERT_VALID(this);

TBBUTTON button;

_GetButton(nIndex, &button);

TBBUTTON save;

memcpy(&save, &button, sizeof(save));

button.idCommand = nID;

button.iBitmap = iImage;

button.fsStyle = (BYTE)LOWORD(nStyle);

button.fsState = (BYTE)HIWORD(nStyle);

if (memcmp(&save, &button, sizeof(save)) != 0)

{

  _SetButton(nIndex, &button);

  m_bDelayedButtonLayout = TRUE;

}

}

msdn介绍说这个函数的功能是设置工具条按钮的 ID, style, 以及图片的编号。因此,通常这个函数有三个方面的用途:

(1)用于在工具条中添加其他控件

需要注意的是,当给出的nStyle是TBBS_SEPARATOR的时候,iImage是指它的宽度,而不是图片的编号。这个功能在向工具条中添加其它控件(比如编辑控件、组合框控件)的时候非常有用,它可以改变按钮的位置,为添加的控件留出空间。这个在后面将谈到。

(2)用于改变工具条中按钮的样式

例如:

    m_wndToolBar.SetButtonInfo(i, ID_FILE_SAVE, TBBS_CHECKBOX, 2);

该代码将工具条按钮ID_FILE_SAVE设置成CHECKBOX按钮,即单击该按钮显示按下,再次单击显示抬起。

例如:

    int i = m_wndToolBar.CommandToIndex( ID_BUTTON1);

    m_wndToolBar.SetButtonInfo(i, ID_BUTTON1, TBBS_GROUP|TBBS_CHECKBOX      , 9);

    m_wndToolBar.SetButtonInfo(i+1, ID_BUTTON2, TBBS_GROUP |TBBS_CHECKBOX  , 10);

    m_wndToolBar.SetButtonInfo(i+2, ID_BUTTON3, TBBS_GROUP |TBBS_CHECKBOX  , 11);

该代码设置三个相邻的按钮为互斥按钮,即同一时刻只能有一个按钮按下。

TBBS_GROUP |TBBS_CHECKBOX  等价于  TBBS_CHECKGROUP

例如:

    int i = m_wndToolBar.CommandToIndex( ID_BUTTON1);

    m_wndToolBar.SetButtonInfo(i, ID_BUTTON1, TBBS_SEPARATOR  , 0);

上述代码将一个按钮设置成分隔条,并设置它的宽度为0,这可以用于动态隐藏工具条按钮

需要的时候,还可以把它重新显示回来:

    int i = m_wndToolBar.CommandToIndex( ID_BUTTON1);

    m_wndToolBar.SetButtonInfo(i, ID_BUTTON1, TBBS_BUTTON  , 9);

当然,nStyle参数不仅仅可以用msdn上面提到的几种,比如CToolBarCtrl::SetButtonInfo就有更为强大的功能,这个以后会谈到。

(3)改变工具条按钮的图片。有的时候想在程序运行过程中,根据某些条件动态改变按钮的图片,

就可以用这个函数。方法如下:

(1) 在资源里面添加一个位图文件IDB_BITMAP1,注意它的高度和工具条位图的高度保持一致,然后里面可以有几个按钮图片。

(2) 工具条生成以后,把这些图片添加到工具条的图片列表:

CToolBarCtrl &toolctrl = m_wndToolBar.GetToolBarCtrl();

int TotalImage =toolctrl.AddBitmap(N, IDB_BITMAP1);  //N给出位图中图片的个数

    这个时候TotalImage里面就保存了工具条里面已经保存的按钮图片的个数,它比实际按钮个数要多,你可以

把这个值保存在CMainFrame类里面,供以后使用

(3) 在需要更换工具条按钮图片的时候,这样写:

int index = m_wndToolBar.CommandToIndex(ID_FILE_SAVE);

m_wndToolBar.SetButtonInfo(index, ID_FILE_SAVE, TBBS_BUTTON, TotalImage-1);

则将ID_FILE_SAVE按钮的图片设置成图片列表中的最后一个。

CToolBar::SetButtonInfo

 

调用此成员函数上设置按钮的命令ID、样式和图像数字。

 
void SetButtonInfo(
   int nIndex,
   UINT nID,
   UINT nStyle,
   int iImage 
);
nIndex

信息将设置按钮或分隔符的从零开始的索引。

nID

按钮的命令ID设置的值。

nStyle

新的按钮样式。 以下按钮样式支持:

  • TBBS_BUTTON 标准普通按钮(默认值)

  • TBBS_SEPARATOR 分隔符

  • TBBS_CHECKBOX 自动复选框按钮

  • TBBS_GROUP 指示的某个按钮组的开头

  • TBBS_CHECKGROUP 指示复选框按钮的一组的开头

  • TBBS_DROPDOWN 创建一个下拉列表按钮。

  • TBBS_AUTOSIZE 按钮的宽度基于按钮的文本将计算,而不是图像的大小。

  • TBBS_NOPREFIX 按钮文本没有快捷键前缀与它。

iImage

按钮的图像新索引在位图中。

posted @ 2013-08-08 14:47  FREE小宝  阅读(1003)  评论(0编辑  收藏  举报