다음을 통해 공유

ICustomDestinationList 인터페이스(shobjidl_core.h)

  • 아티클

애플리케이션이 작업 표시줄에 표시할 대상 및 작업을 비롯한 사용자 지정 점프 목록을 제공할 수 있도록 하는 메서드를 노출합니다.

상속

ICustomDestinationList 인터페이스는 IUnknown 인터페이스에서 상속됩니다. ICustomDestinationList 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

ICustomDestinationList 인터페이스에는 이러한 메서드가 있습니다.

 
ICustomDestinationList::AbortList

변경 내용을 커밋하지 않고 ICustomDestinationList::BeginList에서 시작한 점프 목록 빌드 세션을 중단합니다.
ICustomDestinationList::AddUserTasks

사용자 지정 점프 목록의 작업 범주에 포함할 항목을 지정합니다.
ICustomDestinationList::AppendCategory

사용자 지정 점프 목록에 포함할 사용자 지정 범주 및 해당 범주에 포함된 대상을 정의합니다.
ICustomDestinationList::AppendKnownCategory

자주 또는 최근 범주를 사용자 지정 점프 목록에 포함되도록 지정합니다.
ICustomDestinationList::BeginList

사용자 지정 점프 목록에 대한 빌드 세션을 시작합니다.
ICustomDestinationList::CommitList

ICustomDestinationList::BeginList를 호출하여 시작한 점프 목록이 완료되고 표시할 준비가 되었음을 선언합니다.
ICustomDestinationList::D eleteList

지정된 애플리케이션에 대한 사용자 지정 점프 목록을 삭제합니다.
ICustomDestinationList::GetRemovedDestinations

이 사용자 지정 점프 목록을 바꾸려는 기존 점프 목록에서 사용자가 제거한 대상의 현재 목록을 검색합니다.
ICustomDestinationList::SetAppID

작업 표시줄 단추가 이 인터페이스의 메서드를 통해 빌드된 사용자 지정 점프 목록을 보유하는 애플리케이션에 대한 고유한 애플리케이션 사용자 모델 ID(AppUserModelID)를 지정합니다. 이 메서드는 선택 사항입니다.

설명

구현 시기

이 인터페이스의 구현은 CLSID_DestinationList Windows에서 제공됩니다. 이 인터페이스는 타사에서 구현하지 않습니다.

사용 시기

점프 Lists 대상 목록과 작업 목록을 모두 포함합니다.
  • 대상은 개인의 사용에 따라 최근, 자주 또는 사용자 지정 범주에 표시되는 항목입니다. 대상은 파일, 폴더, 웹 사이트 또는 기타 콘텐츠 기반 항목일 수 있지만 반드시 파일 지원은 아닙니다. 목적지는 사물이나 명사로 생각할 수 있습니다. 사용자가 점프 목록에서 대상을 고정하거나 제거할 수 있습니다. 일반적으로 IShellItem 개체로 표현되지만 IShellLink 개체일 수도 있습니다.
  • 작업은 개인의 사용 패턴에 관계없이 해당 애플리케이션의 모든 사용자에게 적용되는 애플리케이션에서 수행되는 일반적인 작업입니다. 작업을 작업 또는 동사로 간주할 수 있습니다. 작업을 고정하거나 제거할 수 없습니다. IShellLink 개체로 표시됩니다.

작업 표시줄은 점프 목록이 있는 각 작업 표시줄 단추를 제공합니다. 기본적으로 점프 목록에는 SHAddToRecentDocs 또는 공통 파일 대화 상자를 통해 파일 기반 애플리케이션에 대해 자동으로 채워지는 최근 범주가 포함됩니다. 최근 범주를 자주 사용하는 범주로 바꾸거나 고유한 사용자 지정 범주를 정의, 추가 및 채려면 애플리케이션에서 이 인터페이스의 메서드를 호출해야 합니다. 애플리케이션은 애플리케이션의 아키텍처 및 용도에 따라 자체 작업을 제공할 수도 있습니다.

참고 애플리케이션은 해당 점프 목록에 표시할 해당 형식의 항목에 대한 파일 형식에 대해 등록된 처리기여야 합니다. 그러나 해당 파일 형식의 기본 처리기가 될 필요는 없습니다.
 
사용자 지정 점프 목록은 애플리케이션의 이전 사용에 따라 또는 항목이 즐겨찾기 목록에 항목을 추가하는 사용자와 같이 사용자에게 중요함을 나타내는 작업을 통해 애플리케이션이 중요하게 간주한 콘텐츠를 표시하기 위한 것입니다.

애플리케이션은 작업 표시줄 UI에 사용자 지정 점프 목록을 제공하려면 이 개체를 호출해야 합니다. 시스템은 애플리케이션에 정보를 쿼리하지 않습니다.

애플리케이션이 사용자 지정 점프 목록을 제공하는 경우 해당 목록에 대한 특정 책임을 맡습니다. 사용자 지정 범주는 점프 목록의 의도된 사용과 일치하는 방식으로 채워야 합니다. 목록의 항목이 유효한지 확인하거나 삭제된 경우 정상적으로 실패해야 합니다. 사용자가 목록에서 항목을 제거하는 경우 해당 제거를 적용해야 합니다.

사용자 지정 점프 목록은 기존 목록의 요소를 변경하는 의미에서 실제로 업데이트되지 않습니다. 대신 이전 목록이 새 목록으로 대체됩니다.

사용자 지정 점프 목록을 빌드하고 표시하기 위해 ICustomDestinationList 메서드 호출의 기본 시퀀스는 다음과 같습니다.

  1. SetAppID (애플리케이션이 자체 AppUserModelID를 제공하는 경우에만 필요)
  2. BeginList
  3. AppendCategory, AppendKnownCategory, AddUserTasks 또는 이러한 세 메서드의 조합입니다.
  4. CommitList

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 shobjidl_core.h(Shobjidl.h 포함)

추가 정보

작업 표시줄 확장