LauncherOptions Klasse

Definition

Namespace:

Windows.System

Gibt die Optionen an, die zum Starten der Standard-App für eine Datei oder einen URI verwendet werden.

In einer Desktop-App müssen Sie das Objekt vor der Verwendung einer Instanz dieser Klasse auf eine Weise verwenden, die die Benutzeroberfläche anzeigt, dem Fensterhandle des Besitzers zuordnen. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindowabhängen.

public ref class LauncherOptions sealed : ILauncherViewOptions

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class LauncherOptions final : ILauncherViewOptions

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class LauncherOptions : ILauncherViewOptions

function LauncherOptions()

Public NotInheritable Class LauncherOptions
Implements ILauncherViewOptions

Vererbung

Object Platform::Object IInspectable LauncherOptions

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

ILauncherViewOptions

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Siehe das Codebeispiel im LaunchUriAsync(Uri, LauncherOptions) Thema.

Hinweise

Wenn Sie Launcher- statische Methoden aufrufen, um eine App zu starten, die einem Dateityp oder URI-Protokoll zugeordnet ist, müssen Sie genau angeben, welche App gestartet werden soll, indem Sie einen LauncherOptions Parameter mit dem TargetApplicationPackageFamilyName Eigenschaft übergeben, die auf den Paketfamiliennamen für das App-Paket festgelegt ist, das diese App enthält.

Zwei solche Fälle sind wie folgt:

1. Sie möchten eine App mit einem URI starten und zusätzliche Eingabedaten an die gestartete App übergeben, indem Sie Launcher.LaunchUriAsync(Uri, LauncherOptions, ValueSet)verwenden.
2. Sie möchten eine App mit einem URI starten und warten, bis die App Ausgabedaten zurück an Ihre App sendet, indem Sie eine überladene Launcher.LaunchUriForResultsAsync-verwenden.

In diesen Fällen müssen sowohl die aufrufende als auch die gestartete App zustimmen, wie die zusätzlichen Daten interpretiert werden, die von einer App an die andere übergeben werden. Die aufrufende App kann keine App starten, die als Standard für dieses URI-Protokoll gilt. In anderen Fällen ist die TargetApplicationPackageFamilyName-Eigenschaft optional.

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1607	14393	IgnoreAppUriHandlers
1703	15063	LimitPickerToCurrentAppAndAppUriHandlers

Konstruktoren

LauncherOptions()

Erstellt und initialisiert eine neue Instanz des Startprogrammoptionenobjekts. In einer Desktop-App müssen Sie das Objekt vor der Verwendung einer Instanz dieser Klasse auf eine Weise verwenden, die die Benutzeroberfläche anzeigt, dem Fensterhandle des Besitzers zuordnen. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindowabhängen.

Eigenschaften

ContentType	Dient zum Abrufen oder Festlegen des Inhaltstyps, der einem URI zugeordnet ist, der eine Datei im Netzwerk darstellt.
DesiredRemainingView	Starten Sie eine Ziel-App, und lassen Sie die aktuell ausgeführte Quell-App auf dem Bildschirm verbleiben, indem Sie den Platz gleichmäßig mit der Ziel-App teilen oder mehr oder weniger Speicherplatz als die Ziel-App einnehmen.
DisplayApplicationPicker	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Dialogfeld Öffnen mit angezeigt werden soll, wenn die Zuordnungsstart-API aufgerufen wird.
FallbackUri	Dient zum Abrufen oder Festlegen eines Werts, der einen URI darstellt, zu dem der Benutzer im Browser weitergeleitet werden soll, wenn keine App zum Behandeln des Dateityps oder URI vorhanden ist.
IgnoreAppUriHandlers	Gibt an, ob Handler ignoriert werden sollen, die HTTP-Schemas (z. B. Browser) verarbeiten können. Stattdessen fällt der Start auf den Standardbrowser zurück.
LimitPickerToCurrentAppAndAppUriHandlers	Ruft ab oder legt fest, ob die Auswahl für das Startfeld auf die aktuelle App und die zugehörigen URI-Handler beschränkt werden soll.
NeighboringFilesQuery	Ermöglicht einer App den Zugriff auf Dateien, die mit der Datei zusammenhängen, die zum Aktivieren der App verwendet wird.
PreferredApplicationDisplayName	Dient zum Abrufen oder Festlegen eines Werts, der den Anzeigenamen der App im Store darstellt, die der Benutzer installieren soll, wenn keine App vorhanden ist, um den Dateityp oder den URI zu verarbeiten.
PreferredApplicationPackageFamilyName	Dient zum Abrufen oder Festlegen eines Werts, der den Paketfamiliennamen der App im Store darstellt, die der Benutzer installieren soll, wenn keine App vorhanden ist, um den Dateityp oder den URI zu verarbeiten.
TargetApplicationPackageFamilyName	Der Paketfamilienname des Zielpakets, das zum Starten einer Datei oder eines URI verwendet werden soll. Diese Eigenschaft ist in einigen Fällen optional. Siehe Hinweise.
TreatAsUntrusted	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das System eine Warnung anzeigen soll, dass die Datei oder der URI beim Starten der App, die einer Datei oder einem URI zugeordnet ist, potenziell unsicher ist.
UI	Ruft die Benutzeroberflächenoptionen beim Starten einer Standard-App ab.

Weitere Informationen

• LaunchFileAsync(IStorageFile, LauncherOptions)
• LaunchUriAsync(Uri, LauncherOptions)
• Zuordnungsstartbeispiel
• Starten der Standard-App für eine Datei
• Starten der Standard-App für einen URI-
• Richtlinien für Dateitypen und URIs