LauncherOptions.PreferredApplicationDisplayName Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft einen Wert ab, der den Anzeigenamen der App im Store darstellt, den der Benutzer installieren soll, wenn keine App vorhanden ist, um den Dateityp oder den URI zu verarbeiten, oder legt diesen fest.
public:
property Platform::String ^ PreferredApplicationDisplayName { Platform::String ^ get(); void set(Platform::String ^ value); };winrt::hstring PreferredApplicationDisplayName();
void PreferredApplicationDisplayName(winrt::hstring value);public string PreferredApplicationDisplayName { get; set; }var string = launcherOptions.preferredApplicationDisplayName;
launcherOptions.preferredApplicationDisplayName = string;Public Property PreferredApplicationDisplayName As StringEigenschaftswert
Der Anzeigename der App.
Beispiele
Rufen Sie die Launcher.LaunchFileAsync(IStorageFile, LauncherOptions) | launchFileAsync(IStorageFile, LauncherOptions)- Methode auf, wobei preferredApplicationDisplayName auf den Anzeigenamen einer App im Windows Store festgelegt ist und der bevorzugteApplicationPackageFamilyName auf den Paketfamiliennamen einer App im Windows Store festgelegt ist.
async void DefaultLaunch()
{
// Path to the file in the app package to launch
string imageFile = @"images\test.png";
// Get the image file from the package's image directory
var file = await Windows.ApplicationModel.Package.Current.InstalledLocation.GetFileAsync(imageFile);
if (file != null)
{
// 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
bool success = await Windows.System.Launcher.LaunchFileAsync(file, options);
if (success)
{
// File launched
}
else
{
// File launch failed
}
}
else
{
// Could not find file
}
}
Windows::Foundation::IAsyncAction MainPage::DefaultLaunch()
{
// Get the app's installation folder.
Windows::Storage::StorageFolder installFolder{ Windows::ApplicationModel::Package::Current().InstalledLocation() };
Windows::Storage::StorageFile file{ co_await installFolder.GetFileAsync(L"Assets\\LockScreenLogo.scale-200.png") };
if (file)
{
// Set the recommended app.
Windows::System::LauncherOptions launcherOptions;
launcherOptions.PreferredApplicationPackageFamilyName(L"Contoso.FileApp_8wknc82po1e");
launcherOptions.PreferredApplicationDisplayName(L"Contoso File App");
// Launch the retrieved file.
bool success{ co_await Windows::System::Launcher::LaunchFileAsync(file, launcherOptions) };
if (success)
{
// File launched.
}
else
{
// File launch failed.
}
}
else
{
// Couldn't find file.
}
}
void MainPage::DefaultLaunch()
{
auto installFolder = Windows::ApplicationModel::Package::Current->InstalledLocation;
concurrency::task<Windows::Storage::StorageFile^> getFileOperation(installFolder->GetFileAsync("images\\test.png"));
getFileOperation.then([](Windows::Storage::StorageFile^ file)
{
if (file != nullptr)
{
// Set the recommended app
auto launchOptions = ref new Windows::System::LauncherOptions();
launchOptions->PreferredApplicationPackageFamilyName = "Contoso.FileApp_8wknc82po1e";
launchOptions->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
concurrency::task<bool> launchFileOperation(Windows::System::Launcher::LaunchFileAsync(file, launchOptions));
launchFileOperation.then([](bool success)
{
if (success)
{
// File launched
}
else
{
// File launch failed
}
});
}
else
{
// Could not find file
}
});
}
async Sub DefaultLaunch()
' Path to the file in the app package to launch
Dim imageFile = "images\test.png"
' Get the image file from the package's image directory
Dim file = await Windows.ApplicationModel.Package.Current.InstalledLocation.GetFileAsync(imageFile)
If file IsNot Nothing Then
' Set the recommended app
Dim options = 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
Dim success = await Windows.System.Launcher.LaunchFileAsync(file)
If success Then
' File launched
Else
' File launch failed
End If
Else
' Could not find file
End If
End Sub
Hinweise
Es kann jedoch sein, dass der Benutzer nicht über die erforderliche App zum Bearbeiten des aufgerufenen Dateityps verfügt. In diesen Fällen bietet Windows standardmäßig einen Link an, mit dessen Hilfe Benutzer im Store nach einer geeigneten App suchen können. Verwenden Sie LauncherOptions.PreferredApplicationDisplayName in Verbindung mit LauncherOptions.preferredApplicationPackageFamilyName , um dem Benutzer eine App im Windows Store bereitzustellen, die er abrufen kann, um die Datei zu verarbeiten. Der von Ihnen verwendete Anzeigename sollte dem Anzeigenamen der App im Windows Store entsprechen.
Sie müssen beide bevorzugten Anwendungseigenschaften festlegen, um eine App zu empfehlen. Eine Festlegung der einen ohne die andere führt zu einem Fehler.
Hinweis
Sie können die bevorzugten Anwendungseigenschaften und den Fallback-URI nicht gleichzeitig festlegen, da nur ein Fallback verwendet werden kann. Die Startprogramm-API schlägt fehl, wenn beide Fallbacks festgelegt sind.
Wichtig
Diese Eigenschaft wird nur auf Desktopgeräten implementiert.