Элемент SplitButtonGallery
Представляет элемент управления "Коллекция разделенных кнопок " с раскрывающимся меню на основе коллекции.
Использование
<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 является родительским элементом. Пробел является допустимым и игнорируется. Максимальная длина: 250 символов. |
| CommandName |
xs:positiveInteger или xs:string |
Нет |
Связывает элемент с командой. Значение должно быть уникальным в XML-документе ленты. Максимальная длина: 100 символов. |
| HasLargeItems |
Логическое значение |
Нет |
Определяет, отображается ли ресурс большого или небольшого изображения команды в элементе управления коллекции. [! Примечание] Ограничено одним из следующих значений (0 и 1 недопустимы): |
| ItemHeight |
xs:integer |
Нет |
|
| ItemWidth |
xs:integer |
Нет |
|
| TextPosition |
TextPositionType |
Нет |
Ограничено одним из следующих значений: |
| Тип |
xs:string |
Нет |
Ограничено одним из следующих значений: |
Дочерние элементы
| Элемент | Описание |
|---|---|
| Button |
Может произойти один или несколько раз |
| CheckBox |
Может произойти один или несколько раз |
| SplitButton |
Может произойти один или несколько раз |
| SplitButtonGallery.MenuGroups |
Должно происходить ровно один раз |
| SplitButtonGallery.MenuLayout |
Может происходить не более одного раза |
| ToggleButton |
Может произойти один или несколько раз |
Родительские элементы
| Элемент | Описание |
|---|---|
| ControlGroup |
|
| Группа |
|
| MenuGroup |
Если он содержится в ApplicationMenu. Этот элемент поддерживается только на первом уровне и не должен иметь дочерних элементов. |
| QuickAccessToolbar.ApplicationDefaults |
[! Примечание] |
| SplitButton |
Remarks
Необязательный параметр.
Может выполняться один или несколько раз для каждого элемента ControlGroup, Group, MenuGroup или SplitButton .
SplitButtonGallery поддерживает режимы приложений.
UI_PKEY_BooleanValue используется приложением для запроса переключателя для элемента управления button объекта SplitButtonGallery.
На следующем снимке экрана показан элемент управления "Разделенная кнопка" ленты в Microsoft Paint для Windows 7.
Примеры
В следующем примере показана базовая разметка для коллекции разделенных кнопок.
В этом разделе кода показаны объявления команд 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
- Может быть пустым: Нет