다음을 통해 공유

ICustomDestinationList::AddUserTasks 메서드(shobjidl_core.h)

  • 아티클

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

구문

HRESULT AddUserTasks(
  [in] IObjectArray *poa
);

매개 변수

[in] poa

형식: IObjectArray*

작업을 나타내는 하나 이상의 IShellLink(또는 좀 더 드물게 IShellItem) 개체를 나타내는 IObjectArray에 대한 포인터입니다.

참고 여기에서 사용되는 모든 IShellLink 는 SetArguments를 통해 인수 목록을 선언해야 합니다. 사용자 지정 범주에 인수가 없는 IShellLink 개체 추가는 지원되지 않습니다. 사용자는 점프 목록에서 이 유형의 항목을 고정하거나 고정 해제할 수 없으며 추가하거나 제거할 수도 없습니다.
 

반환 값

형식: HRESULT

성공하면 S_OK 반환하고, 그렇지 않으면 오류 값을 반환합니다.

설명

이 메서드를 호출하기 전에 ICustomDestinationList::BeginList 를 호출해야 합니다.

범주가 비어 있지 않으면 작업 범주 헤더는 항상 기본적으로 목록에 표시됩니다. 이 머리글 텍스트는 변경할 수 없습니다. 사용자가 선택한 언어로 표시됩니다.

작업 범주는 항상 점프 목록의 마지막 범주로 표시되지만 목록의 다른 모든 범주보다 우선 순위를 갖습니다. 이 목록이 채워지고 나머지 공간이 다른 범주에 할당됩니다. 다른 범주와 달리 작업 범주의 항목은 사용자가 제거하거나 고정할 수 없습니다. 애플리케이션은 이 범주의 작업 사용자와 다른 범주에 필요한 공간의 균형을 유지해야 합니다.

작업은 애플리케이션 전체에 적용되어야 합니다. 개별 창이나 문서에만 해당되는 것은 아닙니다. 보다 세분화된 상황별 작업의 경우 애플리케이션에서 미리 보기 도구 모음을 통해 제공할 수 있습니다.

참고 작업 목록은 정적이어야 합니다. 애플리케이션의 상태 또는 상태 관계없이 작업 목록은 동일하게 유지되어야 합니다. 이러한 작업은 애플리케이션이 실행되고 있지 않은 경우에도 사용할 수 있습니다. 업데이트할 때 AddUserTasks 를 사용하여 작업 목록을 변경하는 것을 프로그래밍 방식으로 금지할 수는 없지만 점프 목록의 해당 부분이 변경되기를 기대하지 않는 사용자를 혼동할 수 있다는 점을 고려해야 합니다. 그러나 애플리케이션이 "로그인"과 같은 작업의 상태를 "로그아웃"으로 변경하도록 선택하는 경우 작업 목록이 올바르고 최신 상태인지 확인하는 것은 해당 애플리케이션의 책임입니다. 또한 애플리케이션이 예기치 않게 종료되면 작업 표시줄은 애플리케이션을 호출하지 않고 마지막으로 알려진 올바른 버전의 작업 목록을 사용하여 요청하므로 오래된 항목이 발생할 수 있습니다.
 

poa가 가리키는 IObjectArray를 통해 제공되는 IShellLink 인스턴스는 다음을 제공해야 합니다.

표시 이름은 항목의 System.Title(PKEY_Title) 속성을 통해 설정해야 합니다. 속성은 표시 이름을 직접 보유하거나 저장된 문자열을 사용하기 위해 "@shell32.dll,-1324"와 같은 간접 문자열 표현일 수 있습니다. 간접 문자열을 사용하면 항목 이름을 사용자가 선택한 언어로 표시할 수 있습니다.

필요에 따라 설명 필드(SetDescription)를 설정하여 점프 목록의 항목에 대한 사용자 지정 도구 설명을 제공할 수 있습니다.

작업 목록에 구분 기호도 포함될 수 있습니다. 이는 빈 IShellLink(인수 목록 요구 사항에 대한 단일 예외)를 포함하고 IShellLink 개체의 IPropertyStore 인터페이스를 통해 System.AppUserModel.IsDestListSeparator 속성을 TRUE로 설정하여 만들어집니다. IShellLink의 다른 모든 값은 무시됩니다. 구분 기호는 목록의 전체 공간을 차지하지 않으며 목록의 항목 수에 포함되지 않습니다. 두 구분 기호 사이에 항목이 없는 경우 구분 기호 중 하나가 표시되지 않습니다. 목록의 시작 또는 끝에 있는 구분 기호도 무시됩니다.

요구 사항

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

추가 정보

ICustomDestinationList

ICustomDestinationList::AppendCategory

ICustomDestinationList::AppendKnownCategory

작업 표시줄 확장