JumpList 클래스

아티클
08/09/2011

Windows 7 작업 표시줄 단추에 메뉴로 표시되는 항목 및 작업의 목록을 나타냅니다.

상속 계층 구조

System.Object
Microsoft.Windows.Shell.JumpList

네임스페이스: Microsoft.Windows.Shell
어셈블리: Microsoft.Windows.Shell(Microsoft.Windows.Shell.dll)

구문

‘선언
<ContentPropertyAttribute("JumpItems")> _
Public NotInheritable Class JumpList _
    Implements ISupportInitialize

[ContentPropertyAttribute("JumpItems")]
public sealed class JumpList : ISupportInitialize

[ContentPropertyAttribute(L"JumpItems")]
public ref class JumpList sealed : ISupportInitialize

[<Sealed>]
[<ContentPropertyAttribute("JumpItems")>]
type JumpList =  
    class
        interface ISupportInitialize
    end

public final class JumpList implements ISupportInitialize

JumpList 형식에서는 다음과 같은 멤버를 노출합니다.

생성자

	이름	설명
	JumpList()	JumpList 클래스의 새 인스턴스를 초기화합니다.
	JumpList(IEnumerable<JumpItem>, Boolean, Boolean)	지정된 매개 변수를 사용하여 JumpList 클래스의 새 인스턴스를 초기화합니다.

위쪽

속성

	이름	설명
	JumpItems	점프 목록에 표시되는 JumpItem 개체의 컬렉션을 가져옵니다.
	ShowFrequentCategory	점프 목록에 자주 사용되는 항목이 표시되는지 여부를 나타내는 값을 가져옵니다.
	ShowRecentCategory	점프 목록에 최근에 사용한 항목이 표시되는지 여부를 나타내는 값을 가져옵니다.

위쪽

메서드

	이름	설명
	AddToRecentCategory(String)	점프 목록의 최근에 사용한 항목 범주에 지정된 항목 경로를 추가합니다.
	AddToRecentCategory(JumpPath)	점프 목록의 최근에 사용한 항목 범주에 지정된 점프 경로를 추가합니다.
	AddToRecentCategory(JumpTask)	점프 목록의 최근에 사용한 항목 범주에 지정된 점프 작업을 추가합니다.
	Apply	JumpList 의 현재 상태를 Windows 셸에 보냅니다.
	BeginInit	인프라입니다. JumpList 초기화가 시작되었음을 나타냅니다.
	EndInit	인프라입니다. JumpList 초기화가 끝났음을 나타냅니다.
	Equals	지정한 Object가 현재 Object와 같은지 여부를 확인합니다. (Object에서 상속됨)
	Finalize	가비지 수집에서 회수하기 전에 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
	GetHashCode	특정 형식에 대한 해시 함수 역할을 합니다. (Object에서 상속됨)
	GetJumpList	응용 프로그램과 연결된 JumpList 개체를 반환합니다.
	GetType	현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
	MemberwiseClone	현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
	SetJumpList	응용 프로그램과 연결된 JumpList 개체를 설정합니다.
	ToString	현재 개체를 나타내는 문자열을 반환합니다. (Object에서 상속됨)

위쪽

이벤트

	이름	설명
	JumpItemsRejected	Windows 셸에서 점프 항목을 점프 목록에 추가하지 못한 경우 발생합니다.
	JumpItemsRemovedByUser	사용자가 점프 목록의 기존 점프 항목을 목록에서 제거할 때 발생합니다.

위쪽

설명

Windows 7 작업 표시줄은 점프 목록을 사용하여 작업 표시줄 단추에서 바로 프로그램을 시작할 수 있는 향상된 기능을 제공합니다. Windows 7 시작 메뉴에도 점프 목록이 사용됩니다. 작업 표시줄 단추를 마우스 오른쪽 단추로 클릭하거나 시작 메뉴에서 프로그램 옆에 있는 화살표를 클릭하여 점프 목록에 액세스할 수 있습니다. 점프 목록에 대한 자세한 내용은 Windows User Experience Interaction 지침의 작업 표시줄 섹션을 참조하십시오.

JumpList 클래스는 Windows 7 작업 표시줄의 점프 목록 기능에 대해 관리되는 래퍼를 제공하고 Windows 셸에 전달되는 데이터를 관리합니다. JumpList 클래스에 의해 노출된 기능은 Windows 7 이전의 Windows 버전에서는 사용할 수 없습니다. JumpList 클래스를 사용하는 응용 프로그램은 다른 버전의 Windows에서 실행되지만 점프 목록은 사용할 수 없습니다. Windows 셸 및 네이티브 점프 목록 API에 대한 자세한 내용은 Taskbar Extensions를 참조하십시오.

다음 그림은 작업 및 빈도 범주에 있는 항목으로 Windows Media Player의 점프 목록을 보여줍니다.

Windows Media Player 점프 목록

점프 목록 구성

점프 목록은 JumpTask와 JumpPath라는 두 항목 유형을 포함할 수 있습니다. JumpTask는 프로그램 링크이며 JumpPath는 파일 링크입니다. JumpTask 및 Title을 지정하지 않은 CustomCategory를 만들어 점프 목록에서 항목을 시각적으로 구분할 수 있습니다. 이 빈 JumpTask는 점프 목록에서 가로 선으로 표시됩니다.

참고
JumpPath에 지정된 파일 형식이 응용 프로그램에 등록되어 있지 않은 경우 파일은 점프 목록에 나타나지 않습니다.예를 들어, .txt 파일을 가리키는 JumpPath를 추가하는 경우 응용 프로그램은 .txt 파일을 처리하도록 등록되어야 합니다.자세한 내용은 Introduction to File Associations를 참조하십시오.

점프 항목은 JumpList의 범주에 배치됩니다. 기본적으로 JumpItem은 작업 범주에 표시됩니다. JumpItem의 CustomCategory를 지정할 수도 있습니다.

ShowRecentCategory 및 ShowFrequentCategory 속성을 사용하여 표준 최근에 사용한 항목 및 자주 사용한 항목 범주를 JumpList에 표시할지 여부를 지정할 수 있습니다. 이 범주의 내용은 Windows 셸에서 관리합니다. 이러한 범주는 동일한 데이터를 많이 포함할 수 있기 때문에 일반적으로 JumpList에 하나 또는 다른 데이터를 표시할 수 있지만 둘 모두는 표시할 수 없습니다. Windows는 최근 항목이 공용 파일 대화 상자를 통해 열려 있거나 파일 형식 연결을 통해 응용 프로그램을 여는 데 사용될 경우 자동으로 최근 항목을 관리합니다. 점프 목록을 통해 항목에 액세스하면 AddToRecentCategory 메서드를 호출하여 최근에 사용한 항목 범주에 항목을 추가하도록 Windows 셸에 알릴 수 있습니다.

Windows 셸에 점프 목록 적용

셸 점프 목록 직접 액세스하거나 JumpList 클래스로 내용을 읽을 수 없습니다. 대신, JumpList 클래스는 작업할 수 있는 점프 목록의 표현을 제공한 다음 Windows 셸에 적용합니다. 일반적으로 JumpList를 만들고 응용 프로그램을 처음 실행할 때 한 번 설정합니다. 그러나 런타임에 JumpList를 수정하거나 바꿀 수 있습니다.

JumpList 속성을 설정한 경우 목록의 내용이 작업 표시줄의 점프 목록에 표시되기 전에 JumpList를 Windows 셸에 적용해야 합니다. JumpList가 XAML 또는 SetJumpList 메서드에 대한 호출에서 응용 프로그램에 먼저 연결되면 자동으로 수행됩니다. 런타임에 JumpList의 내용을 수정하는 경우 Apply 메서드를 호출하여 현재 내용을 Windows 셸에 적용해야 합니다.

XAML에 점프 목록 설정

JumpList는 Application 개체에 자동으로 연결되지 않습니다. 연결된 속성 구문을 사용하여 XAML의 Application 개체에 JumpList를 연결합니다. JumpList 클래스는 JumpList의 XAML 선언을 지원하기 위해 ISupportInitialize 인터페이스를 구현합니다. JumpList가 XAML에서 선언되고 현재 Application에 연결된 경우 JumpList가 초기화될 때 Windows 셸에 자동으로 적용됩니다.

코드에서 점프 목록 설정 및 수정

정적 SetJumpList 메서드를 호출하여 코드의 Application 개체에 JumpList를 연결합니다. 또한 JumpList를 Windows 셸에 적용합니다.

런타임에 JumpList를 수정하려면 GetJumpList 메서드를 호출하여 현재 Application에 연결되어 있는 JumpList를 가져옵니다. JumpList의 속성을 수정한 후 Apply 메서드를 호출하여 Windows 셸에 변경 내용을 적용해야 합니다.

참고
일반적으로 Application에 연결되고 Windows 셸에 적용된 JumpList를 하나 만듭니다.그러나 여러 JumpList 개체를 만들 수 있습니다.한 번에 하나의 JumpList만 Windows 셸에 적용할 수 있으며 한 번에 하나의 JumpList만 Application에 연결할 수 있습니다..NET Framework에서는 해당 항목이 JumpList와 동일할 필요가 없습니다.

참고
이 클래스에는 모든 멤버에 적용되는 클래스 수준의 링크 요청이 포함됩니다.직접 실행 호출자에게 완전 신뢰 권한이 없으면 SecurityException이 throw됩니다.보안 요청에 대한 자세한 내용은 링크 요청 및 상속 요청을 참조하십시오.

.NET Framework 보안

UIPermission

Windows 셸을 수정할 수 있는 모든 액세스 권한입니다. 보안 동작: LinkDemand 연관된 열거형: UIPermissionWindow.AllWindows

스레드로부터의 안전성

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

참고 항목

참조

Microsoft.Windows.Shell 네임스페이스