단추(Windows 리본 프레임워크)
단추는 사용자가 애플리케이션에 입력을 제공하기 위해 클릭할 수 있는 컨트롤입니다.
소개
다음 스크린샷에는 리본 단추 요소의 세 가지 예가 포함되어 있습니다.
microsoft wordpad 리본에서 단추 컨트롤의 스크린샷을
단추 속성
Ribbon 프레임워크는 Button 컨트롤에 대한 속성 키 컬렉션을 정의합니다.
일반적으로 단추 속성은 IUIFramework::InvalidateUICommand 메서드에 대한 호출을 통해 컨트롤과 연결된 명령을 무효화하여 리본 UI에서 업데이트됩니다. iUICommandHandler::UpdateProperty콜백 메서드를무효화 이벤트가 처리되고 속성 업데이트가 정의됩니다.
IUICommandHandler::UpdateProperty 콜백 메서드는 실행되지 않으며 애플리케이션은 프레임워크에서 속성이 필요할 때까지 업데이트된 속성 값을 쿼리합니다. 예를 들어 탭이 활성화되고 리본 UI에 컨트롤이 표시되거나 도구 설명이 표시되는 경우입니다.
메모
경우에 따라 IUIFramework::GetUICommandProperty 메서드를 통해 속성을 검색하고 IUIFramework::SetUICommandProperty 메서드로 설정할 수 있습니다.
다음 표에서는 단추 컨트롤과 연결된 속성 키를 나열합니다.
속성 키 | 노트 |
---|---|
UI_PKEY_Enabled | IUIFramework::GetUICommandProperty및 IUIFramework::SetUICommandProperty지원합니다. |
UI_PKEY_Keytip | 무효화를 통해서만 업데이트할 수 있습니다. |
UI_PKEY_Label | 무효화를 통해서만 업데이트할 수 있습니다. |
UI_PKEY_LabelDescription | 무효화를 통해서만 업데이트할 수 있습니다. |
UI_PKEY_LargeHighContrastImage | 무효화를 통해서만 업데이트할 수 있습니다. |
UI_PKEY_LargeImage | 무효화를 통해서만 업데이트할 수 있습니다. |
UI_PKEY_SmallHighContrastImage | 무효화를 통해서만 업데이트할 수 있습니다. |
UI_PKEY_SmallImage | 무효화를 통해서만 업데이트할 수 있습니다. |
UI_PKEY_TooltipDescription | 무효화를 통해서만 업데이트할 수 있습니다. |
UI_PKEY_TooltipTitle | 무효화를 통해서만 업데이트할 수 있습니다. |
관련 항목