ControlGroup 元素

表示 SizeDefinition 布局模板中的一组控件。

使用情况

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

特性

属性	类型	必选	说明
SequenceNumber	xs:positiveInteger	否	仅当 Group 是父元素时有效。 每个 SequenceNumber 在 Group 元素中必须是唯一的。 对于每个 Group 元素，SequenceNumber 的值应增加，但不需要是顺序的。 (xs：positiveInteger) 介于 1000 和 59999 之间的任意正整数值（含）。

子元素

元素	说明
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、 SplitButton、 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
• 可以为空：否

另请参阅

通过大小定义和缩放策略自定义功能区