Windows 점프 목록에 항목 추가

점프 목록은 사용자가 작업 표시줄 또는 시작 메뉴에서 앱 아이콘을 마우스 오른쪽 단추로 클릭할 때 Windows 표시하는 바로 가기 메뉴입니다. 점프 목록을 새 메시지 작성 또는 설정 열기 와 같은 빠른 앱 전체 작업과 최근 프로젝트 또는 고정된 문서와 같은 사용자 지정 항목 그룹으로 채울 수 있습니다.

WinUI 갤러리 앱을 열고 작동 중인 JumpList를 확인합니다.

Important

JumpList API에는 패키지 ID가 필요합니다. 패키지된(MSIX) 앱 및 외부 위치로 패키지된 앱에서 작동하지만 패키지되지 않은 앱에서는 사용할 수 없습니다.

사전 요구 사항

현재 점프 목록 로드

항목을 추가하거나 제거하기 전에 JumpList.LoadCurrentAsync를 호출하여 앱의 현재 점프 목록을 로드합니다.

using Windows.UI.StartScreen;

var jumpList = await JumpList.LoadCurrentAsync();

작업 추가

작업은 GroupName 속성이 비어 있는 항목입니다. Windows는 점프 목록 맨 아래에 있는 기본 제공되는 작업 섹션에 배치합니다. 컨텍스트에 관계없이 항상 관련된 일반적인 작업에 작업을 사용합니다.

JumpListItem.CreateWithArguments를 사용하여 작업을 만들고 Items 컬렉션에 추가한 다음 JumpList.SaveAsync를 호출하여 저장합니다. 사용자가 작업을 선택하면 Windows 입력한 인수 문자열을 사용하여 앱을 시작합니다. 이 문자열은 시작 시 활성화 인수에서 읽을 수 있습니다.

var jumpList = await JumpList.LoadCurrentAsync();

var task = JumpListItem.CreateWithArguments("/compose", "New Message");
task.Description = "Compose a new message";
task.Logo = new Uri("ms-appx:///Assets/Tiles/AppList.targetsize-48.png");

jumpList.Items.Add(task);
await jumpList.SaveAsync();

사용자 지정 그룹에 항목 추가

사용자 지정 그룹을 사용하면 명명된 제목 아래에 관련 항목을 구성할 수 있습니다. GroupName 속성을 비어있지 않은 문자열로 설정합니다. 동일한 GroupName 항목을 공유하는 모든 항목이 해당 제목 아래에 함께 표시됩니다.

var jumpList = await JumpList.LoadCurrentAsync();

var item = JumpListItem.CreateWithArguments("/project-alpha", "Project Alpha");
item.GroupName = "Projects";
item.Description = "Open Project Alpha";
item.Logo = new Uri("ms-appx:///Assets/Tiles/AppList.targetsize-48.png");

jumpList.Items.Add(item);
await jumpList.SaveAsync();

모든 항목 지우기

추가한 모든 항목을 제거하려면 저장하기 전에 Items 컬렉션을 지웁니다.

var jumpList = await JumpList.LoadCurrentAsync();
jumpList.Items.Clear();
await jumpList.SaveAsync();

Windows 이 호출에 관계없이 시스템 관리 섹션(예: 최근 및 빈도)을 유지합니다. 사용자 지정 작업 및 그룹만 지워집니다.

  • Last updated on