LauncherOptions Classe

Definizione

Specifica le opzioni usate per avviare l'app predefinita per un file o un URI.

In un'app desktop prima di usare un'istanza di questa classe in modo da visualizzare l'interfaccia utente, sarà necessario associare l'oggetto all'handle della finestra del proprietario. Per altre informazioni ed esempi di codice, vedere Visualizzare gli oggetti dell'interfaccia utente WinRT che dipendono da CoreWindow.

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
Ereditarietà
Object Platform::Object IInspectable LauncherOptions
Attributi
Implementazioni

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Vedere l'esempio di codice nell'argomento LaunchUriAsync(Uri, LauncherOptions).

Commenti

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1607 14393 IgnoreAppUriHandlers
1703 15063 LimitPickerToCurrentAppAndAppUriHandlers

Costruttori

LauncherOptions()

Crea e inizializza una nuova istanza dell'oggetto opzioni del launcher.

In un'app desktop prima di usare un'istanza di questa classe in modo da visualizzare l'interfaccia utente, sarà necessario associare l'oggetto all'handle della finestra del proprietario. Per altre informazioni ed esempi di codice, vedere Visualizzare gli oggetti dell'interfaccia utente WinRT che dipendono da CoreWindow.

Proprietà

ContentType

Ottiene o imposta il tipo di contenuto associato a un URI che rappresenta un file nella rete.

DesiredRemainingView

Avviare un'app di destinazione e avere l'app di origine attualmente in esecuzione rimangono sullo schermo condividendo lo spazio in modo uguale con l'app di destinazione o occupando più o meno spazio rispetto all'app di destinazione.

DisplayApplicationPicker

Ottiene o imposta un valore che indica se visualizzare la finestra di dialogo Apri con ogni volta che viene chiamata l'API di avvio dell'associazione.

FallbackUri

Ottiene o imposta un valore che rappresenta un URI che l'utente deve essere impiegato nel browser se non esiste alcuna app per gestire il tipo di file o l'URI.

IgnoreAppUriHandlers

Indica se ignorare i gestori che possono gestire schemi http (ad esempio browser). Verrà invece eseguito il fallback nel browser predefinito.

LimitPickerToCurrentAppAndAppUriHandlers

Ottiene o imposta se limitare il selettore per il launcher all'app corrente e ai gestori URI associati.

NeighboringFilesQuery

Consente a un'app di accedere ai file correlati al file usato per attivare l'app.

PreferredApplicationDisplayName

Ottiene o imposta un valore che rappresenta il nome visualizzato dell'app nell'archivio che l'utente deve installare se non esiste alcuna app per gestire il tipo di file o l'URI.

PreferredApplicationPackageFamilyName

Ottiene o imposta un valore che rappresenta il nome della famiglia di pacchetti dell'app nello Store che l'utente deve installare se non esiste alcuna app per gestire il tipo di file o l'URI.

TargetApplicationPackageFamilyName

Nome della famiglia di pacchetti del pacchetto di destinazione che deve essere usato per avviare un file o un URI. Questa proprietà è facoltativa.

TreatAsUntrusted

Ottiene o imposta un valore che indica se il sistema deve visualizzare un avviso che il file o l'URI è potenzialmente non sicuro quando si avvia l'app associata a un file o un URI.

UI

Ottiene le opzioni dell'interfaccia utente quando si avvia un'app predefinita.

Si applica a

Vedi anche