LauncherOptions 클래스

정의

네임스페이스:

Windows.System

파일 또는 URI에 대한 기본 앱을 시작하는 데 사용되는 옵션을 지정합니다.

데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 인스턴스를 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 CoreWindow의존하는 WinRT UI 개체 표시 참조하세요.

public ref class LauncherOptions sealed : ILauncherViewOptions

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class LauncherOptions final : ILauncherViewOptions

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class LauncherOptions : ILauncherViewOptions

function LauncherOptions()

Public NotInheritable Class LauncherOptions
Implements ILauncherViewOptions

상속

Object Platform::Object IInspectable LauncherOptions

특성

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

구현

ILauncherViewOptions

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

LaunchUriAsync(Uri, LauncherOptions) 항목의 코드 예제를 참조하세요.

설명

경우에 따라 Launcher 정적 메서드를 호출하여 파일 형식 또는 URI 프로토콜과 연결된 앱을 시작할 때 TargetApplicationPackageFamilyName 속성이 해당 앱을 포함하는 앱 패키지의 패키지 패밀리 이름으로 설정된 LauncherOptions 매개 변수를 전달하여 실행할 앱을 정확히 지정해야 합니다.

이러한 두 가지 경우는 다음과 같습니다.

1. URI를 사용하여 앱을 시작하고 Launcher.LaunchUriAsync(Uri, LauncherOptions, ValueSet)사용하여 추가 입력 데이터를 실행된 앱에 전달하려고 합니다.
2. URI를 사용하여 앱을 시작하고 앱이 Launcher.LaunchUriForResultsAsync오버로드를 사용하여 출력 데이터를 앱으로 다시 보낼 때까지 기다립니다.

이러한 경우 호출 앱과 시작된 앱 모두 한 앱에서 다른 앱으로 전달된 추가 데이터를 해석하는 방법에 동의해야 합니다. 호출 앱은 해당 URI 프로토콜의 기본값이 되는 앱을 시작할 수 없습니다. 다른 경우에는 TargetApplicationPackageFamilyName 속성은 선택 사항입니다.

버전 기록

Windows 버전	SDK 버전	추가된 값
1607	14393	IgnoreAppUriHandlers
1703	15063	LimitPickerToCurrentAppAndAppUriHandlers

생성자

LauncherOptions()

시작 관리자 옵션 개체의 새 인스턴스를 만들고 초기화합니다. 데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 인스턴스를 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 CoreWindow의존하는 WinRT UI 개체 표시 참조하세요.

속성

ContentType	네트워크의 파일을 나타내는 URI와 연결된 콘텐츠 형식을 가져오거나 설정합니다.
DesiredRemainingView	대상 앱을 시작하고 대상 앱과 공간을 동일하게 공유하거나 대상 앱보다 더 많거나 적은 공간을 차지하여 현재 실행 중인 원본 앱이 화면에 남아 있게 합니다.
DisplayApplicationPicker	연결 시작 API가 호출 될 때마다 대화 상자를 표시할지 여부를 나타내는 값을 가져오거나 설정합니다.
FallbackUri	파일 형식 또는 URI를 처리하는 앱이 없는 경우 사용자가 브라우저에서 가져와야 하는 URI를 나타내는 값을 가져오거나 설정합니다.
IgnoreAppUriHandlers	http(예: 브라우저)를 처리할 수 있는 처리기를 무시할지 여부를 나타냅니다. 대신 시작은 기본 브라우저로 대체됩니다.
LimitPickerToCurrentAppAndAppUriHandlers	시작 관리자의 선택기를 현재 앱 및 연결된 URI 처리기로 제한할지 여부를 가져오거나 설정합니다.
NeighboringFilesQuery	앱이 앱을 활성화하는 데 사용되는 파일과 관련된 파일에 액세스할 수 있도록 합니다.
PreferredApplicationDisplayName	파일 형식 또는 URI를 처리할 앱이 없는 경우 사용자가 설치해야 하는 저장소에 있는 앱의 표시 이름을 나타내는 값을 가져오거나 설정합니다.
PreferredApplicationPackageFamilyName	파일 형식 또는 URI를 처리할 앱이 없는 경우 사용자가 설치해야 하는 앱의 패키지 패밀리 이름을 나타내는 값을 가져오거나 설정합니다.
TargetApplicationPackageFamilyName	파일 또는 URI를 시작하는 데 사용해야 하는 대상 패키지의 패키지 패밀리 이름입니다. 이 속성은 경우에 따라 선택 사항입니다. 설명참조하세요.
TreatAsUntrusted	파일 또는 URI와 연결된 앱을 시작할 때 시스템에서 파일 또는 URI가 잠재적으로 안전하지 않다는 경고를 표시해야 하는지 여부를 나타내는 값을 가져오거나 설정합니다.
UI	기본 앱을 시작할 때 UI(사용자 인터페이스) 옵션을 가져옵니다.

추가 정보

• LaunchFileAsync(IStorageFile, LauncherOptions)
• LaunchUriAsync(Uri, LauncherOptions)
• 연결 시작 샘플
• 파일 대한 기본 앱을 시작합니다.
• URI 대한 기본 앱을 시작합니다.
• 파일 형식 및 URI 대한 지침