Элемент DropDownGallery

Статья
09/03/2023

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

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

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

Атрибуты

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	Может произойти один или несколько раз
Флажок	Может произойти один или несколько раз
DropDownGallery.MenuGroups	Должно происходить ровно один раз
DropDownGallery.MenuLayout	Может возникать не более одного раза
SplitButton	Может произойти один или несколько раз
ToggleButton	Может произойти один или несколько раз

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

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

Примеры

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

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

<!-- DropDownGallery -->
<Command Name="cmdDropDownGalleryGroup"
         Symbol="cmdDropDownGalleryGroup"
         Comment="DropDownGallery Group"
         LabelTitle="DropDownGallery"/>
<Command Name="cmdDropDownGallery"
         Symbol="cmdDropDownGallery"
         Comment="DropDownGallery"
         LabelTitle="DropDownGallery"/>

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

<!-- DropDownGallery -->
<Group CommandName="cmdDropDownGalleryGroup">
  <DropDownGallery CommandName="cmdDropDownGallery"
                   TextPosition="Hide"
                   Type="Commands"
                   ItemHeight="32"
                   ItemWidth="32">
    <DropDownGallery.MenuLayout>
      <FlowMenuLayout Rows="2"
                      Columns="3"
                      Gripper="None"/>
    </DropDownGallery.MenuLayout>
    <DropDownGallery.MenuGroups>
      <MenuGroup>
        <Button CommandName="cmdButton1"></Button>
        <Button CommandName="cmdButton2"></Button>
       </MenuGroup>
       <MenuGroup>
        <Button CommandName="cmdButton3"></Button>
      </MenuGroup>
    </DropDownGallery.MenuGroups>
  </DropDownGallery>
</Group>

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

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

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

Элемент управления раскрывающейся коллекции
Работа с коллекциями
SetModes
Пример коллекции