Partilhar via


LauncherOptions Classe

Definição

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.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
Herança
Object Platform::Object IInspectable LauncherOptions
Atributos
Implementações

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.

Aplica-se a

Confira também