Launcher 클래스

정의

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

public ref class Launcher abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class Launcher final
/// [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)]
public static class Launcher
[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 IInspectable Launcher
특성

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) 참조하세요.

경고 대화 상자로 시작

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

참고

JavaScript를 사용하는 Windows 앱의 경우 속성이 설정되어 있고 앵커 요소를 사용하여 URI를 시작하는 경우 treatAsUntrusted 이벤트 처리기에서 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 런타임 개체 사용(.NET)을 참조하세요.

버전 기록

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 체계 이름과 연결된 기본 앱을 비동기적으로 시작하고 특정 User 컨텍스트를 제공합니다.

LaunchUriForResultsForUserAsync(User, Uri, LauncherOptions, ValueSet)

지정된 옵션 및 입력 데이터를 사용하여 지정된 URI의 URI 체계 이름과 연결된 기본 앱을 비동기적으로 시작하고 특정 User 컨텍스트를 제공합니다.

LaunchUriForUserAsync(User, Uri)

지정된 URI의 URI 체계 이름과 연결된 기본 다중 사용자 앱을 시작하고 특정 User 컨텍스트를 제공합니다.

LaunchUriForUserAsync(User, Uri, LauncherOptions)

지정된 옵션을 사용하여 지정된 URI의 URI 체계 이름과 연결된 기본 다중 사용자 앱을 시작하고 특정 User 컨텍스트를 제공합니다.

LaunchUriForUserAsync(User, Uri, LauncherOptions, ValueSet)

지정된 옵션 및 입력 데이터를 사용하여 지정된 URI의 URI 체계 이름과 연결된 기본 다중 사용자 앱을 시작하고 특정 User 컨텍스트를 제공합니다.

QueryAppUriSupportAsync(Uri)

지정된 URI를 처리할 수 있는 앱이 있는지 여부를 비동기적으로 쿼리합니다.

QueryAppUriSupportAsync(Uri, String)

지정된 앱이 지정된 URI를 처리할 수 있는지 여부를 비동기적으로 쿼리합니다.

QueryFileSupportAsync(StorageFile)

지정된 파일에 대해 앱을 활성화할 수 있는지 여부를 비동기적으로 쿼리합니다.

QueryFileSupportAsync(StorageFile, String)

지정된 패키지 이름을 가진 앱을 지정된 파일에 대해 활성화할 수 있는지 여부를 비동기적으로 쿼리합니다.

QueryUriSupportAsync(Uri, LaunchQuerySupportType)

지정된 URI 및 시작 유형에 대해 앱을 활성화할 수 있는지 여부를 비동기적으로 쿼리합니다.

QueryUriSupportAsync(Uri, LaunchQuerySupportType, String)

지정된 URI, 시작 유형 및 패키지 이름에 대해 앱을 활성화할 수 있는지 여부를 비동기적으로 쿼리합니다.

적용 대상

추가 정보