최근 항목

최근 항목 목록은 애플리케이션 메뉴의 창으로 , 애플리케이션 에 대해 가장 최근에 사용한 MRU(항목)를 표시합니다.

• 세부 정보
• 최근 항목 속성
• 주의
• 관련 항목

세부 정보

다음 스크린샷에서는 Windows 7용 WordPad의 최근 항목 목록을 보여 줍니다.

애플리케이션 메뉴에는 사용자가 작업 중인 최근 문서, 사진, 영화 및 기타 프로젝트를 표시하기 위해 ApplicationMenu.RecentItems 요소가 나타내는 ApplicationMenu.RecentItems 목록이 하나 이상 있을 수 있습니다. 나열된 항목의 수는 0부터 태그에 지정된 최대 수까지이며 기본값은 10입니다. 최근 항목은 파일 이름을 나타내는 문자열의 번호가 매겨진 목록으로 표시됩니다. 다음 스크린샷과 같이 Command.LabelDescription 속성을 사용하여 파일 위치에 대한 전체 경로를 제공하는 것이 좋습니다.

RecentItems 요소에는 다음 스크린샷과 같이 목록의 각 항목 오른쪽에 핀 아이콘이 표시되는 EnablePinning 특성true이 있습니다.

참고

EnablePinning 특성이 지정되지 않은 경우 고정은 기본적으로 사용하도록 설정됩니다.

 

고정 알고리즘은 항목이 최근 항목 목록에서 떨어지는 것을 막기 위한 것입니다. 알고리즘은 다음 동작을 생성합니다.

• 새 항목은 항상 최근 항목 목록의 맨 위에 추가됩니다.
• 항목은 시간이 지남에 따라 목록에서 아래로 이동합니다. 목록이 가득 차면(태그에 지정된 최대 항목 수에 도달) 목록 맨 위에 새 항목이 추가되면 이전 항목이 목록 맨 아래에서 떨어집니다.
• 항목이 이미 목록의 어딘가에 표시되지만 다시 액세스되면 목록 맨 위로 다시 이동합니다.
• 항목이 고정된 경우 여전히 목록 아래로 이동하지만 아래쪽에서 떨어지지는 않습니다. 대신 목록이 가득 차면 새 항목이 목록에 추가되면 고정된 항목 위의 고정되지 않은 첫 번째 항목이 떨어집니다.
• 고정된 항목 수가 최대 항목 수에 도달하면 항목이 고정 해제될 때까지 새 항목이 목록에 추가되지 않습니다.

최근 항목 속성

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

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

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

참고

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

 

다음 표에서는 최근 항목 컨트롤과 연결된 속성 키를 나열합니다.

속성 키	참고
UI_PKEY_Keytip	무효화를 통해서만 업데이트할 수 있습니다.
UI_PKEY_RecentItems	무효화를 통해서만 업데이트할 수 있습니다.

 

설명

IApplicationDocumentLists::GetList 메서드를 사용하여 리본 애플리케이션에 대한 Windows Shell MRU 목록을 검색할 수 있습니다. 그러면 이 메서드에서 검색한 개체를 애플리케이션에서 사용하여 리본 프레임워크에서 애플리케이션 메뉴의 최근 항목 목록을 채우는 데 필요한 데이터를 만들 수 있습니다.

참고

이 메서드를 사용하는 경우 listtype 에는 값 ADLT_RECENT이 있어야 합니다.

 

리본 프레임워크 애플리케이션에서 MRU 항목 목록을 구현하는 방법에 대한 예제는 HTMLEditRibbon 샘플을 참조하세요.

관련 항목

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

최근 항목 태그 요소