AppTaskInfo 클래스

정의

Windows 셸에 표시할 수 있는 앱 작업을 나타냅니다.

public ref class AppTaskInfo sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.UI.Shell.Tasks.AppTaskContract, 65536)]
/// [Windows.Foundation.Metadata.Experimental]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AppTaskInfo final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.UI.Shell.Tasks.AppTaskContract), 65536)]
[Windows.Foundation.Metadata.Experimental]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AppTaskInfo
Public NotInheritable Class AppTaskInfo
상속
Object Platform::Object IInspectable AppTaskInfo
특성

Windows 요구 사항

요구 사항 Description
디바이스 패밀리
Windows Desktop Extension SDK (10.0.26100.0에서 도입되었습니다.)
API contract
Windows.UI.Shell.Tasks.AppTaskContract (v2.0에서 도입되었습니다.)

설명

Important

앱 작업 지원은 2026년 5월부터 점진적으로 Windows 11로 롤아웃됩니다. API에서 Windows.UI.Shell.Tasks 사용하도록 설정된 환경을 사용하려면 해당 앱 작업 기능이 앱이 실행되는 Windows 버전에 있어야 합니다. 그렇지 않으면 이러한 API는 아무런 영향을 주지 않습니다.

이 클래스는 작업 표현 만들기, 업데이트 및 제거를 지원합니다. 작업은 앱 세션 및 시스템 재부팅에서 유지됩니다.

각 태스크에 대해 새 AppTaskInfo 인스턴스를 만들고 작업 상태를 나타내도록 수정합니다. 작업이 더 이상 관련이 없는 경우 Remove 를 호출하여 셸에서 제거합니다.

IsSupported를 사용하여 작업을 만들거나 열거하기 전에 기능을 사용할 수 있는지 확인합니다. FindAll을 사용하여 이전에 만든 기존 작업을 열거합니다.

작업 표시줄 인터페이스를 통해 사용자가 작업을 숨길 수 있습니다. 작업을 숨기는 것은 앱에서 실행되는 작업에 영향을 주지 않습니다. 해당 표현은 작업 표시줄에서 단순히 제거됩니다. HiddenByUser 속성은 사용자가 작업을 숨겨졌는지 여부를 나타냅니다.

셸 작업 API 사용

이러한 API를 사용하는 앱은 패키지해야 합니다. 자세한 내용은 패키징 개요 를 참조하세요.

또한 다음과 같이 com.microsoft.apptaskprovider을 앱 매니페스트에 추가 해야 합니다.

<Package
  xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
  xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="rescap uap uap3">
...

<Application>
  ...
  <Extensions>
    <uap3:Extension Category="windows.appExtension">
        <uap3:AppExtension
            Name="com.microsoft.apptaskprovider"
            PublicFolder="Public"
            Id="MyApp.AppTaskProvider"
            DisplayName="AppTaskProvider for MyApp"/>
    </uap3:Extension>
  </Extensions>
  ...
</Application>

...
</Package>

속성

Name Description
DeepLink

사용자가 작업의 셸 표현을 클릭할 때 시작될 URI를 가져옵니다.

EndTime

이 작업이 종료 상태(예: Completed 또는 Error)에 도달한 시간을 가져옵니다.

HiddenByUser

사용자가 Windows 셸을 통해 이 작업을 숨기었는지 여부를 나타내는 값을 가져옵니다.

IconUri

작업을 나타내는 아이콘의 경로를 가져옵니다.

Id

이 작업에 대해 자동으로 생성된 고유 식별자를 가져옵니다.

StartTime

이 작업이 만들어진 시간을 가져옵니다.

State

이 작업의 현재 상태를 가져옵니다.

Subtitle

이 작업의 부제일을 가져옵니다.

Title

이 작업의 제목을 가져옵니다.

메서드

Name Description
Create(String, String, Uri, Uri, AppTaskContent)

지정된 매개 변수를 사용하여 새 앱 작업을 만듭니다.

FindAll()

현재 애플리케이션에서 만든 모든 앱 작업을 반환합니다.

GetCompletedSteps()

이 작업에 대해 완료된 단계의 시퀀스를 가져옵니다.

GetExecutingStep()

이 작업에 대해 현재 실행 중인 단계를 가져옵니다.

IsSupported()

앱 작업 기능이 현재 디바이스에서 지원되는지 여부를 나타내는 값을 가져옵니다.

Remove()

Windows 셸에서 이 작업을 제거하지만 상태를 변경하지는 않습니다.

Update(AppTaskState, AppTaskContent)

이 작업의 상태와 내용을 모두 업데이트합니다.

UpdateDeepLink(Uri)

이 작업에 대한 딥 링크 URI를 업데이트합니다.

UpdateState(AppTaskState)

콘텐츠를 변경하지 않고 이 작업의 상태를 업데이트합니다.

UpdateTitles(String, String)

이 작업의 제목과 부제목을 업데이트합니다.

적용 대상