ApplicationView Класс

Определение

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

Windows.UI.ViewManagement

Представляет активное представление приложения, а также связанные состояния и поведения.

public ref class ApplicationView sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ApplicationView final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ApplicationView

Public NotInheritable Class ApplicationView

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

Object Platform::Object IInspectable ApplicationView

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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

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

Комментарии

Окно (также называемое представлением приложения) — это отображаемая часть приложения среда выполнения Windows. В Windows на экране пользователя может одновременно отображаться до 4 окон переменной ширины. Они не перекрываются, а их верхний и нижний края касаются верхнего и нижнего краев экрана. Между соседними окнами могут находиться неокнущие области.

Окно отличается от текущей страницы приложения. Лучше рассматривать как контейнер страниц; Ссылку на окно можно использовать в программе для всех страниц приложения.

Каждое окно имеет соответствующий coreWindow , представляющий поток обработки пользовательского интерфейса (включая основные обработчики ввода и диспетчер событий) для окна.

При настройке страниц можно использовать свойства (или методы для JavaScript) окна. Например, свойство Orientation указывает, является ли окно книжной или альбомной; Для Windows свойство AdjacentToLeftDisplayEdge указывает, является ли левый край экрана левой границей окна; и метод isFullScreen указывает, использует ли окно весь экран. Примеры использования этих методов см. в примере представлений приложений .

Чтобы получить объект этого типа, вызовите ApplicationView.GetForCurrentView.

Примечание

Не используйте значение, возвращаемое свойством ApplicationView.Value при создании макета страницы. Этот метод является устаревшим и может быть недоступен в будущих выпусках.

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

Версия Windows	Версия пакета SDK	Добавленная стоимость
1703	15063	IsViewModeSupported
1703	15063	TryConsolidateAsync
1703	15063	TryEnterViewModeAsync(ApplicationViewMode)
1703	15063	TryEnterViewModeAsync(ApplicationViewMode,ViewModePreferences)
1703	15063	ViewMode
1903	18362	ClearAllPersistedState
1903	18362	ClearPersistedState
1903	18362	GetDisplayRegions
1903	18362	PersistedStateId
1903	18362	UIContext
1903	18362	WindowingEnvironment

Свойства

AdjacentToLeftDisplayEdge	Возвращает значение, указывающее, находится ли текущее окно в непосредственной близости от левого края экрана.
AdjacentToRightDisplayEdge	Возвращает значение, указывающее, находится ли текущее окно в непосредственной близости к правому краю экрана.
DesiredBoundsMode	Возвращает значение, указывающее границы, используемые платформой для размещения содержимого окна (представление приложения).
FullScreenSystemOverlayMode	Возвращает или задает значение, указывающее, как приложение в полноэкранном режиме реагирует на действия прокрутки по краям.
Id	Возвращает идентификатор окна (представление приложения).
IsFullScreen	Примечание IsFullScreen может быть изменен или недоступен для выпусков после Windows 10. Вместо этого используйте IsFullScreenMode. Возвращает значение, указывающее, касается ли окно левой и правой сторон экрана.
IsFullScreenMode	Возвращает значение, указывающее, работает ли приложение в полноэкранном режиме.
IsOnLockScreen	Возвращает значение, указывая, находится ли окно (представление приложения) на экране блокировки Windows.
IsScreenCaptureEnabled	Возвращает или задает значение, указывающее, включен ли снимок экрана для окна (представления приложения).
Orientation	Возвращает текущую ориентацию (альбомную или книжную) окна (представление приложения) относительно дисплея.
PersistedStateId	Возвращает или задает строку, определяющую это представление для отслеживания и сохранения состояния.
PreferredLaunchViewSize	Возвращает или задает размер, с которым запускается приложение, если свойству ApplicationView.PreferredLaunchWindowingMode присвоено значение PreferredLaunchViewSize, за исключением случаев, когда система управляет размером окна напрямую.
PreferredLaunchWindowingMode	Возвращает или задает значение, указывающее режим окон, в котором запускается приложение.
SuppressSystemOverlays	Примечание SuppressSystemOverlays могут быть изменены или недоступны для выпусков после Windows 10. Вместо этого используйте TryEnterFullScreenMode и FullScreenSystemOverlayMode. Возвращает или задает значение, указывающее, должны ли отображаться системные наложения (например, приложения наложения или мягкое рулевое колесо).
TerminateAppOnFinalViewClose	Указывает, завершается ли приложение при закрытии последнего окна.
Title	Возвращает или задает отображаемое название окна.
TitleBar	Возвращает строку заголовка приложения.
UIContext	Возвращает идентификатор контекста для представления.
Value	Примечание Статические методы ApplicationView могут быть изменены или недоступны для выпусков после Windows 8.1. Вместо этого используйте ApplicationView.GetForCurrentView , чтобы получить объект ApplicationView . Возвращает состояние текущего окна (представление приложения).
ViewMode	Возвращает режим представления приложения для текущего представления.
VisibleBounds	Возвращает видимую область окна (представление приложения). Видимая область — это область, не заключаемая хромом, например строка состояния и панель приложения.
WindowingEnvironment	Возвращает среду окон для представления.

Методы

ClearAllPersistedState()	Очищает все свойства, сохраненные системой для любого представления PersistedStateId для данного приложения.
ClearPersistedState(String)	Очищает все свойства, сохраненные системой для представления с указанным идентификатором для данного приложения.
ExitFullScreenMode()	Выводит приложение из полноэкранного режима.
GetApplicationViewIdForWindow(ICoreWindow)	Возвращает идентификатор окна, соответствующий определенному объекту CoreWindow , управляемому приложением.
GetDisplayRegions()	Возвращает коллекцию областей отображения, доступных для представления.
GetForCurrentView()	Возвращает состояние представления и параметры поведения активного приложения.
IsViewModeSupported(ApplicationViewMode)	Определяет, поддерживается ли указанный режим просмотра на текущем устройстве.
SetDesiredBoundsMode(ApplicationViewBoundsMode)	Задает значение, указывающее границы, используемые платформой для размещения содержимого окна (представления приложения).
SetPreferredMinSize(Size)	Задает наименьший размер (в эффективных пикселях), допустимый для окна приложения.
ShowStandardSystemOverlays()	Отображает элементы системного пользовательского интерфейса, такие как строка заголовка, в полноэкранном приложении.
TryConsolidateAsync()	Пытается скрыть текущее представление приложения. Этот метод является программным эквивалентом закрытия приложения пользователем.
TryEnterFullScreenMode()	Пытается поместить приложение в полноэкранный режим.
TryEnterViewModeAsync(ApplicationViewMode)	Пытается изменить представление приложения на указанный режим представления.
TryEnterViewModeAsync(ApplicationViewMode, ViewModePreferences)	Пытается изменить представление приложения на указанный режим представления с помощью указанных параметров.
TryResizeView(Size)	Пытается изменить размер представления на указанный размер в эффективных пикселях.
TryUnsnap()	Примечание TryUnsnap может быть изменен или недоступен для выпусков после Windows 8.1. Размер приложений можно постоянно изменять, но их нельзя привязать, начиная с Windows 8.1. Кроме того, статические методы ApplicationView могут быть изменены или недоступны для выпусков после Windows 8.1. Используйте ApplicationView.GetForCurrentView , чтобы получить объект ApplicationView . Пытается отменить привязку ранее прикрепленного приложения. Этот вызов будет выполнен, только если приложение выполняется на переднем плане.
TryUnsnapToFullscreen()	Пытается отменить привязку ранее прикрепленного приложения.

События

Consolidated	Происходит при удалении окна из списка недавно использовавшихся приложений или при выполнении пользователем жеста закрытия.
VisibleBoundsChanged	Это событие возникает при изменении значения VisibleBounds , как правило, в результате отображения или скрытия строки состояния, панели приложения или другого хрома.

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

• Пример отключения снимка экрана (Windows 10)
• Пример режима взаимодействия с пользователем (Windows 10)
• Пример нескольких представлений (Windows 10)
• Пример полноэкранного режима (Windows 10)
• Пример изменения размера окна (Windows 10)
• Пример заголовка строки (Windows 10)