Launcher 클래스

정의

네임스페이스:

Windows.System

지정된 파일 또는 URI와 연결된 기본 앱을 시작합니다.

public ref class Launcher abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Launcher final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class Launcher

Public Class Launcher

상속

Object Platform::Object IInspectable Launcher

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

앱 패키지에 포함된 파일 시작

LaunchFileAsync(IStorageFile) 항목의 코드 예제를 참조하세요.

URI 시작

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

경고 대화 상자로 시작

이 예제에서는 launchUriAsync(Uri, LauncherOptions) 를 호출하여 경고와 함께 URI를 시작합니다. treatAsUntrusted 속성을 사용하여 시스템에 경고를 표시해야 함을 나타냅니다.

참고

JavaScript를 사용하는 Windows 앱의 경우 treatAsUntrusted 속성이 설정되어 있고 앵커 요소를 사용하여 URI를 시작하는 경우 이벤트 처리기에서 preventDefault를 호출합니다.

function linkClickHandler(eventInfo) {
    var link = eventInfo.target;
    if (eventInfo.srcElement && (
        (eventInfo.type === "click") ||
        (eventInfo.type === "keydown" && (
        eventInfo.keyCode === WinJS.Utilities.Key.enter ||
        eventInfo.keyCode === WinJS.Utilities.Key.space)))) {
        eventInfo.preventDefault();
        if (link.href.indexOf("ms-appx") > -1) {
            WinJS.Navigation.navigate(link.href);
        }
        else if (link.href.indexOf("http") > -1) {
            // Create a Uri object from a URI string 
            var uri = new Windows.Foundation.Uri(link.href);
            var options = new Windows.System.LauncherOptions();
            // Launch the URI with a warning prompt
            options.treatAsUntrusted = true;
            // Launch the URI
            Windows.System.Launcher.launchUriAsync(uri, options).then(
                function (success) {
                    if (success) {
                        // URI launched
                    } else {
                        // URI launch failed
                    }
                });
        }
    }
}

설명

참고

이 클래스는 민첩하지 않으므로 스레딩 모델 및 마샬링 동작을 고려해야 합니다. 자세한 내용은 스레딩 및 마샬링(C++/CX) 및 다중 스레드 환경(.NET)에서 Windows 런타임 개체 사용을 참조하세요.

버전 기록

Windows 버전	SDK 버전	추가된 값
1607	14393	FindAppUriHandlersAsync
1607	14393	LaunchUriForResultsForUserAsync(User,Uri,LauncherOptions)
1607	14393	LaunchUriForResultsForUserAsync(User,Uri,LauncherOptions,ValueSet)
1607	14393	LaunchUriForUserAsync(User,Uri)
1607	14393	LaunchUriForUserAsync(User,Uri,LauncherOptions)
1607	14393	LaunchUriForUserAsync(User,Uri, LauncherOptions,ValueSet)
1607	14393	QueryAppUriSupportAsync(Uri)
1607	14393	QueryAppUriSupportAsync(Uri,String)
1809	17763	LaunchFolderPathAsync(String)
1809	17763	LaunchFolderPathAsync(String,FolderLauncherOptions)
1809	17763	LaunchFolderPathForUserAsync(User,String)
1809	17763	LaunchFolderPathForUserAsync(User,String,FolderLauncherOptions)

메서드

FindAppUriHandlersAsync(Uri)	디바이스에서 URI(Uniform Resource Identifiers) 처리기를 열거합니다.
FindFileHandlersAsync(String)	디바이스에서 파일 처리기를 열거합니다.
FindUriSchemeHandlersAsync(String)	디바이스에서 스키마 처리기를 열거합니다.
FindUriSchemeHandlersAsync(String, LaunchQuerySupportType)	디바이스에서 스키마 처리기를 열거합니다.
LaunchFileAsync(IStorageFile)	지정된 파일과 연결된 기본 앱을 시작합니다.
LaunchFileAsync(IStorageFile, LauncherOptions)	지정된 옵션을 사용하여 지정된 파일과 연결된 기본 앱을 시작합니다.
LaunchFolderAsync(IStorageFolder)	파일 탐색기 시작하고 지정된 폴더의 내용을 표시합니다.
LaunchFolderAsync(IStorageFolder, FolderLauncherOptions)	지정된 옵션을 사용하여 파일 탐색기 시작하고 지정된 폴더의 내용을 표시합니다.
LaunchFolderPathAsync(String)	파일 탐색기 시작하고 지정된 폴더의 내용을 표시합니다.
LaunchFolderPathAsync(String, FolderLauncherOptions)	지정된 옵션을 사용하여 파일 탐색기 시작하고 지정된 폴더의 내용을 표시합니다.
LaunchFolderPathForUserAsync(User, String)	파일 탐색기 시작하고 지정된 폴더의 내용을 표시합니다.
LaunchFolderPathForUserAsync(User, String, FolderLauncherOptions)	지정된 옵션을 사용하여 파일 탐색기 시작하고 지정된 폴더의 내용을 표시합니다.
LaunchUriAsync(Uri)	지정된 URI의 URI 체계 이름과 연결된 기본 앱을 시작합니다.
LaunchUriAsync(Uri, LauncherOptions)	지정된 옵션을 사용하여 URI 스키마 이름과 연결된 기본 앱 또는 지정된 URI에 대해 ContentType 에서 지정한 앱을 시작합니다.
LaunchUriAsync(Uri, LauncherOptions, ValueSet)	지정된 옵션 및 입력 데이터를 사용하여 지정된 URI의 URI 체계 이름과 연결된 기본 앱을 시작합니다.
LaunchUriForResultsAsync(Uri, LauncherOptions)	지정된 옵션을 사용하여 지정된 URI의 URI 체계 이름과 연결된 기본 앱을 비동기적으로 시작합니다.
LaunchUriForResultsAsync(Uri, LauncherOptions, ValueSet)	지정된 옵션 및 입력 데이터를 사용하여 지정된 URI의 URI 체계 이름과 연결된 기본 앱을 비동기적으로 시작합니다.
LaunchUriForResultsForUserAsync(User, Uri, LauncherOptions)	지정된 옵션을 사용하여 지정된 URI의 URI 체계 이름과 연결된 기본 앱을 비동기적으로 시작하고 특정 사용자를 컨텍스트로 제공합니다.
LaunchUriForResultsForUserAsync(User, Uri, LauncherOptions, ValueSet)	지정된 옵션 및 입력 데이터를 사용하여 지정된 URI의 URI 체계 이름과 연결된 기본 앱을 비동기적으로 시작하고 특정 사용자를 컨텍스트로 제공합니다.
LaunchUriForUserAsync(User, Uri)	지정된 URI의 URI 체계 이름과 연결된 기본 다중 사용자 앱을 시작하고 특정 사용자를 컨텍스트로 제공합니다.
LaunchUriForUserAsync(User, Uri, LauncherOptions)	지정된 옵션을 사용하여 지정된 URI의 URI 체계 이름과 연결된 기본 다중 사용자 앱을 시작하고 특정 사용자를 컨텍스트로 제공합니다.
LaunchUriForUserAsync(User, Uri, LauncherOptions, ValueSet)	지정된 옵션 및 입력 데이터를 사용하여 지정된 URI의 URI 체계 이름과 연결된 기본 다중 사용자 앱을 시작하고 특정 사용자를 컨텍스트로 제공합니다.
QueryAppUriSupportAsync(Uri)	지정된 URI를 처리할 수 있는 앱이 있는지 여부를 비동기적으로 쿼리합니다.
QueryAppUriSupportAsync(Uri, String)	지정된 앱이 지정된 URI를 처리할 수 있는지 여부를 비동기적으로 쿼리합니다.
QueryFileSupportAsync(StorageFile)	지정된 파일에 대해 앱을 활성화할 수 있는지 여부를 비동기적으로 쿼리합니다.
QueryFileSupportAsync(StorageFile, String)	지정된 패키지 이름을 가진 앱을 지정된 파일에 대해 활성화할 수 있는지 여부를 비동기적으로 쿼리합니다.
QueryUriSupportAsync(Uri, LaunchQuerySupportType)	지정된 URI 및 시작 유형에 대해 앱을 활성화할 수 있는지 여부를 비동기적으로 쿼리합니다.
QueryUriSupportAsync(Uri, LaunchQuerySupportType, String)	지정된 URI, 시작 유형 및 패키지 이름에 대해 앱을 활성화할 수 있는지 여부를 비동기적으로 쿼리합니다.

추가 정보

• LauncherOptions
• LauncherUIOptions
• 파일에 대한 기본 앱 시작
• URI에 대한 기본 앱 실행
• 연결 시작 샘플
• 파일 형식 및 URI에 대한 지침