Launcher 클래스

참조

정의

네임스페이스:: Windows.System

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

편집

지정된 파일 또는 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

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

경고 대화 상자로 시작

이 예제에서는 경고와 함께 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, 시작 유형 및 패키지 이름에 대해 앱을 활성화할 수 있는지 여부를 비동기적으로 쿼리합니다.

적용 대상

Launcher 클래스

정의

Windows 요구 사항

예제

설명

버전 기록

메서드

적용 대상

추가 정보

피드백