拆分按钮

“拆分按钮”是一个复合控件，用户可以使用该控件选择绑定到主按钮的默认值，或者从绑定到辅助按钮的下拉列表中显示的互斥值列表中选择。

简介

如果存在明显的默认值，并且单个项可由图像、文本或两者表示，则此控件可用于公开密切相关的项。

以下屏幕截图演示了功能区拆分按钮。

示例功能区中拆分按钮控件的屏幕截图。

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

通常，通过调用 IUIFramework：：InvalidateUICommand 方法使与控件关联的命令无效，从而在功能区 UI 中更新拆分按钮属性。无效事件由 IUICommandHandler：：UpdateProperty 回调方法处理，并更新定义的属性。

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

注意

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

下表列出了与“拆分按钮”控件关联的属性键。

属性键	注释
UI_PKEY_Enabled	支持 IUIFramework：：GetUICommandProperty 和 IUIFramework：：SetUICommandProperty。如果禁用所有子项，框架会将 UI_PKEY_Enabled 设置为 false (0) 。否则，如果启用了一个或多个子项，UI_PKEY_Enabled设置为 true (-1) 。重要提示：在启用或禁用一个或多个子项后，拆分按钮控件的 UI_PKEY_Enabled 属性应失效。这可确保框架查询更新的属性值并刷新功能区 UI 中拆分按钮控件的状态。
UI_PKEY_Keytip	只能通过失效进行更新。
UI_PKEY_TooltipDescription	只能通过失效进行更新。
UI_PKEY_TooltipTitle	只能通过失效进行更新。