ControlGroup 元素

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

使用方式

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

屬性

屬性	類型	必要	Description
SequenceNumber	xs:positiveInteger	No	只有在 Group 是父元素時才有效。 每個 SequenceNumber 在 Group 元素內必須是唯一的。 SequenceNumber的值應該會針對每個Group元素增加，但不需要循序。 (xs：positiveInteger) 介於 1000 到 59999 之間的任何正整數值，包含。

子元素

元素	Description
Button	可能會發生一或多次
CheckBox	可能會發生一或多次
ComboBox	可能會發生一或多次
ControlSizeDefinition	可能會發生一或多次
DropDownButton	可能會發生一或多次
DropDownColorPicker	可能會發生一或多次
DropDownGallery	可能會發生一或多次
FontControl	最多可能發生一次
InRibbonGallery	可能會發生一或多次
Spinner	可能會發生一或多次
SplitButton	可能會發生一或多次
SplitButtonGallery	可能會發生一或多次
ToggleButton	可能會發生一或多次

父元素

元素
ControlGroup
群組
GroupSizeDefinition
行

備註

選擇性。

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

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

如果Group或ControlGroup是父元素，則 ControlGroup會限制為下列可能的子項目：Button、CheckBox、ComboBox、DropDownButton、DropDownColorPicker、DropDownGallery、FontControl、InRibbonGallery、Spinner、SplitButtonGallery或ToggleButton

否則，當 Row 或 GroupSizeDefinition 是父代時， 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
• 可以是空的：否

另請參閱

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