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).

Комментарии

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

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

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

LauncherOptions()

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

Свойства

ContentType	Возвращает или задает тип контента, связанный с универсальным кодом ресурса (URI), который представляет файл в сети.
DesiredRemainingView	Запустите целевое приложение и сохраните запущенное исходное приложение на экране, разделив пространство в равной степени с целевым приложением или заняв больше или меньше места, чем целевое приложение.
DisplayApplicationPicker	Возвращает или задает значение, указывающее, следует ли отображать диалоговое окно Открыть с помощью при каждом вызове 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