Элемент SplitButtonGallery

Статья
09/03/2023

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

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

<SplitButtonGallery
  ApplicationModes = "xs:string"
  CommandName = "xs:positiveInteger or xs:string"
  HasLargeItems = "Boolean"
  ItemHeight = "xs:integer"
  ItemWidth = "xs:integer"
  TextPosition = "TextPositionType"
  Type = "xs:string">
  child elements
</SplitButtonGallery>

Атрибуты

attribute	Тип	Обязательно	Описание
ApplicationModes	xs:string	Нет	Допустимо только в том случае, если Элемент MenuGroup является родительским элементом. (xs:string) Строка, содержащая разделенный запятыми список целых чисел от 0 до 31. Пробел является допустимым и игнорируется. Максимальная длина: 250 символов.
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	Нет	(xs:integer) Значение по умолчанию — -1.
ItemWidth	xs:integer	Нет	(xs:integer) Значение по умолчанию — -1.
TextPosition	TextPositionType	Нет	Ограничивается одним из следующих значений: (Внизу) (Скрыть) (Слева) (Перекрытие) (Справа) (Вверху)
Тип	xs:string	Нет	Ограничивается одним из следующих значений: (Элементы) (Команды)

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

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

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

Элемент	Описание
ControlGroup
Группа
MenuGroup	Если содержится в элементе ApplicationMenu. Этот элемент поддерживается только на первом уровне и не должен иметь дочерних элементов.
QuickAccessToolbar.ApplicationDefaults	Примечание. Windows 8 и более поздней версии.
SplitButton

Примеры

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

В этом разделе кода показаны объявления команд SplitButtonGallery со связанной группой , которая функционирует как родительский контейнер для элемента SplitButtonGallery .

<!-- SplitButtonGallery -->
<Command Name="cmdSplitButtonGalleryGroup"
         Symbol="cmdSplitButtonGalleryGroup"
         Comment="SplitButtonGallery Group"
         LabelTitle="SplitButtonGallery"/>
<Command Name="cmdSplitButtonGallery"
         Symbol="cmdSplitButtonGallery"
         Comment="SplitButtonGallery"
         LabelTitle="SplitButtonGallery"/>

В этом разделе кода показаны объявления элемента управления SplitButtonGallery .

<!-- SplitButtonGallery -->
<Group CommandName="cmdSplitButtonGalleryGroup">
  <SplitButtonGallery CommandName="cmdSplitButtonGallery">
    <SplitButtonGallery.MenuLayout>
      <FlowMenuLayout Rows="2"
                      Columns="3"
                      Gripper="None"/>
    </SplitButtonGallery.MenuLayout>
    <SplitButtonGallery.MenuGroups>
      <MenuGroup>
        <Button CommandName="cmdButton1"></Button>
        <Button CommandName="cmdButton2"></Button>
      </MenuGroup>
      <MenuGroup>
        <Button CommandName="cmdButton3"></Button>
      </MenuGroup>
    </SplitButtonGallery.MenuGroups>
  </SplitButtonGallery>
</Group>

Сведения об элементе

Минимальная поддерживаемая система: Windows 7
Может быть пустым: Нет

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

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