Elemento ControlGroup

Articolo
06/13/2023

Rappresenta un gruppo di controlli in un modello di layout SizeDefinition .

Utilizzo

<ControlGroup
  SequenceNumber = "xs:positiveInteger">
  child elements
</ControlGroup>

Attributi

Attributo	Type	Obbligatoria	Descrizione
SequenceNumber	xs:positiveInteger	No	Valido solo quando Group è l'elemento padre. Ogni SequenceNumber deve essere univoco all'interno di un elemento Group . I valori di SequenceNumber devono aumentare per ogni elemento Group , ma non devono essere sequenziali. (xs:positiveInteger) Qualsiasi valore intero positivo compreso tra 1000 e 59999 inclusi.

Elementi figlio

Elemento	Descrizione
Button	Può verificarsi una o più volte
CheckBox	Può verificarsi una o più volte
ComboBox	Può verificarsi una o più volte
ControlSizeDefinition	Può verificarsi una o più volte
DropDownButton	Può verificarsi una o più volte
DropDownColorPicker	Può verificarsi una o più volte
DropDownGallery	Può verificarsi una o più volte
FontControl	Può verificarsi al massimo una volta
InRibbonGallery	Può verificarsi una o più volte
Spinner	Può verificarsi una o più volte
SplitButton	Può verificarsi una o più volte
SplitButtonGallery	Può verificarsi una o più volte
ToggleButton	Può verificarsi una o più volte

Elementi padre

Elemento
ControlGroup
Gruppo
GroupSizeDefinition
Riga

Commenti

Facoltativa.

Può verificarsi una o più volte per ogni elemento Group o ControlGroup .

Se non vengono forniti numeri di sequenza, viene eseguito il rendering degli elementi nell'ordine specificato nel markup della barra multifunzione.

Se Group o ControlGroup è l'elemento padre, ControlGroup è vincolato agli elementi figlio seguenti: Button, CheckBox, ComboBox, DropDownButton, DropDownColorPicker, DropDownGallery, FontControl, InRibbonGallery, Spinner, SplitButton, SplitButtonGallery o ToggleButton

In caso contrario, quando Row o GroupSizeDefinition è padre, Group è vincolato all'elemento figlio seguente: ControlSizeDefinition.

Esempio

Nell'esempio di codice seguente viene illustrato il markup di base per un modello di layout SizeDefinition personalizzato con quattro pulsanti con vari elementi Group .

<Group CommandName="cmdButtonGroup2">
  <SizeDefinition>
    <ControlNameMap>
      <ControlNameDefinition Name="button1"/>
      <ControlNameDefinition Name="button2"/>
      <ControlNameDefinition Name="button3"/>
      <ControlNameDefinition Name="button4"/>
    </ControlNameMap>
    <GroupSizeDefinition Size="Large">
      <ControlGroup>
        <ControlSizeDefinition ControlName="button1"
                               ImageSize="Large"
                               IsLabelVisible="true" />
        <ControlSizeDefinition ControlName="button2"
                               ImageSize="Large"
                               IsLabelVisible="true" />
      </ControlGroup>
      <ColumnBreak ShowSeparator="true"/>
      <ControlGroup>
        <ControlSizeDefinition ControlName="button3"
                               ImageSize="Large"
                              IsLabelVisible="true" />
        <ControlSizeDefinition ControlName="button4"
                              ImageSize="Large"
                              IsLabelVisible="true" />
      </ControlGroup>
    </GroupSizeDefinition>
    <GroupSizeDefinition Size="Medium">
      <Row>
        <ControlSizeDefinition ControlName="button1"
                               ImageSize="Small"
                               IsLabelVisible="true" />
        <ControlSizeDefinition ControlName="button3"
                               ImageSize="Small"
                               IsLabelVisible="true" />
      </Row>
      <Row>
        <ControlSizeDefinition ControlName="button2"
                               ImageSize="Small"
                               IsLabelVisible="true" />
        <ControlSizeDefinition ControlName="button4"
                               ImageSize="Small"
                               IsLabelVisible="true" />
      </Row>
    </GroupSizeDefinition>
    <GroupSizeDefinition Size="Small">
      <Row>
        <ControlSizeDefinition ControlName="button1"
                               ImageSize="Small"
                               IsLabelVisible="true" />
        <ControlSizeDefinition ControlName="button3"
                               ImageSize="Small"
                               IsLabelVisible="false" />
      </Row>
      <Row>
        <ControlSizeDefinition ControlName="button2"
                               ImageSize="Small"
                               IsLabelVisible="true" />
        <ControlSizeDefinition ControlName="button4"
                               ImageSize="Small"
                               IsLabelVisible="false" />
      </Row>
    </GroupSizeDefinition>
  </SizeDefinition>
  <Button CommandName="cmdButtonG21"></Button>
  <Button CommandName="cmdButtonG22"></Button>
  <Button CommandName="cmdButtonG23"></Button>
  <Button CommandName="cmdButtonG24"></Button>
</Group>
<Group CommandName="cmdCheckBoxGroup">
  <CheckBox CommandName="cmdCheckBox"></CheckBox>
</Group>
<Group CommandName="cmdToggleButtonGroup"
       SizeDefinition="OneButton">
  <ToggleButton CommandName="cmdToggleButton"></ToggleButton>
</Group>
<Group CommandName="cmdButtonGroup"
       SizeDefinition="ThreeButtons">
  <Button CommandName="cmdButton1"></Button>
  <Button CommandName="cmdButton2"></Button>
  <Button CommandName="cmdButton3"></Button>
</Group>

Informazioni sull'elemento

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

Vedi anche

Personalizzazione di una barra multifunzione tramite definizioni di dimensioni e criteri di ridimensionamento

Condividi tramite