Elemento SplitButtonGallery

Articolo
08/14/2024

Rappresenta un controllo Split Button Gallery con un menu a discesa basato sulla raccolta.

Utilizzo

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

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
SplitButton	Può verificarsi una o più volte
SplitButtonGallery.MenuGroups	Deve verificarsi esattamente una volta
SplitButtonGallery.MenuLayout	Può verificarsi al massimo una volta
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, Group, MenuGroup o SplitButton .

SplitButtonGallery supporta le modalità applicazione.

UI_PKEY_BooleanValue viene usato da un'applicazione per eseguire una query sullo stato di attivazione/disattivazione per il controllo pulsante di un controllo SplitButtonGallery.

La schermata seguente illustra il controllo Raccolta pulsanti di divisione della barra multifunzione in Microsoft Paint per Windows 7.

screenshot di un controllo raccolta di pulsanti di divisione in Microsoft paint per Windows 7.

Esempio

L'esempio seguente illustra il markup di base per la raccolta di pulsanti di divisione.

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

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

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

Informazioni sull'elemento

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

Vedi anche

Controllo Raccolta pulsanti di divisione
Uso delle raccolte
SetModes
Esempio di raccolta

Condividi tramite