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	Boolean	No	判斷命令的大型或小型影像資源是否顯示在資源庫控制項中。 注意： 僅適用于 類型 屬性的值等於 Command 的資源庫。 限制為下列其中一個值， (0 和 1 無效) ： (true) 預設值。 (false)
ItemHeight	xs:integer	否	與 ItemWidth一起決定資源庫控制項中顯示的專案影像大小。 注意： 僅適用于 類型 屬性的值等於 Item 的資源庫。 (xs：integer) 預設值為 -1。
ItemWidth	xs:integer	否	與 ItemHeight一起決定資源庫控制項中顯示的專案影像大小。 注意： 僅適用于 類型 屬性的值等於 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在切換至[中] 之前，在 [大型群組配置] 中顯示的資料行數目下限。 (xs：integer)
MinColumnsMedium	xs:integer	否	指定 InRibbonGallery 在切換至 Small 之前，在 [ 中 ] 群組配置中顯示的資料行數目 下限。 (xs：integer)
TextPosition	TextPositionType	否	指定相對於影像顯示專案標籤的位置。 限制為下列其中一個值： (底部) (隱藏) 左 () (重迭) (右) (Top)
類型	xs:string	否	限制為下列其中一個值： (專案) (命令)

子元素

元素	描述
CheckBox	可能發生一或多次
InRibbonGallery.MenuGroups	必須剛好發生一次
InRibbonGallery.MenuLayout	最多可能發生一次
按鈕	可能發生一或多次
SplitButton	可能發生一或多次
ToggleButton	可能發生一或多次

父元素

元素	描述
ControlGroup
組
QuickAccessToolbar.ApplicationDefaults	注意： Windows 8 和更新版本。

備註

選擇性。

每個 ControlGroup 或 Group 元素最多可能會發生一次。

下列螢幕擷取畫面說明 Windows 7 Microsoft 小畫家功能區內資源庫控制項。

範例

下列範例示範功能 區內資源庫的基本標記。

這一節的程式碼會顯示 InRibbonGallery 命令宣告，其中包含一個相關聯的 Group ，做為 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
• 可以是空的：否

另請參閱

功能區內資源庫控制項

使用資源庫

資源庫範例