다음을 통해 공유


CJumpList 클래스

A CJumpList 는 작업 표시줄에서 아이콘을 마우스 오른쪽 단추로 클릭할 때 표시되는 바로 가기 목록입니다.

구문

class CJumpList;

멤버

공용 생성자

속성 설명
CJumpList::CJumpList CJumpList 개체를 생성합니다.
CJumpList::~CJumpList CJumpList 개체를 제거합니다.
이름 설명
CJumpList::AbortList 커밋하지 않고 목록 작성 트랜잭션을 중단합니다.
CJumpList::AddDestination 오버로드됨. 목록에 대상을 추가합니다.
CJumpList::AddKnownCategory 알려진 범주를 목록에 추가합니다.
CJumpList::AddTask 오버로드됨. 정식 작업 범주에 항목을 추가합니다.
CJumpList::AddTasks 정식 작업 범주에 항목을 추가합니다.
CJumpList::AddTaskSeparator 작업 사이에 구분 기호를 추가합니다.
CJumpList::ClearAll 지금까지 현재 인스턴스 CJumpList 에 추가된 모든 작업 및 대상을 제거합니다.
CJumpList::ClearAllDestinations 지금까지의 현재 인스턴스 CJumpList 에 추가된 모든 대상을 제거합니다.
CJumpList::CommitList 목록 작성 트랜잭션을 종료하고 보고된 목록을 연결된 저장소(이 경우 레지스트리)에 커밋합니다.
CJumpList::GetDestinationList 대상 목록에 대한 인터페이스 포인터를 검색합니다.
CJumpList::GetMaxSlots 호출 애플리케이션의 대상 메뉴에 표시할 수 있는 범주 헤더를 포함하여 최대 항목 수를 검색합니다.
CJumpList::GetRemovedItems 제거된 대상을 나타내는 항목의 배열을 반환합니다.
CJumpList::InitializeList 목록 작성 트랜잭션을 시작합니다.
CJumpList::SetAppID 빌드할 목록에 대한 애플리케이션 사용자 모델 ID를 설정합니다.

상속 계층 구조

CJumpList

요구 사항

헤더: afxadv.h

CJumpList::~CJumpList

CJumpList 개체를 제거합니다.

~CJumpList();

CJumpList::AbortList

커밋하지 않고 목록 작성 트랜잭션을 중단합니다.

void AbortList();

설명

이 메서드를 호출하면 호출CommitList하지 않고 삭제하는 CJumpList 것과 같은 효과가 있습니다.

CJumpList::AddDestination

목록에 대상을 추가합니다.

BOOL AddDestination(
    LPCTSTR lpcszCategoryName,
    LPCTSTR strDestinationPath);

BOOL AddDestination(
    LPCTSTR strCategoryName,
    IShellItem* pShellItem);

BOOL AddDestination(
    LPCTSTR strCategoryName,
    IShellLink* pShellLink);

매개 변수

lpcszCategoryName
범주 이름을 지정합니다. 지정된 범주가 없으면 생성됩니다.

strDestinationPath
대상 파일의 경로를 지정합니다.

strCategoryName
범주 이름을 지정합니다. 지정된 범주가 없으면 생성됩니다.

pShellItem
추가되는 대상을 나타내는 셸 항목을 지정합니다.

pShellLink
추가되는 대상을 나타내는 셸 링크를 지정합니다.

Return Value

설명

인스턴스 CJumpList 는 내부적으로 추가된 대상을 누적한 다음 에 CommitList커밋합니다.

CJumpList::AddKnownCategory

알려진 범주를 목록에 추가합니다.

BOOL AddKnownCategory(KNOWNDESTCATEGORY category);

매개 변수

category
알려진 범주 유형을 지정합니다. KDC_RECENT 또는 KDC_KNOWN 수 있습니다.

Return Value

설명

알려진 범주는 사용하는 SHAddToRecentDocs 모든 애플리케이션에 대해 자동으로 계산되는 빈도 및 최근 범주입니다(또는 셸이 일부 시나리오에서 애플리케이션을 대신하여 호출할 때 간접적으로 사용).

CJumpList::AddTask

정식 작업 범주에 항목을 추가합니다.

BOOL AddTask(
    LPCTSTR strTargetExecutablePath,
    LPCTSTR strCommandLineArgs,
    LPCTSTR strTitle,
    LPCTSTR strIconLocation,
    int iIconIndex);

BOOL AddTask(IShellLink* pShellLink);

매개 변수

strTargetExecutablePath
대상 작업 경로를 지정합니다.

strCommandLineArgs
strTargetExecutablePath로 지정된 실행 파일의 명령줄 인수를 지정합니다.

strTitle
대상 목록에 표시될 작업 이름입니다.

strIconLocation
제목과 함께 대상 목록에 표시될 아이콘의 위치입니다.

iIconIndex
아이콘 인덱스입니다.

pShellLink
추가할 작업을 나타내는 셸 링크입니다.

Return Value

설명

인스턴스 CJumpList 는 지정된 작업을 누적하고 그 동안 CommitList대상 목록에 추가합니다. 작업 항목은 애플리케이션의 대상 메뉴 아래쪽에 있는 범주에 표시됩니다. 이 범주는 UI에 채워지면 다른 모든 범주보다 우선합니다.

CJumpList::AddTasks

정식 작업 범주에 항목을 추가합니다.

BOOL AddTasks(IObjectArray* pObjectCollection);

매개 변수

pObjectCollection
추가할 작업의 컬렉션입니다.

Return Value

설명

CJumpList 인스턴스는 지정된 작업을 누적하고 그 동안 CommitList대상 목록에 추가합니다. 작업 항목은 애플리케이션의 대상 메뉴 아래쪽에 있는 범주에 표시됩니다. 이 범주는 UI에 채워지면 다른 모든 범주보다 우선합니다.

CJumpList::AddTaskSeparator

작업 사이에 구분 기호를 추가합니다.

BOOL AddTaskSeparator();

Return Value

성공하면 0이 아닌 경우 0입니다.

CJumpList::CJumpList

CJumpList 개체를 생성합니다.

CJumpList(BOOL bAutoCommit = TRUE);

매개 변수

bAutoCommit
이 매개 변수가 FALSE이면 목록이 소멸자에서 자동으로 커밋되지 않습니다.

CJumpList::ClearAll

지금까지 현재 인스턴스 CJumpList 에 추가된 모든 작업 및 대상을 제거합니다.

void ClearAll();

설명

이 메서드는 모든 데이터 및 내부 인터페이스를 지우고 해제합니다.

CJumpList::ClearAllDestinations

지금까지 CJumpList의 현재 인스턴스에 추가된 모든 대상을 제거합니다.

void ClearAllDestinations();

설명

대상 목록 빌드의 현재 세션에서 지금까지 추가된 모든 대상을 제거하고 다른 대상을 다시 추가해야 하는 경우 이 함수를 호출합니다. 내부 ICustomDestinationList 가 초기화되면 활성 상태로 유지됩니다.

CJumpList::CommitList

목록 작성 트랜잭션을 종료하고 보고된 목록을 연결된 저장소(이 경우 레지스트리)에 커밋합니다.

BOOL CommitList();

Return Value

설명

커밋은 원자성입니다. 커밋이 실패하면 오류가 반환됩니다. CommitList 호출되면 제거된 항목의 현재 목록이 클린. 이 메서드를 호출하면 활성 목록 작성 트랜잭션이 없도록 개체가 다시 설정됩니다. 목록을 BeginList 업데이트하려면 다시 호출해야 합니다.

CJumpList::GetDestinationList

대상 목록에 대한 인터페이스 포인터를 검색합니다.

ICustomDestinationList* GetDestinationList();

Return Value

설명

점프 목록이 초기화되지 않았거나 커밋되거나 중단된 경우 반환된 값은 NULL이 됩니다.

CJumpList::GetMaxSlots

호출 애플리케이션의 대상 메뉴에 표시할 수 있는 범주 헤더를 포함하여 최대 항목 수를 검색합니다.

UINT GetMaxSlots() const;

Return Value

설명

애플리케이션은 이 값까지 결합된 여러 항목 및 범주 헤더만 보고할 수 있습니다. 이 숫자를 호출AppendCategoryAppendKnownCategory하거나 AddUserTasks 초과하면 오류가 반환됩니다.

CJumpList::GetRemovedItems

제거된 대상을 나타내는 항목의 배열을 반환합니다.

IObjectArray* GetRemovedItems();

Return Value

설명

제거된 대상은 점프 목록을 초기화하는 동안 검색됩니다. 새 대상 목록을 생성할 때 애플리케이션은 먼저 제거된 대상 목록을 처리하여 제거된 목록 열거자가 반환한 항목에 대한 추적 데이터를 지워야 합니다. 애플리케이션이 현재 호출 BeginList 이 시작된 트랜잭션에서 방금 제거된 항목을 제공하려고 하면 해당 항목을 다시 추가한 메서드 호출이 실패하여 애플리케이션이 제거된 목록을 준수하는지 확인합니다.

CJumpList::InitializeList

목록 작성 트랜잭션을 시작합니다.

BOOL InitializeList();

Return Value

설명

사용에 대한 포인터ICustomDestinationList, 사용 가능한 슬롯 GetMaxSlots수 또는 를 사용하여 GetDestinationListGetRemovedItems제거된 항목 목록을 검색하려는 경우가 아니면 이 메서드를 명시적으로 호출할 필요가 없습니다.

CJumpList::SetAppID

빌드할 목록에 대한 애플리케이션 사용자 모델 ID를 설정합니다.

void SetAppID(LPCTSTR strAppID);

매개 변수

strAppID
애플리케이션 사용자 모델 ID를 지정하는 문자열입니다.

참고 항목

클래스