InRibbonGallery 요소

  • 아티클

리본에서 직접 항목의 기본 하위 집합을 노출하는 갤러리 기반 컨트롤인 리본 갤러리 내를 나타냅니다. 드롭다운 메뉴 단추를 클릭하면 나머지 항목이 표시됩니다.

사용량

<InRibbonGallery
  CommandName = "xs:positiveInteger or xs:string"
  HasLargeItems = "Boolean"
  ItemHeight = "xs:integer"
  ItemWidth = "xs:integer"
  MinColumnsLarge = "xs:integer"
  MaxColumnsMedium = "xs:integer"
  MinColumnsMedium = "xs:integer"
  MaxColumns = "xs:integer"
  MaxRows = "xs:integer"
  TextPosition = "TextPositionType"
  Type = "xs:string">
  child elements
</InRibbonGallery>

특성

attribute 유형 필수 Description
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
 ItemWidth와 함께 는 갤러리 컨트롤에 표시되는 항목 이미지의 크기를 결정합니다.

참고:
Type 특성의 값이 와 같은 Item갤러리에만 적용됩니다.



(xs:integer)
기본값은 -1입니다.
ItemWidth
 xs:integer
 No
 ItemHeight와 함께 는 갤러리 컨트롤에 표시되는 항목 이미지의 크기를 결정합니다.

참고:
Type 특성의 값이 와 같은 Item갤러리에만 적용됩니다.



(xs:integer)
기본값은 -1입니다.
MaxColumns
 xs:integer
 No
 InRibbonGallery가 표시하는 최대 열 수를 지정합니다(예: 큰 그룹 레이아웃 드롭다운).

(xs:integer)
MaxColumnsMedium
 xs:integer
 No
 큰 레이아웃으로 전환하기 전에 InRibbonGallery가 중간 그룹 레이아웃에 표시하는 최대 열 수를 지정합니다.

(xs:integer)
MaxRows
 xs:integer
 No
 InRibbonGallery 항목의 레이아웃에 대한 최대 행 수를 지정합니다.

(xs:integer)
기본값은 1입니다.
MinColumnsLarge
 xs:integer
 No
 보통으로 전환하기 전에 InRibbonGallery 가 큰 그룹 레이아웃에 표시하는 최소 열 수를 지정 합니다.

(xs:integer)
MinColumnsMedium
 xs:integer
 No
 Small으로 전환하기 전에 InRibbonGallery가 중간 그룹 레이아웃에 표시하는 최소 열 수를 지정합니다.

(xs:integer)
TextPosition
 TextPositionType
 No
 이미지를 기준으로 항목 레이블이 표시되는 위치를 지정합니다.
다음 값 중 하나로 제한됨:

(아래쪽)
(숨기기)
(왼쪽)
(겹침)
(오른쪽)
(위쪽)
형식
 xs:string
 No
 다음 값 중 하나로 제한됨:

(항목)
(명령)

자식 요소

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

부모 요소

요소 Description
ControlGroup
그룹
QuickAccessToolbar.ApplicationDefaults
 참고:
Windows 8 이상.



설명

선택 사항입니다.

각 ControlGroup 또는 Group 요소에 대해 최대 한 번 발생할 수 있습니다.

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

Microsoft 그림판 리본의 리본 갤러리 컨트롤 스크린샷

예제

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

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

<!-- InRibbonGallery -->
<Command Name="cmdInRibbonGalleryGroup"
         Symbol="cmdInRibbonGalleryGroup"
         Comment="InRibbonGallery Group"
         LabelTitle="InRibbonGallery"/>
<Command Name="cmdInRibbonGallery"
         Symbol="cmdInRibbonGallery"
         Comment="InRibbonGallery"
         LabelTitle="InRibbonGallery"/>

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

<!-- InRibbonGallery -->
<Group CommandName="cmdInRibbonGalleryGroup" SizeDefinition="OneInRibbonGallery">
  <InRibbonGallery CommandName="cmdInRibbonGallery"
                   MaxColumns="10"
                   MaxColumnsMedium="5"
                   MinColumnsLarge="5"
                   MinColumnsMedium="3"
                   Type="Items">
    <InRibbonGallery.MenuLayout>
      <VerticalMenuLayout Rows="2"
                          Gripper="Vertical"/>
    </InRibbonGallery.MenuLayout>
    <InRibbonGallery.MenuGroups>
      <MenuGroup>
        <Button CommandName="cmdButton1"></Button>
        <Button CommandName="cmdButton2"></Button>
      </MenuGroup>
      <MenuGroup>
        <Button CommandName="cmdButton3"></Button>
      </MenuGroup>
    </InRibbonGallery.MenuGroups>            
  </InRibbonGallery>
</Group>

요소 정보

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

추가 정보

리본 갤러리 내 컨트롤

갤러리 작업

갤러리 샘플