AppTaskInfo 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
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
- 상속
- 특성
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 |
이 작업이 종료 상태(예: |
| 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) |
이 작업의 제목과 부제목을 업데이트합니다. |