다음을 통해 공유


단추(Windows 리본 프레임워크)

단추는 사용자가 애플리케이션에 입력을 제공하기 위해 클릭할 수 있는 컨트롤입니다.

소개

다음 스크린샷에는 리본 단추 요소의 세 가지 예가 포함되어 있습니다.

microsoft wordpad 리본에서 단추 컨트롤의 스크린샷을 .

단추 속성

Ribbon 프레임워크는 Button 컨트롤에 대한 속성 키 컬렉션을 정의합니다.

일반적으로 단추 속성은 IUIFramework::InvalidateUICommand 메서드에 대한 호출을 통해 컨트롤과 연결된 명령을 무효화하여 리본 UI에서 업데이트됩니다. iUICommandHandler::UpdateProperty콜백 메서드를무효화 이벤트가 처리되고 속성 업데이트가 정의됩니다.

IUICommandHandler::UpdateProperty 콜백 메서드는 실행되지 않으며 애플리케이션은 프레임워크에서 속성이 필요할 때까지 업데이트된 속성 값을 쿼리합니다. 예를 들어 탭이 활성화되고 리본 UI에 컨트롤이 표시되거나 도구 설명이 표시되는 경우입니다.

메모

경우에 따라 IUIFramework::GetUICommandProperty 메서드를 통해 속성을 검색하고 IUIFramework::SetUICommandProperty 메서드로 설정할 수 있습니다.

 

다음 표에서는 단추 컨트롤과 연결된 속성 키를 나열합니다.

속성 키 노트
UI_PKEY_Enabled IUIFramework::GetUICommandPropertyIUIFramework::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 무효화를 통해서만 업데이트할 수 있습니다.

 

Windows 리본 프레임워크 컨트롤 라이브러리

단추 태그 요소