Drop-Down 단추
Drop-Down 단추는 클릭할 때 상호 배타적인 항목의 드롭다운 목록을 표시하는 단추로 구성됩니다.
세부 정보
이 컨트롤은 명백한 기본값을 사용할 수 없고 개별 항목을 이미지, 텍스트 또는 둘 다로 나타낼 수 있는 경우 밀접하게 관련된 항목을 노출하는 데 유용합니다.
다음 스크린샷에서는 샘플 리본 메뉴의 리본 Drop-Down 단추를 보여 줍니다.
Drop-Down 단추 속성
Ribbon 프레임워크는 Drop-Down 단추 컨트롤에 대한 속성 키 컬렉션을 정의합니다.
일반적으로 Drop-Down Button 속성은 IUIFramework::InvalidateUICommand 메서드 호출을 통해 컨트롤과 연결된 명령을 무효화하여 리본 UI에서 업데이트됩니다. 무효화 이벤트는 IUICommandHandler::UpdateProperty 콜백 메서드에 의해 처리되고 속성 업데이트가 정의됩니다.
IUICommandHandler::UpdateProperty 콜백 메서드는 실행되지 않으며 애플리케이션은 프레임워크에서 속성이 필요할 때까지 업데이트된 속성 값을 쿼리합니다. 예를 들어 탭이 활성화되고 컨트롤이 리본 UI에 표시되는 경우 또는 도구 설명이 표시되는 경우입니다.
참고
경우에 따라 IUIFramework::GetUICommandProperty 메서드를 통해 속성을 검색하고 IUIFramework::SetUICommandProperty 메서드를 사용하여 설정할 수 있습니다.
다음 표에서는 Drop-Down 단추 컨트롤과 연결된 속성 키를 나열합니다.
| 속성 키 | 참고 |
|---|---|
| UI_PKEY_Categories | IUIFramework::GetUICommandProperty 및 IUIFramework::SetUICommandProperty를 지원합니다. |
| UI_PKEY_Enabled |
IUIFramework::GetUICommandProperty 및 IUIFramework::SetUICommandProperty를 지원합니다. 모든 자식 항목을 사용하지 않도록 설정하면 프레임워크는 UI_PKEY_Enabled false(0)로 설정합니다. 그렇지 않으면 하나 이상의 자식 항목을 사용하도록 설정하면 UI_PKEY_Enabled true(-1)로 설정됩니다. 중요: 하나 이상의 자식 항목을 사용하거나 사용하지 않도록 설정한 후 Drop-Down 단추 컨트롤에 대한 UI_PKEY_Enabled 속성을 무효화해야 합니다. 이렇게 하면 프레임워크가 업데이트된 속성 값을 쿼리하고 리본 UI에서 Drop-Down 단추 컨트롤의 상태를 새로 고칩니다. |
| 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 | 무효화를 통해서만 업데이트할 수 있습니다. |