Элемент InRibbonGallery

Статья
08/14/2024

Представляет коллекцию на ленте, элемент управления на основе коллекции, который предоставляет подмножество элементов по умолчанию непосредственно на ленте. Все остальные элементы отображаются при нажатии кнопки раскрывающегося меню.

Использование

<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 и более поздней версии.

Примеры

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

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

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

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

Поделиться через