분할 단추 갤러리는 단일 기본 항목 또는 명령을 노출하는 기본 단추와 클릭할 때 항목 또는 명령 컬렉션의 나머지 부분을 함께 사용할 수 없는 드롭다운 목록에 표시하는 보조 단추를 포함하는 복합 컨트롤입니다.
세부 정보
이 컨트롤은 명백한 기본값을 사용할 수 있고 개별 항목을 이미지, 텍스트 또는 둘 다로 나타낼 수 있는 경우 밀접하게 관련된 항목을 노출하는 데 유용합니다.
다음 스크린샷은 Microsoft Paint의 리본 분할 단추 갤러리를 보여 줍니다.
microsoft 페인트 리본에서 splitbuttongallery 컨트롤의 스크린샷을 
분할 단추 갤러리 속성
리본 프레임워크는 분할 단추 갤러리 컨트롤에 대한 속성 키 컬렉션을 정의합니다.
일반적으로 분할 단추 갤러리 속성은 IUIFramework::InvalidateUICommand 메서드에 대한 호출을 통해 컨트롤과 연결된 명령을 무효화하여 리본 UI에서 업데이트됩니다. iUICommandHandler::UpdateProperty콜백 메서드를무효화 이벤트가 처리되고 속성 업데이트가 정의됩니다.
IUICommandHandler::UpdateProperty 콜백 메서드는 실행되지 않으며 애플리케이션은 프레임워크에서 속성이 필요할 때까지 업데이트된 속성 값을 쿼리합니다. 예를 들어 탭이 활성화되고 리본 UI에 컨트롤이 표시되거나 도구 설명이 표시되는 경우입니다.
메모
경우에 따라 IUIFramework::GetUICommandProperty 메서드를 통해 속성을 검색하고 IUIFramework::SetUICommandProperty 메서드로 설정할 수 있습니다.
다음 표에서는 분할 단추 갤러리 컨트롤과 연결된 속성 키를 나열합니다.
| 속성 키 | 노트 |
|---|---|
| UI_PKEY_BooleanValue | IUIFramework::GetUICommandProperty및 IUIFramework::SetUICommandProperty지원합니다. |
| UI_PKEY_Categories | IUIFramework::GetUICommandProperty및 IUIFramework::SetUICommandProperty지원합니다. |
| UI_PKEY_Enabled | IUIFramework::GetUICommandProperty및 IUIFramework::SetUICommandProperty지원합니다. |
| UI_PKEY_ItemsSource | IUIFramework::GetUICommandProperty및 IUIFramework::SetUICommandProperty지원합니다. |
| UI_PKEY_Keytip | 무효화를 통해서만 업데이트할 수 있습니다. |
| UI_PKEY_Label | 무효화를 통해서만 업데이트할 수 있습니다. |
| UI_PKEY_LargeHighContrastImage | 무효화를 통해서만 업데이트할 수 있습니다. |
| UI_PKEY_LargeImage | 무효화를 통해서만 업데이트할 수 있습니다. |
|
UI_PKEY_SelectedItem(항목 갤러리에만 유효) |
IUIFramework::GetUICommandProperty및 IUIFramework::SetUICommandProperty지원합니다.
참고:IUIFramework::InvalidateUICommand호출을 통해 컨트롤과 연결된 명령이 무효화되면 프레임워크는 UI_INVALIDATIONS_VALUE플래그 값으로 전달될 때 이 속성을 쿼리합니다. |
| UI_PKEY_SmallHighContrastImage | 무효화를 통해서만 업데이트할 수 있습니다. |
| UI_PKEY_SmallImage | 무효화를 통해서만 업데이트할 수 있습니다. |
| UI_PKEY_TooltipDescription | 무효화를 통해서만 업데이트할 수 있습니다. |
| UI_PKEY_TooltipTitle | 무효화를 통해서만 업데이트할 수 있습니다. |