클릭 시 토글 단추는 애플리케이션에 대한 입력을 제공합니다. 컨트롤은 상호 배타적인 토글 상태를 나타냅니다.
세부 정보
다음 스크린샷은 리본 토글 단추를 보여 줍니다.
microsoft 그림판 리본에서 토글버튼 컨트롤의 스크린샷을 
단추 속성 설정/해제
리본 프레임워크는 설정/해제 단추 컨트롤에 대한 속성 키 컬렉션을 정의합니다.
일반적으로 Toggle Button 속성은 IUIFramework::InvalidateUICommand 메서드 호출을 통해 컨트롤과 연결된 명령을 무효화하여 리본 UI에서 업데이트됩니다. iUICommandHandler::UpdateProperty콜백 메서드를무효화 이벤트가 처리되고 속성 업데이트가 정의됩니다.
IUICommandHandler::UpdateProperty 콜백 메서드는 실행되지 않으며 애플리케이션은 프레임워크에서 속성이 필요할 때까지 업데이트된 속성 값을 쿼리합니다. 예를 들어 탭이 활성화되고 리본 UI에 컨트롤이 표시되거나 도구 설명이 표시되는 경우입니다.
메모
경우에 따라 IUIFramework::GetUICommandProperty 메서드를 통해 속성을 검색하고 IUIFramework::SetUICommandProperty 메서드로 설정할 수 있습니다.
다음 표에서는 토글 단추 컨트롤과 연결된 속성 키를 나열합니다.
| 속성 키 | 노트 |
|---|---|
| UI_PKEY_BooleanValue | IUIFramework::GetUICommandProperty및 IUIFramework::SetUICommandProperty지원합니다.
참고:IUIFramework::InvalidateUICommand호출을 통해 컨트롤과 연결된 명령이 무효화되면 프레임워크는 UI_INVALIDATIONS_VALUE플래그 값으로 전달될 때 이 속성을 쿼리합니다. |
| 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 | 무효화를 통해서만 업데이트할 수 있습니다. |