InRibbonGallery 元素

表示 功能区内库,它是一个基于库的控件,该控件直接在功能区中公开默认的项子集。 单击下拉菜单按钮时,将显示所有剩余项。

用法

<InRibbonGallery
  CommandName = "xs:positiveInteger or xs:string"
  HasLargeItems = "Boolean"
  ItemHeight = "xs:integer"
  ItemWidth = "xs:integer"
  MinColumnsLarge = "xs:integer"
  MaxColumnsMedium = "xs:integer"
  MinColumnsMedium = "xs:integer"
  MaxColumns = "xs:integer"
  MaxRows = "xs:integer"
  TextPosition = "TextPositionType"
  Type = "xs:string">
  child elements
</InRibbonGallery>

属性

属性 类型 必需 说明
CommandName
xs:positiveInteger 或 xs:string

将元素与 Command 相关联。

(xs:positiveInteger 或 xs:string)
字符串、介于 2 和 59999 之间的整数值(含)或0x2与 0xea5f 之间的十六进制值(含)。
该值在功能区 XML 文档中必须是唯一的。
最大长度:100 个字符。
HasLargeItems
布尔

确定命令的大或小图像资源是否显示在库控件中。
[!注意]
仅适用于 Type 特性的值等于 Command的库。

限制为以下值之一, (0 和 1 无效) :

(true)
默认。
(false)
ItemHeight
xs:integer

ItemWidth 一起,确定库控件中显示的项图像的大小。
[!注意]
仅适用于 Type 特性的值等于 Item的库。


(xs:integer)
默认值为 -1。
ItemWidth
xs:integer

ItemHeight 一起,确定库控件中显示的项图像的大小。
[!注意]
仅适用于 Type 特性的值等于 Item的库。


(xs:integer)
默认值为 -1。
MaxColumns
xs:integer

指定 InRibbonGallery 显示的最大列数,例如,在 “大型 组布局”下拉列表中。

(xs:integer)
MaxColumnsMedium
xs:integer

指定 InRibbonGallery 在“ 中等 ”组布局中显示的最大列数,然后切换到 “大型 ”布局。

(xs:integer)
MaxRows
xs:integer

指定 InRibbonGallery 项布局的最大行数。

(xs:integer)
默认值为 1。
MinColumnsLarge
xs:integer

指定 InRibbonGallery 在切换到 Medium 之前在大型组布局中显示的最小列数。

(xs:integer)
MinColumnsMedium
xs:integer

在切换到 Small 之前,指定 InRibbonGallery中等组布局中显示的最小列数。

(xs:integer)
TextPosition
TextPositionType

指定显示项标签的位置,相对于图像。
限制为以下值之一:

(底部)
(隐藏)
左 ()
(重叠)
(右)
(Top)
类型
xs:string

限制为以下值之一:

(项)
(命令)

子元素

元素 说明
CheckBox
可能发生一次或多次

InRibbonGallery.MenuGroups
必须恰好发生一次

InRibbonGallery.MenuLayout
最多可能发生一次

Button
可能发生一次或多次

SplitButton
可能发生一次或多次

ToggleButton
可能发生一次或多次

父元素

元素 说明
ControlGroup

QuickAccessToolbar.ApplicationDefaults
[!注意]
Windows 8和更新。


注解

可选。

对于每个 ControlGroupGroup 元素,最多可能发生一次。

以下屏幕截图演示了 Windows 7 Microsoft 画图 中的功能区内库控件。

screen shot of an in-ribbon gallery control in the microsoft paint ribbon.

示例

以下示例演示 功能区内库的基本标记。

此代码部分显示 InRibbonGallery 命令声明,其中包含一个关联组,该 充当 InRibbonGallery 元素的父容器。

<!-- InRibbonGallery -->
<Command Name="cmdInRibbonGalleryGroup"
         Symbol="cmdInRibbonGalleryGroup"
         Comment="InRibbonGallery Group"
         LabelTitle="InRibbonGallery"/>
<Command Name="cmdInRibbonGallery"
         Symbol="cmdInRibbonGallery"
         Comment="InRibbonGallery"
         LabelTitle="InRibbonGallery"/>

此代码部分显示了 InRibbonGallery 控件声明。

<!-- InRibbonGallery -->
<Group CommandName="cmdInRibbonGalleryGroup" SizeDefinition="OneInRibbonGallery">
  <InRibbonGallery CommandName="cmdInRibbonGallery"
                   MaxColumns="10"
                   MaxColumnsMedium="5"
                   MinColumnsLarge="5"
                   MinColumnsMedium="3"
                   Type="Items">
    <InRibbonGallery.MenuLayout>
      <VerticalMenuLayout Rows="2"
                          Gripper="Vertical"/>
    </InRibbonGallery.MenuLayout>
    <InRibbonGallery.MenuGroups>
      <MenuGroup>
        <Button CommandName="cmdButton1"></Button>
        <Button CommandName="cmdButton2"></Button>
      </MenuGroup>
      <MenuGroup>
        <Button CommandName="cmdButton3"></Button>
      </MenuGroup>
    </InRibbonGallery.MenuGroups>            
  </InRibbonGallery>
</Group>

元素信息

  • 支持的最低系统:Windows 7
  • 可以为空:否

另请参阅

功能区内库控件

使用库

库示例