LauncherOptions 클래스

정의

네임스페이스:

Windows.System

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

데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 instance 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 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) 항목의 코드 예제를 참조하세요.

설명

버전 기록

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

생성자

LauncherOptions()

시작 관리자 옵션 개체의 새 instance 만들고 초기화합니다. 데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 instance 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 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에 대한 지침