CButtonSSL

Derek Lakin

4.20/5 (8投票s)

2001年8月30日

CPOL

32分钟阅读

320721

6945

一个所有者绘制的、扁平的、菜单按钮，能正确处理默认状态

Bug修复 (2001年12月5日)

CButtonSSL 现已广泛用于实际产品中，因此在测试方面经历了许多考验。幸运的是，这给了我时间来发现并修复这些问题。

最新版本包括对 GDI 资源泄露的修复（我必须感谢 Dieter Hammer 的发现），以及对按钮状态绘制问题的修复（我必须感谢 Eugene Pustovyt 指出了其中一些更隐蔽的问题），还修复了发布版本中的一个主要 Bug。

问题在于，在包含使用 SetCheck 更改了状态的 CButtonSSL 复选框的发布版本中，应用程序会崩溃。经过大量（大部分是徒劳的）调试，最终在 Alvaro Mendez 的帮助下，我找到了一种持续重现问题的方法。一旦到了这一步，我就开始绝望了，但幸运的是 Joe Newcomer 及时出现，指出了我的错误。OnSetCheck 处理程序没有为 ON_COMMAND 处理程序定义两个必需的参数。所以，栈上推了两个参数，只弹出了一个！

我想感谢所有在这轮 Bug 修复中帮助过我的人，希望（不会有）很多（或者任何）新的 Bug 了。

更新 (2001年9月18日)

似乎无论你多么努力，一天之内也无法完成足够多的事情！试图兼顾工作、娱乐和家庭并不容易！然而，我终于有时间来更新这篇文章了。那么，有什么新内容呢？

CButtonSSL 现在继承自 COddButton，尽管我对它做了一些小的改动（见下文）。
单选按钮问题已修复（请查看演示）。
实现了对按钮绘制的几个修复。
菜单的接口大部分已公开，因此我们有了全新的菜单函数。

由于新增了大量内容，我还没有机会进行广泛的测试，尤其是关于菜单函数。如果存在任何问题，请告知我（最好附带修复方法）。

继承自 COddButton

继承自 COddButton 的改动改变了标准按钮样式的处理方式。COddButton::PreSubclassWindow 的使用意味着控件类型是从对话框编辑器中设置的初始样式确定的。所以现在 **你不能设置 Owner Draw 样式**，否则它将无法正常工作。

默认样式的处理现在也完全由 COddButton 提供，尽管如上所述，我已经做了一些小的改动来同时处理单选按钮。

第一个改动是对构造函数的，使 m_bCanBeDefault 初始值为 TRUE。第二个改动是 WM_GETDLGCODE 处理程序，COddButton::OnGetDlgCode()。该函数现在处理单选按钮的代码如下：

UINT COddButton::OnGetDlgCode() 
{
	UINT nCode = CButton::OnGetDlgCode();

	// tell the system if we want default state handling
	// (losing default state always allowed)
    UINT nType = GetControlType ();
	if (BS_RADIOBUTTON == (BS_RADIOBUTTON & nType) ||
		BS_AUTORADIOBUTTON == (BS_AUTORADIOBUTTON & nType)) {
		nCode |= DLGC_RADIOBUTTON;
	}
	else {
	    if (m_bCanBeDefault || m_bDefault)
		    nCode |= (m_bDefault ? DLGC_DEFPUSHBUTTON : DLGC_UNDEFPUSHBUTTON);
    }

	return nCode;
}

引言

目前按钮似乎是时下的热门，这里又有一个。这个按钮类诞生于需要一个带有菜单下拉的位图按钮，但一如既往地，它演变成了远不止于此！

我找到了 Norm Almond 的“酷炫推送菜单按钮”和 Davide Calabro 的 CButtonST，并想将两者结合起来。在此过程中，我遇到了 BS_OWNERDRAW 问题，并试图找到自己的解决方案。幸运的是，Paolo Messina 和 Jerzy Kaczorowski 用他们的 COddButton 为我解决了这个问题。

我提出的这个类主要借鉴了这些来源，还有一些其他来源，我的感谢必须送给所有在 Visual C++ 论坛上帮助过我的人。我花了很多时间来完成这个，而且我对文档的编写有些过于随意，所以如果你认领了某些代码并希望得到认可，请告诉我，我会更新它。

类的完整文档如下。我希望这足够了，因为我花了很多时间来写它；)

`SetSSLButtonStyle`	更改按钮的样式。
`GetSSLButtonStyle`	检索有关按钮控件样式的信息。

`SetSSLButtonBitmap`	指定单个位图作为所有按钮状态的图像。
`SetSSLButtonBitmaps`	为不同的按钮状态指定不同的位图。
`SetSSLButtonIcon`	指定单个图标作为所有按钮状态的图像。
`SetSSLButtonIcons`	为不同的按钮状态指定不同的图标。
`SetSSLImageAlign`	设置按钮图像的对齐方式。
`GetSSLImageAlign`	检索按钮图像的图像对齐方式。

`SetSSLTextAlign`	设置按钮文本的对齐方式。
`GetSSLTextAlign`	检索按钮文本的对齐方式。
`SetSSLButtonFont`	为按钮文本指定字体特征。

`SetSSLDefaultColors`	将按钮和文本颜色设置为系统定义的默认颜色。
`SetSSLColor`	为特定按钮状态指定用于按钮面或文本的颜色。
`GetSSLColor`	检索使用 SetSSLColor 之前为特定按钮状态设置的按钮面或文本颜色。

`SetSSLCheck`	设置复选框样式按钮的选中状态。
`GetSSLCheck`	检索单选按钮或复选框的选中状态。

`SetSSLButtonMenu`	指定菜单资源以供菜单按钮使用。
`CheckSSLMenuItem`	在弹出菜单中为菜单项添加或移除复选标记。
`CheckSSLMenuRadioItem`	在菜单项旁边放置一个单选按钮，并从该组中的所有其他菜单项中移除单选按钮。
`EnableSSLMenuItem`	启用、禁用或变灰（置灰）菜单项。
`GetSSLMenuItemCount`	确定弹出菜单或顶级菜单中的项目数。
`GetSSLMenuItemID`	获取位于指定位置的菜单项的菜单项标识符。
`GetSSLMenuState`	返回指定菜单项的状态或弹出菜单中的项目数。
`GetSSLMenuString`	检索指定菜单项的标签。
`GetSSLMenuItemInfo`	检索有关菜单项的信息。
`ModifySSLMenu`	修改指定位置的现有菜单项。
`RemoveSSLMenu`	从指定菜单中删除带有关联弹出菜单的菜单项。
`SetSSLMenuItemBitmaps`	将指定的复选标记位图与菜单项关联。

`SetSSLButtonCursor`	指定鼠标悬停在按钮上时显示的鼠标光标。
`SetSSLButtonToolTip`	指定鼠标悬停在按钮上时显示的工具提示。
`SetSSLButtonURL`	指定点击按钮时要启动的 URL。

CButtonSSL

Bug修复 (2001年12月5日)

更新 (2001年9月18日)

继承自 COddButton

引言

初始化

备注

参数

备注

返回值

备注

返回值

参数

备注

CButtonSSL::SetSSLButtonBitmaps

返回值

参数

备注

返回值

参数

备注

返回值

参数

备注

参数

备注

返回值

备注

参数

备注

返回值

备注

返回值

参数

备注

参数

备注

返回值

参数

备注

返回值

参数

备注

参数

备注

返回值

备注

返回值

参数

备注

返回值

参数

备注

备注

返回值

参数

备注

返回值

备注

返回值

参数

备注

返回值

参数

备注

CButtonSSL::GetSSLMenuString

返回值

参数

备注

CButtonSSL::GetSSLMenuItemInfo

返回值

参数

备注

CButtonSSL::ModifySSLMenu

返回值

参数

备注

CButtonSSL::RemoveSSLMenu

返回值

参数