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.

Bevor Sie in einer Desktop-App eine instance dieser Klasse so verwenden, dass die Benutzeroberfläche angezeigt wird, müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhä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

Weitere Informationen finden Sie im Codebeispiel im Thema LaunchUriAsync(Uri, LauncherOptions).

Hinweise

Versionsverlauf

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

Konstruktoren

LauncherOptions()

Erstellt und initialisiert eine neue instance des Startprogrammoptionenobjekts. Bevor Sie in einer Desktop-App eine instance dieser Klasse so verwenden, dass die Benutzeroberfläche angezeigt wird, müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

Eigenschaften

ContentType	Ruft den Inhaltstyp ab, der einem URI zugeordnet ist, der eine Datei im Netzwerk darstellt, oder legt diesen fest.
DesiredRemainingView	Starten Sie eine Ziel-App, und lassen Sie die aktuell ausgeführte Quell-App auf dem Bildschirm verbleiben, indem Sie den Speicherplatz gleich mit der Ziel-App teilen oder mehr oder weniger Speicherplatz als die Ziel-App belegen.
DisplayApplicationPicker	Ruft einen Wert ab, der angibt, ob das Dialogfeld Öffnen mit angezeigt werden soll, wenn die Zuordnungsstart-API aufgerufen wird, oder legt diesen fest.
FallbackUri	Ruft einen Wert ab, der einen URI darstellt, zu dem der Benutzer im Browser weitergeleitet werden soll, wenn keine App zur Verarbeitung des Dateityps oder URI vorhanden ist, oder legt diesen fest.
IgnoreAppUriHandlers	Gibt an, ob Handler ignoriert werden sollen, die HTTP-Schemas (z. B. Browser) verarbeiten können. Stattdessen wird der Start auf den Standardbrowser zurückgesetzt.
LimitPickerToCurrentAppAndAppUriHandlers	Ruft ab oder legt fest, ob die Auswahl für das Startprogramm auf die aktuelle App und die zugehörigen URI-Handler beschränkt werden soll.
NeighboringFilesQuery	Ermöglicht einer App den Zugriff auf Dateien, die sich auf die Datei beziehen, die zum Aktivieren der App verwendet wird.
PreferredApplicationDisplayName	Ruft einen Wert ab, 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 behandeln, oder legt diesen fest.
PreferredApplicationPackageFamilyName	Ruft einen Wert ab, 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, oder legt diesen fest.
TargetApplicationPackageFamilyName	Der Paketfamilienname des Zielpakets, das zum Starten einer Datei oder eines URI verwendet werden soll. Diese Eigenschaft ist optional.
TreatAsUntrusted	Ruft einen Wert ab, 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, möglicherweise unsicher ist, oder legt diesen fest.
UI	Ruft die Benutzeroberflächenoptionen ab, wenn eine Standard-App gestartet wird.

Weitere Informationen

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