내보내기(0) 인쇄
모두 확장
정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

LauncherOptions.PreferredApplicationDisplayName | preferredApplicationDisplayName Property

파일 형식이나 URI를 처리하기 위한 앱이 없을 경우 사용자가 설치해야 하는 앱의 표시 이름을 스토어에서 나타내는 값을 가져오거나 설정합니다.

구문


var preferredApplicationDisplayName = launcherOptions.preferredApplicationDisplayName;
launcherOptions.preferredApplicationDisplayName = preferredApplicationDisplayName;

속성 값

형식: String [JavaScript] | System.String [.NET] | Platform::String [C++]

응용 프로그램의 표시 이름입니다.

설명

경우에 따라 사용자는 시작할 파일을 처리하기 위해 앱을 설치하지 않을 수 있습니다. 기본적으로 Windows는 사용자가 스토어에서 적절한 앱을 검색할 수 있는 링크를 제공하여 이러한 사례를 처리합니다. LauncherOptions.PreferredApplicationDisplayNameLauncherOptions.preferredApplicationPackageFamilyName과 함께 사용하여 파일을 처리하기 위해 얻을 수 있는 Windows 저장소에 있는 앱을 사용자에게 제공합니다. 사용하는 표시 이름은 Windows 스토어에서 앱이 표시되는 이름과 같아야 합니다.

앱을 권장하려면 기본 설정된 이러한 응용 프로그램 속성을 모두 설정해야 합니다. 다른 것 없이 하나만 설정하면 오류가 발생합니다.

참고  하나의 대체(fallback)만 사용할 수 있으므로 기본 설정된 응용 프로그램 속성과 대체(fallback) URI를 동시에 설정할 수는 없습니다. 두 대체(fallback)가 모두 설정된 경우 시작 관리자 API가 실패합니다.

Windows Phone 8

이 API는 구현되어 있지 않으므로 호출할 경우 예외가 throw됩니다. Windows Phone 런타임 API를 참조하십시오.

예제

preferredApplicationDisplayName을 Windows 스토어 앱의 표시 이름으로 설정하고 preferredApplicationPackageFamilyName 을 Windows 스토어 앱의 패키지 패밀리 이름으로 설정한 상태에서 Launcher.LaunchFileAsync(IStorageFile, LauncherOptions) | launchFileAsync(IStorageFile, LauncherOptions) 메서드를 호출합니다.


// Path to the file in the app package to launch
var imageFile = "images\\test.png";

// Get the image file from the package's image directory
Windows.ApplicationModel.Package.current.installedLocation.getFileAsync(imageFile).then(
  function (file) {
    // Set the recommended app
    var options = new Windows.System.LauncherOptions();
    options.preferredApplicationPackageFamilyName = “Contoso.FileApp_8wknc82po1e”;
    options.preferredApplicationDisplayName = “Contoso File App”;


    // Launch the retrieved file pass in the recommended app 
    // in case the user has no apps installed to handle the file
    Windows.System.Launcher.launchFileAsync(file, options).then(
      function (success) {
        if (success) {
            // File launched
        } else {
            // File launch failed
        }
      });
  });


요구 사항

지원되는 최소 클라이언트

Windows 8

지원되는 최소 서버

Windows Server 2012

지원되는 최소 전화

Windows Phone 8[구현되지 않음, 설명 참조]

Namespace

Windows.System
Windows::System [C++]

Metadata

Windows.winmd

참고 항목

LauncherOptions
샘플
연결 시작 샘플
작업
파일의 기본 앱을 시작하는 방법(JavaScript)
파일의 기본 앱을 시작하는 방법(C#/VB/C++)
URI의 기본 앱을 시작하는 방법(JavaScript)
URI의 기본 앱을 시작하는 방법(C#/VB/C++)
지침
파일 형식 및 URI를 위한 지침 및 검사 목록
참조
Launcher.LaunchFileAsync(IStorageFile, LauncherOptions)
Launcher.LaunchUriAsync(Uri, LauncherOptions)

 

 

표시:
© 2014 Microsoft