拆分按钮库

拆分按钮库是一个复合控件，其中包含一个公开单个默认项或命令的主按钮，以及一个辅助按钮，单击该按钮时会在互斥下拉列表中显示该项或 Command 集合的其余部分。

详细信息

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

以下屏幕截图演示了 Microsoft 画图中的功能区拆分按钮库。

microsoft paint 功能区中 splitbuttongallery 控件的屏幕截图。

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

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

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

注意

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

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

属性键	注释
UI_PKEY_BooleanValue	支持 IUIFramework：：GetUICommandProperty 和 IUIFramework：：SetUICommandProperty。
UI_PKEY_Categories	支持 IUIFramework：：GetUICommandProperty 和 IUIFramework：：SetUICommandProperty。
UI_PKEY_Enabled	支持 IUIFramework：：GetUICommandProperty 和 IUIFramework：：SetUICommandProperty。
UI_PKEY_ItemsSource	支持 IUIFramework：：GetUICommandProperty 和 IUIFramework：：SetUICommandProperty。
UI_PKEY_Keytip	只能通过失效进行更新。
UI_PKEY_Label	只能通过失效进行更新。
UI_PKEY_LargeHighContrastImage	只能通过失效进行更新。
UI_PKEY_LargeImage	只能通过失效进行更新。
UI_PKEY_SelectedItem (仅对项库) 有效	支持 IUIFramework：：GetUICommandProperty 和 IUIFramework：：SetUICommandProperty。注意：如果通过调用 IUIFramework：：InvalidateUICommand 使与控件关联的命令失效，框架将在作为标志的值传递时`UI_INVALIDATIONS_VALUE`查询此属性。
UI_PKEY_SmallHighContrastImage	只能通过失效进行更新。
UI_PKEY_SmallImage	只能通过失效进行更新。
UI_PKEY_TooltipDescription	只能通过失效进行更新。
UI_PKEY_TooltipTitle	只能通过失效进行更新。