LauncherOptions Classe

Definizione

Spazio dei nomi:

Windows.System

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, dovrai associare l'oggetto all'handle della finestra del proprietario. Per altre info ed esempi di codice, vedi Visualizzare oggetti dell'interfaccia utente WinRT che dipendono da CoreWindow.

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

Ereditarietà

Object Platform::Object IInspectable LauncherOptions

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni

ILauncherViewOptions

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

In alcuni casi, quando chiami Launcher metodi statici per avviare un'app associata a un tipo di file o a un protocollo URI, devi specificare esattamente quale app vuoi avviare passando un parametro LauncherOptions con la proprietà TargetApplicationPackageFamilyName impostata sul nome della famiglia di pacchetti per il pacchetto dell'app contenente tale app.

Due casi di questo tipo sono i seguenti:

1. Si vuole avviare un'app con un URI e passare dati di input aggiuntivi all'app avviata, usando Launcher.LaunchUriAsync(Uri, LauncherOptions, ValueSet).
2. Si vuole avviare un'app con un URI e attendere che l'app invii i dati di output all'app, usando qualsiasi overload di Launcher.LaunchUriForResultsAsync.

In questi casi, sia l'app chiamante che l'app avviata devono accettare come interpretare i dati aggiuntivi passati da un'app all'altra. L'app chiamante non può avviare alcuna app che sia l'impostazione predefinita per il protocollo URI. In altri casi, la proprietà TargetApplicationPackageFamilyName è facoltativa.

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 dell'utilità di avvio. In un'app desktop, prima di usare un'istanza di questa classe in modo da visualizzare l'interfaccia utente, dovrai associare l'oggetto all'handle della finestra del proprietario. Per altre info ed esempi di codice, vedi Visualizzare 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 fare in modo che l'app di origine attualmente in esecuzione rimanga sullo schermo condividendo lo spazio ugualmente 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 a cui 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 al browser predefinito.
LimitPickerToCurrentAppAndAppUriHandlers	Ottiene o imposta un valore che indica se limitare la selezione per l'utilità di avvio 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 nello Store 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 in alcuni casi. Vedere osservazioni.
TreatAsUntrusted	Ottiene o imposta un valore che indica se il sistema deve visualizzare un avviso che indica che il file o l'URI non è potenzialmente sicuro all'avvio dell'app associata a un file o a un URI.
UI	Ottiene le opzioni dell'interfaccia utente all'avvio di un'app predefinita.

Vedi anche

• LaunchFileAsync(IStorageFile, LauncherOptions)
• LaunchUriAsync(Uri, LauncherOptions)
• Associazione che avvia di esempio
• Avviare l'app predefinita per un file
• Avviare l'app predefinita per un URI
• Linee guida per i tipi di file e gli URI