Elemento DropDownGallery

Articolo
08/14/2024

Rappresenta un controllo Raccolta a discesa con un menu basato sulla raccolta.

Utilizzo

<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>

Attributi

Attributo	Type	Obbligatoria	Descrizione
ApplicationModes	xs:string	No	Valido solo se MenuGroup è l'elemento padre. (xs:string) Stringa contenente un elenco delimitato da virgole di interi compresi tra 0 e 31. Lo spazio vuoto è valido e ignorato. Lunghezza massima: 250 caratteri.
CommandName	xs:positiveInteger o xs:string	No	Associa l'elemento a un oggetto Command. (xs:positiveInteger o xs:string) Stringa, un valore intero compreso tra 2 e 59999, inclusi o un valore esadecimale compreso tra 0x2 e 0xea5f, inclusi. Il valore deve essere univoco all'interno del documento XML della barra multifunzione. Lunghezza massima: 100 caratteri.
HasLargeItems	Boolean	No	Determina se la risorsa immagine grande o piccola del comando viene visualizzata nel controllo raccolta. Nota: Si applica solo alle raccolte in cui il valore dell'attributo Type è uguale a `Command`. Limitato a uno dei valori seguenti (0 e 1 non sono validi): (true) Valore predefinito. (false)
ItemHeight	xs:integer	No	(xs:integer) Il valore predefinito è -1.
ItemWidth	xs:integer	No	(xs:integer) Il valore predefinito è -1.
TextPosition	TextPositionType	No	Limitato a uno dei valori seguenti: (Inferiore) (Nascondi) (a sinistra) (Sovrapposizione) (a destra) (In alto)
Tipo	xs:string	No	Limitato a uno dei valori seguenti: (Elementi) (Comandi)

Elementi figlio

Elemento	Descrizione
Button	Può verificarsi una o più volte
CheckBox	Può verificarsi una o più volte
DropDownGallery.MenuGroups	Deve verificarsi esattamente una volta
DropDownGallery.MenuLayout	Può verificarsi al massimo una volta
SplitButton	Può verificarsi una o più volte
ToggleButton	Può verificarsi una o più volte

Elementi padre

Elemento	Descrizione
ControlGroup
Gruppo
Menugroup	Se contenuto in un oggetto ApplicationMenu. Questo elemento è supportato solo nel primo livello e non deve avere elementi figlio.
QuickAccessToolbar.ApplicationDefaults	Nota: Windows 8 e versioni successive.
SplitButton

Commenti

facoltativo.

Può verificarsi una o più volte per ogni elemento ControlGroup, DropDownButton, Group, MenuGroup o SplitButton .

DropDownGallery supporta le modalità applicazione.

La schermata seguente illustra il controllo Raccolta a discesa della barra multifunzione in Microsoft Paint per Windows 7.

screenshot di un controllo raccolta a discesa in Microsoft Paint per Windows 7.

Esempio

Nell'esempio seguente viene illustrato il markup di base per DropDownGallery.

Questa sezione di codice mostra le dichiarazioni dropDownGallery Command, con un gruppo associato che funge da contenitore padre per l'elemento DropDownGallery .

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

Questa sezione di codice mostra le dichiarazioni di controllo 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>

Informazioni sull'elemento

Sistema minimo supportato: Windows 7
Può essere vuoto: No

Vedi anche

Controllo Raccolta a discesa
Uso delle raccolte
SetModes
Esempio di raccolta

Condividi tramite