단추(Windows 리본 프레임워크)
단추는 사용자가 클릭하여 애플리케이션에 입력을 제공할 수 있는 컨트롤입니다.
소개
다음 스크린샷에는 리본 단추 요소의 세 가지 예제가 포함되어 있습니다.
단추 속성
리본 프레임워크는 Button 컨트롤에 대한 속성 키 컬렉션을 정의합니다.
일반적으로 Button 속성은 IUIFramework::InvalidateUICommand 메서드 호출을 통해 컨트롤과 연결된 명령을 무효화하여 리본 UI에서 업데이트됩니다. 무효화 이벤트는 IUICommandHandler::UpdateProperty 콜백 메서드에 의해 처리되고 속성 업데이트가 정의됩니다.
IUICommandHandler::UpdateProperty 콜백 메서드는 실행되지 않으며 애플리케이션은 프레임워크에서 속성이 필요할 때까지 업데이트된 속성 값을 쿼리합니다. 예를 들어 탭이 활성화되고 리본 UI에 컨트롤이 표시되는 경우 또는 도구 설명이 표시되는 경우입니다.
참고
경우에 따라 IUIFramework::GetUICommandProperty 메서드를 통해 속성을 검색하고 IUIFramework::SetUICommandProperty 메서드를 사용하여 설정할 수 있습니다.
다음 표에서는 Button 컨트롤과 연결된 속성 키를 나열합니다.
속성 키 | 참고 |
---|---|
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 | 무효화를 통해서만 업데이트할 수 있습니다. |
관련 항목
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기