그룹(Windows 리본 프레임워크)

그룹은 탭 내에서 관련 명령 및 컨트롤을 구성합니다.

• 세부 정보
• 그룹 속성
• 관련 항목

세부 정보

다음 스크린샷에서는 리본 그룹 컨트롤을 보여 줍니다.

그룹 속성

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

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

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

참고

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

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

속성 키	참고
UI_PKEY_Keytip	무효화를 통해서만 업데이트할 수 있습니다. 참고: 프레임워크를 사용하려면 그룹 컨트롤에 대한 UI_PKEY_Keytip 값이 대문자 Z로 시작해야 합니다. IUICommandHandler::UpdateProperty 콜백 메서드에서 애플리케이션에서 제공하는 값이 문자 Z로 시작되지 않는 경우 이 값은 무시되고 값은 프레임워크에서 대신 생성됩니다. 프레임워크 값은 문자 Z 뒤에 1부터 시작하여 후속 그룹 컨트롤(Z1, Z2, ..., Zx)에 대해 필요에 따라 순차적으로 증가하는 숫자 값입니다.
UI_PKEY_Label	무효화를 통해서만 업데이트할 수 있습니다.
UI_PKEY_LargeHighContrastImage	무효화를 통해서만 업데이트할 수 있습니다.
UI_PKEY_LargeImage	무효화를 통해서만 업데이트할 수 있습니다.
UI_PKEY_SmallHighContrastImage	무효화를 통해서만 업데이트할 수 있습니다.
UI_PKEY_SmallImage	무효화를 통해서만 업데이트할 수 있습니다.
UI_PKEY_TooltipDescription	무효화를 통해서만 업데이트할 수 있습니다.
UI_PKEY_TooltipTitle	무효화를 통해서만 업데이트할 수 있습니다.

관련 항목

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

Group 요소