LauncherOptions Klasse

Definition

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.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class LauncherOptions final : 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")]
class LauncherOptions final : 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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class LauncherOptions : 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")]
public sealed class LauncherOptions : 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
Implementiert

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.

Gilt für:

Weitere Informationen