다음을 통해 공유


JumpList 클래스

정의

앱의 점프 목록에 대한 기능을 제공합니다. 점프 목록은 사용자가 작업 표시줄 또는 시작 메뉴에서 프로그램을 마우스 오른쪽 단추로 클릭할 때 나타나는 시스템 제공 메뉴입니다. 최근 또는 자주 사용되는 문서에 빠르게 액세스하고 앱 기능에 대한 직접 링크를 제공하는 데 사용됩니다. 모든 디바이스 패밀리가 점프 목록을 지원하는 것은 아닙니다.

public ref class JumpList sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class JumpList final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class JumpList
Public NotInheritable Class JumpList
상속
Object Platform::Object IInspectable JumpList
특성

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10586.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v2.0에서 도입되었습니다.)

예제

다음 예제에서는 이전에 추가되었을 수 있는 사용자 지정 항목을 포함하여 앱의 점프 목록을 제거하는 방법을 보여 줍니다.

private async void DisableSystemJumpListAsync()
{
    // Get the app's jump list.
    var jumpList = await Windows.UI.StartScreen.JumpList.LoadCurrentAsync();

    // Disable the system-managed jump list group.
    jumpList.SystemGroupKind = Windows.UI.StartScreen.JumpListSystemGroupKind.None;

    // Remove any previously added custom jump list items.
    jumpList.Items.Clear();

    // Save the changes to the app's jump list.
    await jumpList.SaveAsync();
}

다음 예제에서는 기존 사용자 지정 점프 목록 항목에 영향을 주지 않고 앱의 점프 목록에서 사용하는 시스템 관리 그룹의 유형을 설정하는 방법을 보여 줍니다.

private async void SetSystemGroupAsync()
{
    // Get the app's jump list.
    var jumpList = await Windows.UI.StartScreen.JumpList.LoadCurrentAsync();

    // Set the system to autogenerate a Frequent group for the app jump list.
    // Alternatively, this property could be set to JumpListSystemGroupKind.Recent to autogenerate a Recent group.
    jumpList.SystemGroupKind = Windows.UI.StartScreen.JumpListSystemGroupKind.Frequent;

    // No changes were made to the jump list Items property, so any custom tasks and groups remain intact.
    await jumpList.SaveAsync();
}

설명

앱의 JumpList는 LoadCurrentAsync 메서드를 사용하여 검색됩니다. 애플리케이션이 점프 목록을 사용자 지정하지 않으면 시스템에서 기본 점프 목록을 제공합니다. 현재 기본 점프 목록에 최근 항목이 표시됩니다. 앱이 최근 항목 목록에 표시하려는 특정 파일 형식의 기본 파일 처리기가 되도록 등록되었는지 확인합니다. 자세한 내용은 파일 활성화 처리를 참조하세요.

속성

Items

점프 목록의 JumpListItem 목록을 가져옵니다. 항목은 IVector(JumpListItem) 형식입니다.

SystemGroupKind

시스템 관리 점프 목록 그룹의 현재 형식을 가져오거나 설정합니다.

메서드

IsSupported()

시스템에서 점프 목록을 지원하는지 여부를 나타내는 값을 가져옵니다.

참고

데스크톱 디바이스 패밀리만 점프 목록을 지원하며, 다른 디바이스 패밀리가 있는 점프 목록에 대한 변경 내용은 유지되지 않습니다.

LoadCurrentAsync()

현재 점프 목록 및 해당 항목을 비동기적으로 검색합니다.

SaveAsync()

점프 목록 및 해당 항목에 대한 변경 내용을 비동기적으로 저장합니다.

적용 대상

추가 정보