SplitButtonGallery 요소

갤러리 기반 드롭다운 메뉴가 있는 분할 단추 갤러리 컨트롤을 나타냅니다.

사용량

<SplitButtonGallery
  ApplicationModes = "xs:string"
  CommandName = "xs:positiveInteger or xs:string"
  HasLargeItems = "Boolean"
  ItemHeight = "xs:integer"
  ItemWidth = "xs:integer"
  TextPosition = "TextPositionType"
  Type = "xs:string">
  child elements
</SplitButtonGallery>

특성

attribute	유형	필수	Description
ApplicationModes	xs:string	No	MenuGroup이 부모 요소인 경우에만 유효합니다. (xs:string) 0에서 31 사이의 쉼표로 구분된 정수 목록을 포함하는 문자열입니다. 공백은 유효하고 무시됩니다. 최대 길이: 250자.
CommandName	xs:positiveInteger 또는 xs:string	No	요소를 Command와 연결합니다. (xs:positiveInteger 또는 xs:string) 문자열, 2에서 59999 사이의 정수 값( 포함) 또는 0x2 및 0xea5f 사이의 16진수 값(포함)입니다. 값은 리본 XML 문서 내에서 고유해야 합니다. 최대 길이: 100자.
HasLargeItems	부울	No	명령의 큰 이미지 리소스 또는 작은 이미지 리소스가 갤러리 컨트롤에 표시되는지 여부를 결정합니다. 참고: Type 특성의 값이 와 같은 Command갤러리에만 적용됩니다. 다음 값 중 하나로 제한됩니다(0과 1은 유효하지 않음). (true) 기본값 (false)
ItemHeight	xs:integer	No	(xs:integer) 기본값은 -1입니다.
ItemWidth	xs:integer	No	(xs:integer) 기본값은 -1입니다.
TextPosition	TextPositionType	No	다음 값 중 하나로 제한됨: (아래쪽) (숨기기) (왼쪽) (겹침) (오른쪽) (위쪽)
형식	xs:string	No	다음 값 중 하나로 제한됨: (항목) (명령)

자식 요소

요소	Description
Button	한 번 이상 발생할 수 있습니다.
확인란	한 번 이상 발생할 수 있습니다.
SplitButton	한 번 이상 발생할 수 있습니다.
SplitButtonGallery.MenuGroups	정확히 한 번 발생해야 합니다.
SplitButtonGallery.MenuLayout	최대 한 번 발생할 수 있습니다.
ToggleButton	한 번 이상 발생할 수 있습니다.

부모 요소

요소	Description
ControlGroup
그룹
MenuGroup	ApplicationMenu에 포함된 경우 이 요소는 첫 번째 수준에서만 지원되며 자식 요소가 없어야 합니다.
QuickAccessToolbar.ApplicationDefaults	참고: Windows 8 이상.
SplitButton

설명

선택 사항입니다.

각 ControlGroup, Group, MenuGroup 또는 SplitButton 요소에 대해 하나 이상 발생할 수 있습니다.

SplitButtonGallery 는 애플리케이션 모드를 지원합니다.

UI_PKEY_BooleanValue 애플리케이션에서 SplitButtonGallery의 단추 컨트롤에 대한 토글 상태를 쿼리하는 데 사용됩니다.

다음 스크린샷에서는 Windows 7용 Microsoft 그림판 리본 분할 단추 갤러리 컨트롤을 보여 줍니다.

예제

다음 예제에서는 분할 단추 갤러리의 기본 태그를 보여 줍니다.

이 코드 섹션에서는 SplitButtonGallery 요소의 부모 컨테이너로 작동하는 연결된 그룹과 함께 SplitButtonGallery 명령 선언을 보여 줍니다.

<!-- SplitButtonGallery -->
<Command Name="cmdSplitButtonGalleryGroup"
         Symbol="cmdSplitButtonGalleryGroup"
         Comment="SplitButtonGallery Group"
         LabelTitle="SplitButtonGallery"/>
<Command Name="cmdSplitButtonGallery"
         Symbol="cmdSplitButtonGallery"
         Comment="SplitButtonGallery"
         LabelTitle="SplitButtonGallery"/>

이 코드 섹션에서는 SplitButtonGallery 컨트롤 선언을 보여 줍니다.

<!-- SplitButtonGallery -->
<Group CommandName="cmdSplitButtonGalleryGroup">
  <SplitButtonGallery CommandName="cmdSplitButtonGallery">
    <SplitButtonGallery.MenuLayout>
      <FlowMenuLayout Rows="2"
                      Columns="3"
                      Gripper="None"/>
    </SplitButtonGallery.MenuLayout>
    <SplitButtonGallery.MenuGroups>
      <MenuGroup>
        <Button CommandName="cmdButton1"></Button>
        <Button CommandName="cmdButton2"></Button>
      </MenuGroup>
      <MenuGroup>
        <Button CommandName="cmdButton3"></Button>
      </MenuGroup>
    </SplitButtonGallery.MenuGroups>
  </SplitButtonGallery>
</Group>

요소 정보

• 지원되는 최소 시스템: Windows 7
• 비워 둘 수 있음: 아니요

추가 정보

분할 단추 갤러리 컨트롤

갤러리 작업

SetModes

갤러리 샘플