ControlGroup 元素

代表 SizeDefinition 版面 配置範本中的控制項群組。

使用方式

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

屬性

屬性 類型 必要 描述
SequenceNumber
xs:positiveInteger

只有在 Group 是父元素時才有效。
每個 SequenceNumberGroup 元素內必須是唯一的。 SequenceNumber的值應該會針對每個Group元素增加,但不需要循序。

(xs:positiveInteger)
介於 1000 到 59999 之間的任何正整數值,包含。

子元素

元素 描述
Button
可能會發生一或多次

CheckBox
可能會發生一或多次

ComboBox
可能會發生一或多次

ControlSizeDefinition
可能會發生一或多次

DropDownButton
可能會發生一或多次

DropDownColorPicker
可能會發生一或多次

DropDownGallery
可能會發生一或多次

FontControl
最多可能發生一次

InRibbonGallery
可能會發生一或多次

Spinner
可能會發生一或多次

SplitButton
可能會發生一或多次

SplitButtonGallery
可能會發生一或多次

ToggleButton
可能會發生一或多次

父元素

元素
ControlGroup
群組
GroupSizeDefinition
資料列

備註

選擇性。

每個 GroupControlGroup 元素可能會發生一或多次。

如果未提供序號,專案會依功能區標記中指定的順序呈現。

如果GroupControlGroup是父元素,則 ControlGroup會限制為下列可能的子項目:ButtonCheckBoxComboBoxDropDownButtonDropDownColorPickerDropDownGalleryFontControlInRibbonGallerySpinnerSplitButtonGalleryToggleButton

否則,當 RowGroupSizeDefinition 是父代時, Group 會限制為下列可能的子項目: ControlSizeDefinition

範例

下列程式碼範例示範具有各種Group元素之自訂四按鈕SizeDefinition 版面配置範本的基本標記。

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

項目資訊

  • 最低支援的系統:Windows 7
  • 可以是空的:否

另請參閱

透過大小定義和調整原則自訂功能區