ControlGroup 요소

SizeDefinition 레이아웃 템플릿의 컨트롤 그룹을 나타냅니다.

사용량

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

특성

attribute	Type	필수	Description
SequenceNumber	xs:positiveInteger	No	Group이 부모 요소인 경우에만 유효합니다. 각 SequenceNumber 는 Group 요소 내에서 고유해야 합니다. SequenceNumber의 값은 각 Group 요소에 대해 증가해야 하지만 순차적일 필요는 없습니다. (xs:positiveInteger) 1000에서 59999 사이의 양수 정수 값(포함)입니다.

자식 요소

요소	Description
Button	한 번 이상 발생할 수 있음
확인란	한 번 이상 발생할 수 있음
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으로 제한됩니다.

예제

다음 코드 예제에서는 다양 한 그룹 요소를 사용 하는 사용자 지정 4 단추 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
• 비워 둘 수 있음: 아니요

추가 정보

크기 정의 및 크기 조정 정책을 통해 리본 메뉴 사용자 지정