LauncherOptions Classe

Definição

Namespace:

Windows.System

Especifica as opções usadas para iniciar o aplicativo padrão para um arquivo ou URI.

Em um aplicativo da área de trabalho, antes de usar uma instância dessa classe de uma forma que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para obter mais informações e exemplos de código, consulte Exibir objetos de interface do usuário do WinRT que dependem do 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

Herança

Object Platform::Object IInspectable LauncherOptions

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

ILauncherViewOptions

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

Consulte o exemplo de código no tópico LaunchUriAsync(Uri, LauncherOptions).

Comentários

Em alguns casos, quando você chama Launcher métodos estáticos para iniciar um aplicativo associado a um tipo de arquivo ou protocolo URI, você deve especificar exatamente qual aplicativo deseja ser iniciado passando um parâmetro LauncherOptions com a propriedade TargetApplicationPackageFamilyName definida para o nome da família de pacotes para o pacote de aplicativos que contém esse aplicativo.

Dois desses casos são os seguintes:

1. Você deseja iniciar um aplicativo com um URI e passar dados de entrada extras para o aplicativo iniciado usando Launcher.LaunchUriAsync(Uri, LauncherOptions, ValueSet).
2. Você deseja iniciar um aplicativo com um URI e aguardar o aplicativo enviar dados de saída de volta para seu aplicativo, usando qualquer sobrecarga de Launcher.LaunchUriForResultsAsync.

Nesses casos, o aplicativo de chamada e o aplicativo iniciado precisam concordar em como interpretar os dados extras passados de um aplicativo para o outro. O aplicativo de chamada não pode iniciar nenhum aplicativo que seja o padrão para esse protocolo URI. Em outros casos, a propriedade TargetApplicationPackageFamilyName é opcional.

Histórico de versões

Versão do Windows	Versão do SDK	Valor acrescentado
1607	14393	IgnoreAppUriHandlers
1703	15063	LimitPickerToCurrentAppAndAppUriHandlers

Construtores

LauncherOptions()

Cria e inicializa uma nova instância do objeto de opções do inicializador. Em um aplicativo da área de trabalho, antes de usar uma instância dessa classe de uma forma que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para obter mais informações e exemplos de código, consulte Exibir objetos de interface do usuário do WinRT que dependem do CoreWindow.

Propriedades

ContentType	Obtém ou define o tipo de conteúdo associado a um URI que representa um arquivo na rede.
DesiredRemainingView	Inicie um aplicativo de destino e o aplicativo de origem em execução permaneça na tela compartilhando o espaço igualmente com o aplicativo de destino ou ocupando mais ou menos espaço do que o aplicativo de destino.
DisplayApplicationPicker	Obtém ou define um valor que indica se o abrir com diálogo sempre que a API de inicialização da associação for chamada.
FallbackUri	Obtém ou define um valor que representa um URI para o qual o usuário deve ser levado no navegador se não houver nenhum aplicativo para manipular o tipo de arquivo ou o URI.
IgnoreAppUriHandlers	Indica se é necessário ignorar manipuladores que podem lidar com esquemas http(s) (como navegadores). Em vez disso, a inicialização retornará ao navegador padrão.
LimitPickerToCurrentAppAndAppUriHandlers	Obtém ou define se o seletor deve ser limitado ao inicializador ao aplicativo atual e seus manipuladores de URI associados.
NeighboringFilesQuery	Permite que um aplicativo acesse arquivos relacionados ao arquivo usado para ativar o aplicativo.
PreferredApplicationDisplayName	Obtém ou define um valor que representa o nome de exibição do aplicativo na loja que o usuário deve instalar se nenhum aplicativo existir para manipular o tipo de arquivo ou o URI.
PreferredApplicationPackageFamilyName	Obtém ou define um valor que representa o nome da família de pacotes do aplicativo na Loja que o usuário deve instalar se não houver nenhum aplicativo para manipular o tipo de arquivo ou o URI.
TargetApplicationPackageFamilyName	O nome da família de pacotes do pacote de destino que deve ser usado para iniciar um arquivo ou URI. Essa propriedade é opcional em alguns casos. Consultede Comentários do .
TreatAsUntrusted	Obtém ou define um valor que indica se o sistema deve exibir um aviso de que o arquivo ou o URI é potencialmente inseguro ao iniciar o aplicativo associado a um arquivo ou URI.
UI	Obtém as opções de interface do usuário ao iniciar um aplicativo padrão.

Confira também

• LaunchFileAsync(IStorageFile, LauncherOptions)
• LaunchUriAsync(Uri, LauncherOptions)
• de exemplo de inicialização da Associação
• iniciar o aplicativo padrão para um arquivo
• iniciar o aplicativo padrão para um URI
• Diretrizes de para tipos de arquivo e URIs