CMFCToolBarButton选件类
提供按钮功能。工具栏。
class CMFCToolBarButton : public CObject
成员
.gif "Bb983678.collapse_all(zh-cn,VS.110).gif")
公共构造函数
名称 |
说明 |
|---|---|
构造和初始化 CMFCToolBarButton 对象。 |
|
CMFCToolBarButton::~CMFCToolBarButton |
析构函数。 |
公共方法
名称 |
说明 |
|---|---|
指定用户是否在工具栏可以确定按钮或菜单在自定义项时。 |
|
指定是否可以存储按钮。 |
|
指定用户是否在自定义过程中拉伸按钮。 |
|
此实例与提供的 CMFCToolBarButton 对象进行比较。 |
|
复制另一个工具栏按钮的属性设置为当前按钮。 |
|
创建从提供的 COleDataObject 对象的一 CMFCToolBarButton 对象。 |
|
CMFCToolBarButton::CreateObject |
用于由框架创建此选件类类型动态实例。 |
启用或禁用鼠标和键盘输入。 |
|
复制从工具栏按钮文本添加到菜单。 |
|
检索应用程序的全局剪贴板格式。 |
|
检索与工具栏按钮的窗口句柄。 |
|
检索按钮的图像索引。 |
|
检索按钮的工作区的区域必须重绘。 |
|
检索按钮的父窗口。 |
|
检索用户无法自定义命令的列表。 |
|
检索按钮的文本范围。 |
|
确定按钮是否具有当前输入焦点。 |
|
确定按钮的边框是否显示，当用户选择按钮。 |
|
确定映像是否在按钮显示。 |
|
确定文本标签是否在按钮显示。 |
|
确定按钮是否显示子菜单。 |
|
确定按钮是否可以自定义。 |
|
确定按钮是否可以显示了一个扩展的边框。 |
|
确定按钮是否在第一个位置在其按钮组中。 |
|
确定按钮是否为隐藏的。 |
|
确定按钮是否位于一水平toolbar。 |
|
指定按钮是否在最后位置在其按钮组中。 |
|
确定按钮是否处于锁定(非自定义项)的工具栏。 |
|
确定按钮是否提供的窗口句柄的所有者。 |
|
确定工具栏按钮是否可见。 |
|
确定按钮的基础窗口句柄是否可见。 |
|
指定按钮是否处理 WM_COMMAND 消息。 |
|
调用由结构，当按钮添加到 自定义 对话框。 |
|
指定按钮是否可以拖动。 |
|
指定用户是否可以将在目标工具栏上的按钮。 |
|
调用由结构计算该按钮的大小指定的设备上下文和停靠状态的。 |
|
调用由框架处理 WM_CANCELMODE 消息。 |
|
调用由结构，当按钮插入新工具栏。 |
|
调用由结构，当用户单击鼠标按钮。 |
|
调用由结构，当用户松开鼠标按钮。 |
|
调用由结构，当父工具栏处理 WM_HELPHITTEST 消息。 |
|
调用由结构，当父工具栏处理 WM_CTLCOLOR 消息。 |
|
当应用程序显示在父工具栏，都有一个快捷菜单使按钮修改表所提供的菜单。 |
|
调用由结构，当父工具栏处理 WM_LBUTTONDBLCLK 消息。 |
|
使用指定的样式和选项，调用由框架绘制按钮。 |
|
调用由框架绘制在 自定义 对话框的 命令 窗格的按钮。 |
|
调用由框架检索按钮的自定义工具提示文本。 |
|
调用由框架，如果全局字体已更改。 |
|
调用由结构，当父工具栏移动。 |
|
调用由结构，当按钮变为可见或不可见。 |
|
调用由框架，在父工具栏更改时其大小或位置和这种更改需要按钮更改范围。 |
|
调用由结构，当父工具栏必须确定一个点是否位于按钮的边框。 |
|
调用由结构，当父工具栏更新其工具提示文本。 |
|
调用由结构，当按钮将执行拖放操作。 |
|
检索按钮的边框。 |
|
将设置为默认值与按钮的图像。 |
|
保存工具栏按钮的状态。 |
|
读取存档或写入的此对象到存档。 （重写 CObject::Serialize。） |
|
填充可访问性数据的提供的 CAccessibilityData 对象从工具栏按钮。 |
|
对全局剪贴板格式重命名。 |
|
将按钮的图像索引。 |
|
设置用户无法自定义命令的列表。 |
|
调用由结构，当按钮将其选中状态。 |
|
设置按钮的边框。 |
|
设置按钮的样式。 |
|
指定按钮是否可见。 |
|
显示或隐藏按钮。 |
数据成员
名称 |
说明 |
|---|---|
指定映像是否在按钮显示。 |
|
指定文本标签是否在按钮显示。 |
|
指定文本标签是否在按钮的图像下显示。 |
|
指定按钮是否具有用户定义的图像。 |
|
指定按钮是否显示其全文标签，即使它不适合边框。 |
|
指定在分隔符旁边的按钮是否在下一行带来。 |
|
指定多行文本标签是否启用。 |
|
按钮的命令ID。 |
|
按钮的样式。 |
|
按钮的文本标签。 |
备注
CMFCToolbarButton 对象是位于工具栏上的控件。 其行为类似于普通的按钮。 可以将图像和文本标签。此对象。 工具栏按钮也有命令ID. 当用户单击工具栏按钮时，框架执行此ID指定的命令。
通常，工具栏按钮可以自定义:用户可以从一个工具栏上的按钮到另一个副本，粘贴，删除，并编辑文本标签和图像。 若要防止用户自定义工具栏，可以通过两种方式之一可以锁定工具栏。 用于设置 bLocked 标志传递给 TRUE，当您调用 CMFCToolBar::LoadToolBar时，使用 CMFCToolBarButton::SetProtectedCommands 方法，或添加单个按钮的命令ID到全局列表保护的命令。
CMFCToolBarButton 对象从工具栏图像的全局集合中的图像在应用程序中。 这些集合由父工具栏，CMFCToolBar选件类维护。 有关更多信息，请参见 CMFCToolBarImages选件类。
当用户单击工具栏按钮时，其父工具栏处理鼠标消息和传达相应的操作到按钮。 如果按钮具有有效的命令ID，父工具栏 WM_COMMAND 信息发送到父帧。
CMFCToolBarButton 选件类是其他工具栏按钮选件类的基类，例如 CMFCToolBarMenuButton选件类、 CMFCToolBarEditBoxButton选件类和 CMFCToolBarComboBoxButton选件类。
示例
通过在 CMFCToolBarButton 选件类，中的各种方法下面的示例演示如何配置 CMFCToolBarButton 对象。 示例阐释如何启用鼠标和键盘输入，将该按钮的图像索引，则将按钮的边框，并使按钮可见。 此代码段是 选项卡控件示例的一部分。
CMFCToolBarButton* pOffice2007 = NULL;
int nIndex = -1;
for (UINT uiCmd = ID_VIEW_APPLOOK_2007_1; uiCmd <= ID_VIEW_APPLOOK_2007_4; uiCmd++)
{
// CMFCToolBar m_wndToolBarTheme
nIndex = m_wndToolBarTheme.CommandToIndex (uiCmd);
CMFCToolBarButton* pButton = m_wndToolBarTheme.GetButton (nIndex);
if (pButton != NULL)
{
pOffice2007 = pButton;
break;
}
}
...
pOffice2007->EnableWindow();
pOffice2007->SetImage(1);
pOffice2007->SetRect( CRect(1,1,1,1));
pOffice2007->SetVisible();
pOffice2007->Show(true);
继承层次结构
要求
标头: afxtoolbarbutton.h
请参见
参考
CMFCToolBarButton::NotifyCommand