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 maneira 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

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
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 maneira 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 faça com que 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 a caixa de diálogo Abrir com deve ser exibida 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 nenhum aplicativo existir 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.
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)
• Amostra de inicialização de associação
• Iniciar o app padrão para um arquivo
• Iniciar o app padrão para um URI
• Diretrizes para tipos de arquivos e URIs