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