애플리케이션 메뉴
애플리케이션 메뉴는 Windows 리본 프레임워크를 구현하는 애플리케이션의 기본 메뉴입니다.
소개
애플리케이션 메뉴는 전체 문서, 사진 또는 동영상과 같은 전체 프로젝트와 관련된 기능을 노출하는 명령이 포함된 메뉴를 표시하는 드롭다운 단추 컨트롤로 구성됩니다. 예를 들어 새로만들기, 열기, 저장 및 종료 명령이 있습니다.
다음 스크린샷은 애플리케이션 메뉴를 보여 줍니다.
애플리케이션 메뉴의 구성 요소
애플리케이션 메뉴는 모든 리본 애플리케이션의 필수 요소입니다. 애플리케이션 메뉴의 진입점은 다음 스크린샷과 같이 Tab 행의 첫 번째 항목으로 표시되는 고유한 단추입니다.
참고
Windows 8 이상: 애플리케이션 메뉴 단추 이미지가 레이블: 파일로 변경되었습니다. 파일은 사용자 고유의 탭에 대한 레이블로 사용하지 않는 것이 좋습니다.
클릭하면 다음 스크린샷(Windows 7용 WordPad의 애플리케이션 메뉴)에 표시된 서식 있는 메뉴가 표시됩니다.
참고
애플리케이션 메뉴 단추를 클릭할 때 탭 집합에 영향을 주지 않습니다. 대신 포커스가 메뉴에 들어갑니다.
애플리케이션 메뉴에는 하나 이상의 MenuGroup 요소가 나타내는 명령 목록과 ApplicationMenu.RecentItems 요소가 나타내는 최근 항목 목록의 두 창이 포함되어 있습니다.
애플리케이션 메뉴 메뉴그룹
ApplicationMenu 요소에는 애플리케이션 수준 명령 목록을 노출하는 MenuGroup 자식 요소가 하나 이상 포함되어야 합니다. 여러 MenuGroup 요소가 선언되면 다음 스크린샷과 같이 그룹 간에 구분선이 그려집니다.
다음은 애플리케이션 메뉴의 MenuGroup 요소에 대한 제약 조건 목록입니다.
모든 MenuGroup 항목은 클래스 특성 값
MajorItems으로 선언해야 합니다.애플리케이션 메뉴 메뉴 그룹은단추, 드롭다운 단추, 분할 단추, 드롭다운 갤러리 및 분할 단추 갤러리 컨트롤만 지원합니다.
! [중요]
명령 갤러리는 애플리케이션 메뉴에서 지원되는 유일한 유형의 갤러리입니다. 갤러리 컨트롤에 대한 자세한 내용은 갤러리 작업을 참조하세요.
MenuGroup에서 단추를 사용하면 다음 스크린샷과 같이 Command.LabelTitle 값이 메뉴에 표시되고 Command.TooltipTitle 및 Command.TooltipDescription 값이 도구 설명으로 표시됩니다.
애플리케이션 메뉴에서 드롭다운 단추, 분할 단추, 드롭다운 갤러리 또는 분할 단추 갤러리 를 사용하는 경우 메뉴 부분은 최근 항목 창을 덮고 숨기는 플라이아웃으로 표시됩니다.
분할 단추 및 드롭다운 단추 컨트롤의 경우 Command.LabelDescription 값이 플라이아웃 메뉴에 인라인으로 표시되어 사용자가 명령 기능을 검색할 수 있도록 시각적으로 지원합니다. Command.LabelDescription의 표시된 값은 프로그래밍 방식으로 두 줄 범위로 나뉘며 아래의 최근 항목 창에 정확히 값을 맞추려고 시도합니다. Command.LabelDescription 값이 맞지 않으면 MenuGroup에서 가장 긴 Command.Comment 값을 수용하도록 플라이아웃이 확장됩니다.
다음 스크린샷은 분할 단추 플라이아웃에서 이러한 동작을 보여 줍니다.
드롭다운 갤러리와 분할 단추 갤러리를 사용하면 레이블과 이미지만 표시됩니다.
애플리케이션 메뉴 크기 조정
애플리케이션 메뉴의 크기 조정은 리본 프레임워크에서 처리됩니다. Command.LabelTitle 또는 Command.LabelDescription 값에 대해 매우 긴 문자열이 제공되거나 명령의 긴 목록이 사용되는 경우 메뉴는 내용을 수용하도록 크기를 조정합니다. 일부 형태의 조정에는 플라이아웃 또는 메뉴 창의 크기를 확장하고 스크롤이 필요할 때 팬 뷰어를 추가하는 것이 포함됩니다.
애플리케이션 메뉴 속성
리본 프레임워크는 애플리케이션 메뉴 컨트롤에 대한 속성 키 컬렉션을 정의합니다.
일반적으로 애플리케이션 메뉴 속성은 IUIFramework::InvalidateUICommand 메서드 호출을 통해 컨트롤과 연결된 명령을 무효화하여 리본 UI에서 업데이트됩니다. 무효화 이벤트가 처리되고 속성 업데이트는 IUICommandHandler::UpdateProperty 콜백 메서드에 의해 정의됩니다.
IUICommandHandler::UpdateProperty 콜백 메서드가 실행되지 않으며 프레임워크에서 속성이 필요할 때까지 애플리케이션이 업데이트된 속성 값에 대해 쿼리되지 않습니다. 예를 들어 프레임워크에는 탭이 활성화되고 컨트롤이 리본 UI에 표시되거나 도구 설명이 표시될 때 속성이 필요합니다.
| 속성 키 | 참고 |
|---|---|
| UI_PKEY_TooltipDescription | 무효화를 통해서만 업데이트할 수 있습니다. |
| UI_PKEY_TooltipTitle | 무효화를 통해서만 업데이트할 수 있습니다. |
관련 항목