Поделиться через


ApplicationView Класс

Определение

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

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
Атрибуты

Требования к 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 , как правило, в результате отображения или скрытия строки состояния, панели приложения или другого хрома.

Применяется к

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