Элемент 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>

Атрибуты

attribute Тип Обязательно Описание
CommandName
 xs:positiveInteger или xs:string
 Нет
 Связывает элемент с командой.

(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 отображает в макете Большая группа, перед переключением на Средний.

(xs:integer)
MinColumnsMedium
 xs:integer
 Нет
 Указывает минимальное количество столбцов, которое inRibbonGallery отображается в макете средней группы, прежде чем переключаться на Small.

(xs:integer)
TextPosition
 TextPositionType
 Нет
 Указывает, где отображается метка элемента относительно изображения.
Ограничивается одним из следующих значений:

(Внизу)
(Скрыть)
(Слева)
(Перекрытие)
(Справа)
(Вверху)
Тип
 xs:string
 Нет
 Ограничивается одним из следующих значений:

(Элементы)
(Команды)

Дочерние элементы

Элемент Описание
Флажок
 Может произойти один или несколько раз
InRibbonGallery.MenuGroups
 Должно происходить ровно один раз
InRibbonGallery.MenuLayout
 Может возникать не более одного раза
Кнопка
 Может произойти один или несколько раз
SplitButton
 Может произойти один или несколько раз
ToggleButton
 Может произойти один или несколько раз

Родительские элементы

Элемент Описание
ControlGroup
Группа
QuickAccessToolbar.ApplicationDefaults
 Примечание.
Windows 8 и более поздней версии.



Комментарии

Необязательный элемент.

Может возникать не более одного раза для каждого элемента ControlGroup или Group .

На следующем снимке экрана показан элемент управления "Лента в коллекции ленты" в Microsoft Paint для Windows 7.

Снимок экрана: элемент управления коллекции на ленте Microsoft Paint.

Примеры

В следующем примере показана базовая разметка для коллекции на ленте.

В этом разделе кода показаны объявления команды 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
  • Может быть пустым: Нет

См. также раздел

Элемент управления "Коллекция на ленте"

Работа с коллекциями

Пример коллекции