LauncherOptions Класс

Определение

Пространство имен:

Windows.System

Задает параметры, используемые для запуска приложения по умолчанию для файла или URI.

Перед использованием экземпляра этого класса в классическом приложении необходимо связать объект с дескриптором окна владельца. Дополнительные сведения и примеры кода см. в разделе Отображение объектов пользовательского интерфейса WinRT, зависящих от 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

Наследование

Object Platform::Object IInspectable LauncherOptions

Атрибуты

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Реализации

ILauncherViewOptions

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

См. пример кода в разделе LaunchUriAsync(Uri, LauncherOptions).

Комментарии

В некоторых случаях при вызове launcher статические методы для запуска приложения, связанного с типом файла или протоколом URI, необходимо указать точно, какое приложение необходимо запустить, передав параметр LauncherOptions с свойством TargetApplicationPackageFamilyName в качестве имени семейства пакетов для пакета приложения, содержащего это приложение.

Два таких случая:

1. Вы хотите запустить приложение с URI и передать дополнительные входные данные в запущенное приложение с помощью Launcher.LaunchUriAsync(Uri, LauncherOptions, ValueSet).
2. Вы хотите запустить приложение с универсальным кодом ресурса (URI) и ждать отправки выходных данных в приложение с помощью любой перегрузки Launcher.LaunchUriForResultsAsync.

В таких случаях вызывающее приложение и запущенное приложение должны согласиться с тем, как интерпретировать дополнительные данные, передаваемые из одного приложения в другое. Вызывающее приложение не может запустить любое приложение, которое происходит по умолчанию для этого протокола URI. В других случаях свойство TargetApplicationPackageFamilyName является необязательным.

Журнал версий

Версия Windows	Версия пакета SDK	Добавлено значение
1607	14393	IgnoreAppUriHandlers
1703	15063	LimitPickerToCurrentAppAndAppUriHandlers

Конструкторы

LauncherOptions()

Создает и инициализирует новый экземпляр объекта параметров средства запуска. Перед использованием экземпляра этого класса в классическом приложении необходимо связать объект с дескриптором окна владельца. Дополнительные сведения и примеры кода см. в разделе Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow.

Свойства

ContentType	Возвращает или задает тип контента, связанный с универсальным кодом ресурса (URI), который представляет файл в сети.
DesiredRemainingView	Запустите целевое приложение и сохраните в настоящее время исходное приложение на экране, делясь пространством в равной степени с целевым приложением или принимая больше или меньше места, чем целевое приложение.
DisplayApplicationPicker	Возвращает или задает значение, указывающее, следует ли отображать диалоговое окно Open With при вызове API запуска ассоциации.
FallbackUri	Возвращает или задает значение, представляющее универсальный код ресурса (URI), который пользователь должен быть доставлен в браузер, если приложение не существует для обработки типа файла или URI.
IgnoreAppUriHandlers	Указывает, следует ли игнорировать обработчики, которые могут обрабатывать схемы http(например, браузеры). Вместо этого запуск вернется к браузеру по умолчанию.
LimitPickerToCurrentAppAndAppUriHandlers	Возвращает или задает, следует ли ограничить средство выбора для средства запуска текущим приложением и связанными обработчиками URI.
NeighboringFilesQuery	Позволяет приложению получать доступ к файлам, связанным с файлом, используемым для активации приложения.
PreferredApplicationDisplayName	Возвращает или задает значение, представляющее отображаемое имя приложения в магазине, которое пользователь должен установить, если приложение не существует для обработки типа файла или URI.
PreferredApplicationPackageFamilyName	Возвращает или задает значение, представляющее имя семейства пакетов приложения в Магазине, которое пользователь должен установить, если приложение не существует для обработки типа файла или URI.
TargetApplicationPackageFamilyName	Имя семейства пакетов целевого пакета, который должен использоваться для запуска файла или URI. Это свойство является необязательным в некоторых случаях. См. примечания.
TreatAsUntrusted	Возвращает или задает значение, указывающее, должна ли система отображать предупреждение о том, что файл или универсальный код ресурса (URI) потенциально небезопасн при запуске приложения, связанного с файлом или URI.
UI	Возвращает параметры пользовательского интерфейса при запуске приложения по умолчанию.

См. также раздел

• LaunchFileAsync(IStorageFile, LauncherOptions)
• LaunchUriAsync(Uri, LauncherOptions)
• пример запуска ассоциации
• Запустить приложение по умолчанию для файла
• Запустить приложение по умолчанию для URI
• Рекомендации по типам файлов и URI