LauncherOptions Clase

Definición

Espacio de nombres:

Windows.System

Especifica las opciones usadas para iniciar la aplicación predeterminada para un archivo o URI.

En una aplicación de escritorio, antes de usar una instancia de esta clase de forma que muestre la interfaz de usuario, deberá asociar el objeto con el identificador de ventana de su propietario. Para obtener más información y ejemplos de código, consulta Mostrar objetos de interfaz de usuario de WinRT que dependen de 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

Herencia

Object Platform::Object IInspectable LauncherOptions

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

ILauncherViewOptions

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

Consulte el ejemplo de código en el tema LaunchUriAsync(Uri, LauncherOptions).

Comentarios

En algunos casos, cuando llamas a Launcher métodos estáticos para iniciar una aplicación asociada a un tipo de archivo o protocolo URI, debes especificar exactamente qué aplicación quieres iniciar pasando un parámetro LauncherOptions con el TargetApplicationPackageFamilyName propiedad establecida en el nombre de familia del paquete de paquete que contiene esa aplicación.

Dos casos de este tipo son los siguientes:

1. Quiere iniciar una aplicación con un URI y pasar datos de entrada adicionales a la aplicación iniciada mediante Launcher.LaunchUriAsync(Uri, LauncherOptions, ValueSet).
2. Quiere iniciar una aplicación con un URI y esperar a que la aplicación devuelva los datos de salida a la aplicación mediante cualquier sobrecarga de Launcher.LaunchUriForResultsAsync.

En estos casos, tanto la aplicación que llama como la aplicación iniciada deben aceptar cómo interpretar los datos adicionales pasados de una aplicación a la otra. La aplicación que realiza la llamada no puede iniciar ninguna aplicación que sea la predeterminada para ese protocolo URI. En otros casos, la propiedad TargetApplicationPackageFamilyName es opcional.

Historial de versiones

Versión de Windows	Versión del SDK	Valor añadido
1607	14393	IgnoreAppUriHandlers
1703	15063	LimitPickerToCurrentAppAndAppUriHandlers

Constructores

LauncherOptions()

Crea e inicializa una nueva instancia del objeto de opciones del iniciador. En una aplicación de escritorio, antes de usar una instancia de esta clase de forma que muestre la interfaz de usuario, deberá asociar el objeto con el identificador de ventana de su propietario. Para obtener más información y ejemplos de código, consulta Mostrar objetos de interfaz de usuario de WinRT que dependen de CoreWindow.

Propiedades

ContentType	Obtiene o establece el tipo de contenido asociado a un URI que representa un archivo en la red.
DesiredRemainingView	Inicie una aplicación de destino y mantenga la aplicación de origen actualmente en ejecución en la pantalla compartiendo el espacio igual con la aplicación de destino o ocupando más o menos espacio que la aplicación de destino.
DisplayApplicationPicker	Obtiene o establece un valor que indica si se va a mostrar el cuadro de diálogo Abrir con cada vez que se llama a la API de inicio de asociación.
FallbackUri	Obtiene o establece un valor que representa un URI al que se debe llevar el usuario en el explorador si no existe ninguna aplicación para controlar el tipo de archivo o el URI.
IgnoreAppUriHandlers	Indica si se omiten los controladores que pueden controlar esquemas http(s) (por ejemplo, exploradores). En su lugar, el inicio se revertirá al explorador predeterminado.
LimitPickerToCurrentAppAndAppUriHandlers	Obtiene o establece si se va a limitar el selector para el iniciador a la aplicación actual y sus controladores de URI asociados.
NeighboringFilesQuery	Permite que una aplicación acceda a los archivos relacionados con el archivo usado para activar la aplicación.
PreferredApplicationDisplayName	Obtiene o establece un valor que representa el nombre para mostrar de la aplicación en la tienda que el usuario debe instalar si no existe ninguna aplicación para controlar el tipo de archivo o el URI.
PreferredApplicationPackageFamilyName	Obtiene o establece un valor que representa el nombre de familia del paquete de la aplicación en la Tienda que el usuario debe instalar si no existe ninguna aplicación para controlar el tipo de archivo o el URI.
TargetApplicationPackageFamilyName	Nombre de familia del paquete de destino que se debe usar para iniciar un archivo o URI. Esta propiedad es opcional en algunos casos. Vea comentarios.
TreatAsUntrusted	Obtiene o establece un valor que indica si el sistema debe mostrar una advertencia de que el archivo o el URI no son seguros al iniciar la aplicación asociada a un archivo o URI.
UI	Obtiene las opciones de la interfaz de usuario (UI) al iniciar una aplicación predeterminada.

Consulte también

• LaunchFileAsync(IStorageFile, LauncherOptions)
• LaunchUriAsync(Uri, LauncherOptions)
• de inicio de asociación de
• Iniciar la aplicación predeterminada para un archivo
• Iniciar la aplicación predeterminada para un de URI
• Directrices para tipos de archivo y URI