按钮 (Windows功能区框架)

Button 是用户可以单击的控件,以便向应用程序提供输入。

简介

以下屏幕截图包含功能区按钮元素的三个示例。

screen shot of button controls in the microsoft wordpad ribbon.

按钮属性

功能区框架定义按钮控件 的属性键 集合。

通常,通过调用 IUIFramework::InvalidateUICommand 方法使与控件关联的命令失效,功能区 UI 中会更新 Button 属性。 处理无效事件,并使用 IUICommandHandler::UpdateProperty 回调方法定义的属性更新。

不会执行 IUICommandHandler::UpdateProperty 回调方法,并且应用程序会查询更新的属性值,直到框架需要该属性。 例如,当选项卡被激活且在功能区 UI 中显示控件或显示工具提示时。

注意

在某些情况下,可以通过 IUIFramework::GetUICommandProperty 方法检索属性,并使用 IUIFramework::SetUICommandProperty 方法进行设置。

 

下表列出了与 Button 控件关联的属性键。

属性键 说明
UI_PKEY_Enabled 支持 IUIFramework::GetUICommandPropertyIUIFramework::SetUICommandProperty
UI_PKEY_Keytip 只能通过无效更新。
UI_PKEY_Label 只能通过无效更新。
UI_PKEY_LabelDescription 只能通过无效更新。
UI_PKEY_LargeHighContrastImage 只能通过无效更新。
UI_PKEY_LargeImage 只能通过无效更新。
UI_PKEY_SmallHighContrastImage 只能通过无效更新。
UI_PKEY_SmallImage 只能通过无效更新。
UI_PKEY_TooltipDescription 只能通过无效更新。
UI_PKEY_TooltipTitle 只能通过无效更新。

 

Windows功能区框架控件库

按钮标记元素