SplitView Класс

Определение

Представляет контейнер с двумя представлениями; одно представление для содержимого main, а другое представление, которое обычно используется для команд навигации.

/// [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)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Content")]
class SplitView : Control
[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)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Content")]
public class SplitView : Control
Public Class SplitView
Inherits Control
<SplitView>
  <SplitView.Content>
    singleObject
  </SplitView.Content>
  <SplitView.Pane>
    singleObject
  </SplitView.Pane>
</SplitView>

Наследование
Атрибуты

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

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

Примеры

Совет

Дополнительные сведения, рекомендации по проектированию и примеры кода см. в разделе Разделенный режим.

Если у вас установлено приложение коллекции WinUI 2 , щелкните здесь, чтобы открыть приложение и увидеть SplitView в действии.

Ниже приведен элемент управления SplitView с открытой панелью , отображающейся рядом с элементом Содержимое.

<SplitView IsPaneOpen="True"
           DisplayMode="Inline"
           OpenPaneLength="296">
    <SplitView.Pane>
        <TextBlock Text="Pane"
                   FontSize="24"
                   VerticalAlignment="Center"
                   HorizontalAlignment="Center"/>
    </SplitView.Pane>

    <Grid>
        <TextBlock Text="Content"
                   FontSize="24"
                   VerticalAlignment="Center"
                   HorizontalAlignment="Center"/>
    </Grid>
</SplitView>

Комментарии

Совет

Дополнительные сведения, рекомендации по проектированию и примеры кода см. в разделе Разделенный режим.

Элемент управления SplitView представляет две области содержимого: область и содержимое main. Обычно splitView используется для создания интерфейса навигации верхнего уровня, который адаптируется к другой ширине экрана в соответствии с шаблоном панели навигации или шаблоном master/подробностей, но он не ограничивается только для навигации.

КОД XAML для этого SplitView показан в разделе Примеры.

Элемент управления

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

Существует несколько свойств, которые можно задать для управления внешним видом и поведением панели. Задайте свойство IsPaneOpen , чтобы открыть или закрыть панель. SplitView не включает встроенную возможность для пользователей переключать состояние панели, например кнопку меню (или "гамбургер"). Необходимо указать эту возможность и код для переключения свойства IsPaneOpen .

Чтобы указать длину открытой области, задайте свойство OpenPaneLength . Вы можете задать для свойства PanePlacement , чтобы область отображалась в левой или правой части содержимого.

Хотя внешний вид элемента управления в значительной степени зависит от элементов, назначенных панели и содержимому, вы можете изменить цвет фона по умолчанию панели , задав paneBackground.

Задайте свойство DisplayMode , чтобы настроить взаимодействие панели с контентом. По умолчанию область перекрывает содержимое и полностью исчезает при закрытии. Вы можете использовать один из "встроенных" режимов для отображения области рядом с контентом. Режимы сжатия можно использовать, чтобы узкий раздел области оставался видимым даже при закрытии панели . Дополнительные сведения о поддерживаемых режимах см. в перечислении SplitViewDisplayMode .

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

Версия Windows Версия пакета SDK Добавленная стоимость
1607 14393 LightDismissOverlayMode
1709 16299 ОбластьОткрытая
1709 16299 PaneOpening

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

SplitView()

Инициализирует новый экземпляр класса SplitView .

Свойства

AccessKey

Возвращает или задает ключ доступа (мнемонический) для этого элемента.

(Унаследовано от UIElement)
AccessKeyScopeOwner

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

(Унаследовано от UIElement)
ActualHeight

Возвращает отрисованную высоту объекта FrameworkElement. См. заметки.

(Унаследовано от FrameworkElement)
ActualOffset

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

(Унаследовано от UIElement)
ActualSize

Возвращает размер, вычисленный этим элементом UIElement во время упорядочения процесса макета.

(Унаследовано от UIElement)
ActualTheme

Возвращает тему пользовательского интерфейса, которая в настоящее время используется элементом , которая может отличаться от RequestedTheme.

(Унаследовано от FrameworkElement)
ActualWidth

Возвращает ширину отображаемого элемента FrameworkElement. См. заметки.

(Унаследовано от FrameworkElement)
AllowDrop

Возвращает или задает значение, определяющее, может ли этот элемент UIElement быть целевым объектом перетаскивания для операций перетаскивания.

(Унаследовано от UIElement)
AllowFocusOnInteraction

Возвращает или задает значение, указывающее, получает ли элемент автоматически фокус при взаимодействии с ним.

(Унаследовано от FrameworkElement)
AllowFocusWhenDisabled

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

(Унаследовано от FrameworkElement)
Background

Возвращает или задает кисть, которая предоставляет фон элемента управления .

(Унаследовано от Control)
BackgroundSizing

Возвращает или задает значение, указывающее, насколько далеко фон расширяется относительно границы этого элемента.

(Унаследовано от Control)
BaseUri

Возвращает универсальный код ресурса (URI), представляющий базовый универсальный код ресурса (URI) для созданного на языке XAML объекта во время загрузки XAML. Это свойство полезно для разрешения универсального кода ресурса (URI) во время выполнения.

(Унаследовано от FrameworkElement)
BorderBrush

Возвращает или задает кисть, описывающую заливку границы элемента управления.

(Унаследовано от Control)
BorderThickness

Возвращает или задает толщину границы элемента управления.

(Унаследовано от Control)
CacheMode

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

(Унаследовано от UIElement)
CanBeScrollAnchor

Возвращает или задает значение, указывающее, может ли UIElement быть кандидатом на привязку прокрутки.

(Унаследовано от UIElement)
CanDrag

Возвращает или задает значение, указывающее, можно ли перетаскивать элемент как данные в операции перетаскивания.

(Унаследовано от UIElement)
CenterPoint

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

(Унаследовано от UIElement)
CharacterSpacing

Возвращает или задает единый интервал между символами в единицах 1/1000 em.

(Унаследовано от Control)
Clip

Возвращает или задает объект RectangleGeometry, используемый для определения контура содержимого элемента UIElement.

(Унаследовано от UIElement)
CompactPaneLength

Возвращает или задает ширину панели SplitView в режиме компактного отображения.

CompactPaneLengthProperty

Определяет свойство зависимости CompactPaneLength .

CompositeMode

Возвращает или задает свойство, объявляющее альтернативные режимы композиции и смешивания для элемента в родительском макете и окне. Это относится к элементам, участвующим в смешанном пользовательском интерфейсе XAML/Microsoft DirectX.

(Унаследовано от UIElement)
Content

Возвращает или задает содержимое панели main Объекта SplitView.

ContentProperty

Идентифицирует свойство зависимости содержимого .

ContextFlyout

Возвращает или задает всплывающий элемент, связанный с этим элементом.

(Унаследовано от UIElement)
CornerRadius

Возвращает или задает радиус для углов границы элемента управления.

(Унаследовано от Control)
DataContext

Возвращает или задает контекст данных для Объекта FrameworkElement. Контекст данных часто используется, когда FrameworkElement использует расширение разметки {Binding} и участвует в привязке данных.

(Унаследовано от FrameworkElement)
DefaultStyleKey

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

(Унаследовано от Control)
DefaultStyleResourceUri

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

(Унаследовано от Control)
DesiredSize

Возвращает размер, вычисленный этим элементом UIElement во время прохождения меры процесса макета.

(Унаследовано от UIElement)
Dispatcher

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

(Унаследовано от DependencyObject)
DisplayMode

Возвращает значение, указывающее, как отображаются области области и содержимого Объекта SplitView .

DisplayModeProperty

Определяет свойство зависимости DisplayMode .

ElementSoundMode

Возвращает или задает значение, указывающее предпочтительное значение элемента управления для воспроизведения звуков.

(Унаследовано от Control)
ExitDisplayModeOnAccessKeyInvoked

Возвращает или задает значение, указывающее, закрывается ли отображение ключа доступа при вызове ключа доступа.

(Унаследовано от UIElement)
FlowDirection

Возвращает или задает направление потока текста и других элементов пользовательского интерфейса в любом родительском элементе, управляющего их макетом. Этому свойству можно задать значение LeftToRight или RightToLeft. Для параметра FlowDirection значение RightToLeft для любого элемента устанавливается выравнивание справа, порядок чтения — справа налево, а макет элемента управления — справа налево.

(Унаследовано от FrameworkElement)
FocusState

Возвращает значение, указывающее, имеет ли этот элемент управления фокус и режим, в котором был получен фокус.

(Унаследовано от Control)
FocusVisualMargin

Возвращает или задает внешнее поле визуального элемента фокуса для FrameworkElement.

(Унаследовано от FrameworkElement)
FocusVisualPrimaryBrush

Получает или задает кисть, используемую для рисования внешней границы визуального HighVisibility элемента или Reveal фокуса для FrameworkElement.

(Унаследовано от FrameworkElement)
FocusVisualPrimaryThickness

Возвращает или задает толщину внешней границы визуального элемента или Reveal фокуса HighVisibility для FrameworkElement.

(Унаследовано от FrameworkElement)
FocusVisualSecondaryBrush

Получает или задает кисть, используемую для рисования внутренней границы визуального HighVisibility элемента или Reveal фокуса для FrameworkElement.

(Унаследовано от FrameworkElement)
FocusVisualSecondaryThickness

Возвращает или задает толщину внутренней границы визуального элемента или Reveal фокуса HighVisibility для FrameworkElement.

(Унаследовано от FrameworkElement)
FontFamily

Возвращает или задает шрифт, используемый при отображении текста в элементе управления.

(Унаследовано от Control)
FontSize

Возвращает или задает размер текста в этом элементе управления.

(Унаследовано от Control)
FontStretch

Получение или установка межсимвольного интервала.

(Унаследовано от Control)
FontStyle

Возвращает или задает стиль, в котором отображается текст.

(Унаследовано от Control)
FontWeight

Возвращает или задает толщину указанного шрифта.

(Унаследовано от Control)
Foreground

Возвращает или задает кисть, которая описывает основной цвет.

(Унаследовано от Control)
Height

Возвращает или задает предполагаемую высоту элемента FrameworkElement.

(Унаследовано от FrameworkElement)
HighContrastAdjustment

Возвращает или задает значение, указывающее, настраивает ли платформа автоматически визуальные свойства элемента при включении тем с высокой контрастностью.

(Унаследовано от UIElement)
HorizontalAlignment

Возвращает или задает характеристики горизонтального выравнивания, применяемые к Объекту FrameworkElement при его создании в родительском элементе макета, например панели или элемента управления элементами.

(Унаследовано от FrameworkElement)
HorizontalContentAlignment

Возвращает или задает способ горизонтального выравнивания содержимого элемента управления.

(Унаследовано от Control)
IsAccessKeyScope

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

(Унаследовано от UIElement)
IsDoubleTapEnabled

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

(Унаследовано от UIElement)
IsEnabled

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

(Унаследовано от Control)
IsFocusEngaged

Получает или задает значение, указывающее, ограничен ли фокус в границах элемента управления (для игровой площадки или удаленного взаимодействия).

(Унаследовано от Control)
IsFocusEngagementEnabled

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

(Унаследовано от Control)
IsHitTestVisible

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

(Унаследовано от UIElement)
IsHoldingEnabled

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

(Унаследовано от UIElement)
IsLoaded

Возвращает значение, указывающее, был ли элемент добавлен в дерево элементов и готов ли он к взаимодействию.

(Унаследовано от FrameworkElement)
IsPaneOpen

Возвращает или задает значение, указывающее, развернута ли область SplitView до полной ширины.

IsPaneOpenProperty

Определяет свойство зависимости IsPaneOpen .

IsRightTapEnabled

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

(Унаследовано от UIElement)
IsTabStop

Возвращает или задает значение, показывающее, включается ли элемент управления в переходы по ТАВ.

(Унаследовано от Control)
IsTapEnabled

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

(Унаследовано от UIElement)
IsTextScaleFactorEnabled

Возвращает или задает значение, указывающее, включено ли автоматическое увеличение текста в соответствии с параметром системного размера текста.

(Унаследовано от Control)
KeyboardAcceleratorPlacementMode

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

(Унаследовано от UIElement)
KeyboardAcceleratorPlacementTarget

Возвращает или задает значение, указывающее подсказку элемента управления, отображающую сочетание клавиш ускорителя.

(Унаследовано от UIElement)
KeyboardAccelerators

Возвращает коллекцию сочетаний клавиш, которые вызывают действие с помощью клавиатуры.

Ускорители обычно назначаются кнопкам или пунктам меню.

Пример меню, в котором показаны сочетания клавиш для различных пунктов меню
Пример меню, в котором показаны сочетания клавиш для различных пунктов меню

(Унаследовано от UIElement)
KeyTipHorizontalOffset

Возвращает или задает значение, указывающее, насколько далеко слева или справа находится подсказка клавиши относительно UIElement.

(Унаследовано от UIElement)
KeyTipPlacementMode

Возвращает или задает значение, указывающее, где находится подсказка клавиши доступа относительно границы UIElement.

(Унаследовано от UIElement)
KeyTipTarget

Возвращает или задает значение, указывающее элемент, на который нацелена подсказка клавиши доступа.

(Унаследовано от UIElement)
KeyTipVerticalOffset

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

(Унаследовано от UIElement)
Language

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

(Унаследовано от FrameworkElement)
LightDismissOverlayMode

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

LightDismissOverlayModeProperty

Определяет свойство зависимости LightDismissOverlayMode .

Lights

Возвращает коллекцию объектов XamlLight, присоединенных к этому элементу.

(Унаследовано от UIElement)
ManipulationMode

Возвращает или задает значение ManipulationModes , используемое для поведения UIElement и взаимодействия с жестами. Установка этого значения позволяет обрабатывать события манипуляции из этого элемента в коде приложения.

(Унаследовано от UIElement)
Margin

Возвращает или задает внешнее поле объекта FrameworkElement.

(Унаследовано от FrameworkElement)
MaxHeight

Возвращает или задает ограничение максимальной высоты объекта FrameworkElement.

(Унаследовано от FrameworkElement)
MaxWidth

Возвращает или задает ограничение максимальной ширины объекта FrameworkElement.

(Унаследовано от FrameworkElement)
MinHeight

Возвращает или задает ограничение минимальной высоты объекта FrameworkElement.

(Унаследовано от FrameworkElement)
MinWidth

Возвращает или задает ограничение минимальной ширины элемента FrameworkElement.

(Унаследовано от FrameworkElement)
Name

Возвращает или задает идентифицирующие имя объекта. Когда обработчик XAML создает дерево объектов из разметки XAML, код времени выполнения может ссылаться на объект, объявленный XAML, по этому имени.

(Унаследовано от FrameworkElement)
Opacity

Возвращает или задает степень непрозрачности объекта.

(Унаследовано от UIElement)
OpacityTransition

Возвращает или задает ScalarTransition, который анимирует изменения в свойстве Opacity.

(Унаследовано от UIElement)
OpenPaneLength

Возвращает или задает ширину области SplitView при ее полном развертывании.

OpenPaneLengthProperty

Определяет свойство зависимости OpenPaneLength .

Padding

Получение или установка отбивки внутри элемента управления.

(Унаследовано от Control)
Pane

Возвращает или задает содержимое панели Объекта SplitView.

PaneBackground

Возвращает или задает кисть , применяемую к фону области Область элемента управления.

PaneBackgroundProperty

Определяет свойство зависимости PaneBackground .

PanePlacement

Возвращает или задает значение, указывающее, отображается ли панель в правой или левой части Объекта SplitView.

PanePlacementProperty

Определяет свойство зависимости PanePlacement .

PaneProperty

Идентифицирует свойство зависимости Pane .

Parent

Возвращает родительский объект этого объекта FrameworkElement в дереве объектов.

(Унаследовано от FrameworkElement)
PointerCaptures

Возвращает набор всех захваченных указателей, представленных в виде значений указателя .

(Унаследовано от UIElement)
Projection

Возвращает или задает проекцию перспективы (трехмерный эффект), применяемую при отрисовке этого элемента.

(Унаследовано от UIElement)
RenderSize

Возвращает окончательный размер отрисовки элемента UIElement. Использовать не рекомендуется. См. примечания.

(Унаследовано от UIElement)
RenderTransform

Возвращает или задает сведения о преобразовании, влияющие на положение отрисовки элемента UIElement.

(Унаследовано от UIElement)
RenderTransformOrigin

Возвращает или задает точку начала любого возможного преобразования отрисовки, объявленного RenderTransform, относительно границ UIElement.

(Унаследовано от UIElement)
RequestedTheme

Возвращает или задает тему пользовательского интерфейса, используемую uiElement (и его дочерними элементами) для определения ресурса. Тема пользовательского интерфейса, указанная в параметре RequestedTheme, может переопределить requestedTheme на уровне приложения.

(Унаследовано от FrameworkElement)
RequiresPointer

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

(Унаследовано от Control)
Resources

Возвращает локально определенный словарь ресурсов. В XAML элементы ресурсов можно установить в качестве дочерних элементов объекта элемента свойства с помощью синтаксиса frameworkElement.Resources неявной коллекции XAML.

(Унаследовано от FrameworkElement)
Rotation

Возвращает или задает угол поворота по часовой стрелке в градусах. Поворачивается относительно RotationAxis и CenterPoint. Влияет на позицию отрисовки элемента.

(Унаследовано от UIElement)
RotationAxis

Возвращает или задает ось для поворота элемента.

(Унаследовано от UIElement)
RotationTransition

Возвращает или задает scalarTransition, который анимирует изменения свойства Rotation.

(Унаследовано от UIElement)
Scale

Возвращает или задает масштаб элемента. Масштабируется относительно Элемента CenterPoint. Влияет на позицию отрисовки элемента.

(Унаследовано от UIElement)
ScaleTransition

Возвращает или задает Vector3Transition, который анимирует изменения в свойстве Scale.

(Унаследовано от UIElement)
Shadow

Возвращает или задает эффект тени, приведение к элементу .

(Унаследовано от UIElement)
Style

Возвращает или задает стиль экземпляра, который применяется к этому объекту во время макета и отрисовки.

(Унаследовано от FrameworkElement)
TabFocusNavigation

Возвращает или задает значение, изменяющее работу tabbing и TabIndex для этого элемента управления.

(Унаследовано от UIElement)
TabIndex

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

(Унаследовано от Control)
TabNavigation

Возвращает или задает значение, изменяющее работу tabbing и TabIndex для этого элемента управления.

Примечание

Для Windows 10 Creators Update (сборка 10.0.15063) и более поздней версии свойство TabFocusNavigation доступно в базовом классе UIElement для включения объектов в последовательность вкладок, не использующих ControlTemplate.

(Унаследовано от Control)
Tag

Возвращает или задает произвольное значение объекта, которое можно использовать для хранения пользовательских сведений об этом объекте.

(Унаследовано от FrameworkElement)
Template

Получает или задает шаблон элемента управления. Шаблон элемента управления определяет внешний вид элемента управления в пользовательском интерфейсе и определяется в разметке XAML.

(Унаследовано от Control)
TemplateSettings

Возвращает объект , предоставляющий вычисляемые значения, на которые можно ссылаться как на источники TemplateBinding при определении шаблонов для элемента управления SplitView .

TemplateSettingsProperty

Определяет свойство зависимости TemplateSettings .

Transform3D

Возвращает или задает эффект трехмерного преобразования, применяемый при отрисовке этого элемента.

(Унаследовано от UIElement)
TransformMatrix

Возвращает или задает матрицу преобразования, применяемую к элементу .

(Унаследовано от UIElement)
Transitions

Возвращает или задает коллекцию элементов стиля перехода , применяемых к UIElement.

(Унаследовано от UIElement)
Translation

Возвращает или задает положение отрисовки x, y и z элемента.

(Унаследовано от UIElement)
TranslationTransition

Возвращает или задает Vector3Transition, который анимирует изменения свойства Translation.

(Унаследовано от UIElement)
Triggers

Возвращает коллекцию триггеров для анимаций, определенных для FrameworkElement. Не часто используется. См. заметки.

(Унаследовано от FrameworkElement)
UIContext

Возвращает идентификатор контекста для элемента.

(Унаследовано от UIElement)
UseLayoutRounding

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

(Унаследовано от UIElement)
UseSystemFocusVisuals

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

(Унаследовано от Control)
VerticalAlignment

Возвращает или задает характеристики вертикального выравнивания, применяемые к Объекту FrameworkElement при его создании в родительском объекте, например панели или элемента управления элементами.

(Унаследовано от FrameworkElement)
VerticalContentAlignment

Возвращает или задает способ вертикального выравнивания содержимого элемента управления.

(Унаследовано от Control)
Visibility

Возвращает или задает видимость объекта UIElement. Невидимый элемент UIElement не отображается и не передает нужный размер макету.

(Унаследовано от UIElement)
Width

Возвращает или задает ширину элемента FrameworkElement.

(Унаследовано от FrameworkElement)
XamlRoot

Возвращает или задает объект , XamlRoot в котором просматривается данный элемент.

(Унаследовано от UIElement)
XYFocusDown

Возвращает или задает объект, который получает фокус при нажатии пользователем направленной панели (D-pad) вниз.

(Унаследовано от Control)
XYFocusDownNavigationStrategy

Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации вниз.

(Унаследовано от UIElement)
XYFocusKeyboardNavigation

Возвращает или задает значение, которое включает или отключает навигацию с помощью стрелков с помощью клавиатуры.

(Унаследовано от UIElement)
XYFocusLeft

Возвращает или задает объект, который получает фокус при нажатии пользователем направленной панели (D-pad) влево.

(Унаследовано от Control)
XYFocusLeftNavigationStrategy

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

(Унаследовано от UIElement)
XYFocusRight

Возвращает или задает объект, который получает фокус при нажатии пользователем направленной панели (D-pad) вправо.

(Унаследовано от Control)
XYFocusRightNavigationStrategy

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

(Унаследовано от UIElement)
XYFocusUp

Возвращает или задает объект, который получает фокус при нажатии пользователем направленной панели (D-pad).

(Унаследовано от Control)
XYFocusUpNavigationStrategy

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

(Унаследовано от UIElement)

Методы

AddHandler(RoutedEvent, Object, Boolean)

Добавляет обработчик перенаправленного события для указанного перенаправленного события, помещая этот обработчик в коллекцию обработчиков текущего элемента. Укажите значение handledEventsTooкак true , чтобы вызвать предоставленный обработчик, даже если событие обрабатывается в другом месте.

(Унаследовано от UIElement)
ApplyTemplate()

Загружает соответствующий шаблон элемента управления, чтобы можно было ссылаться на его части.

(Унаследовано от Control)
Arrange(Rect)

Размещает дочерние объекты и определяет размер элемента UIElement. Родительские объекты, реализующие пользовательский макет для своих дочерних элементов, должны вызывать этот метод из реализаций переопределения макета, чтобы сформировать рекурсивное обновление макета.

(Унаследовано от UIElement)
ArrangeOverride(Size)

Предоставляет поведение для прохода "Упорядочить" макета. Классы могут переопределить этот метод, чтобы определить собственное поведение передачи "Упорядочить".

(Унаследовано от FrameworkElement)
CancelDirectManipulations()

Отменяет текущую обработку прямых манипуляций (определяемое системой сдвиг или масштабирование) в любом родительском элементе ScrollViewer , содержающем текущий элемент UIElement.

(Унаследовано от UIElement)
CapturePointer(Pointer)

Задает запись указателя на uiElement. После захвата события, связанные с указателем, будут запускаться только элемент, имеющий запись.

(Унаследовано от UIElement)
ClearValue(DependencyProperty)

Очищает локальное значение свойства зависимостей.

(Унаследовано от DependencyObject)
FindName(String)

Извлекает объект с указанным именем идентификатора.

(Унаследовано от FrameworkElement)
FindSubElementsForTouchTargeting(Point, Rect)

Позволяет подклассу UIElement предоставлять дочерние элементы, помогающие в разрешении сенсорного нацеливания.

(Унаследовано от UIElement)
Focus(FocusState)

Пытается установить фокус на элементе управления.

(Унаследовано от Control)
GetAnimationBaseValue(DependencyProperty)

Возвращает любое базовое значение, установленное для свойства зависимостей, которое применяется в случаях, когда анимация не активна.

(Унаследовано от DependencyObject)
GetBindingExpression(DependencyProperty)

Возвращает BindingExpression , представляющее привязку к указанному свойству.

(Унаследовано от FrameworkElement)
GetChildrenInTabFocusOrder()

Позволяет подклассу UIElement предоставлять дочерние элементы, которые принимают участие в фокусе tab.

(Унаследовано от UIElement)
GetTemplateChild(String)

Извлекает именованный элемент в визуальном дереве ControlTemplate , созданном экземпляром.

(Унаследовано от Control)
GetValue(DependencyProperty)

Возвращает текущее действующее значение свойства зависимостей из DependencyObject.

(Унаследовано от DependencyObject)
GoToElementStateCore(String, Boolean)

При реализации в производном классе включает создание визуального дерева для каждого состояния для шаблона элемента управления в коде, а не путем загрузки XAML для всех состояний при запуске элемента управления.

(Унаследовано от FrameworkElement)
InvalidateArrange()

Делает недействительным состояние упорядочения (макет) для UIElement. После аннулирования макет UIElement будет обновлен, что будет происходить асинхронно.

(Унаследовано от UIElement)
InvalidateMeasure()

Делает недействительным состояние измерения (макет) для элемента UIElement.

(Унаследовано от UIElement)
InvalidateViewport()

Делает недействительным состояние окна просмотра для UIElement , используемого для вычисления действующего окна просмотра.

(Унаследовано от FrameworkElement)
Measure(Size)

Обновления DesiredSizeэлемента UIElement. Как правило, объекты, реализующие пользовательский макет для дочерних элементов макета, вызывают этот метод из собственных реализаций MeasureOverride , чтобы сформировать рекурсивное обновление макета.

(Унаследовано от UIElement)
MeasureOverride(Size)

Обеспечивает поведение для прохода "Measure" цикла макета. Классы могут переопределить этот метод, чтобы определить собственное поведение передачи "Measure".

(Унаследовано от FrameworkElement)
OnApplyTemplate()

Вызывается всякий раз, когда код приложения или внутренние процессы (такие как перестроение передачи макета) вызывают Метод ApplyTemplate. Проще говоря, это означает, что метод вызывается непосредственно перед отображением элемента пользовательского интерфейса в приложении. Переопределите этот метод, чтобы повлиять на логику post-template по умолчанию класса.

(Унаследовано от FrameworkElement)
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)

Вызывается перед событием BringIntoViewRequested .

(Унаследовано от UIElement)
OnCharacterReceived(CharacterReceivedRoutedEventArgs)

Вызывается перед событием CharacterReceived .

(Унаследовано от Control)
OnCreateAutomationPeer()

При реализации в производном классе возвращает реализации AutomationPeer для конкретного класса для инфраструктуры Microsoft модель автоматизации пользовательского интерфейса.

(Унаследовано от UIElement)
OnDisconnectVisualChildren()

Переопределите этот метод, чтобы реализовать поведение макета и логики при удалении элементов из свойства содержимого или дочерних элементов класса.

(Унаследовано от UIElement)
OnDoubleTapped(DoubleTappedRoutedEventArgs)

Вызывается перед событием DoubleTapped .

(Унаследовано от Control)
OnDragEnter(DragEventArgs)

Вызывается перед событием DragEnter .

(Унаследовано от Control)
OnDragLeave(DragEventArgs)

Вызывается перед событием DragLeave .

(Унаследовано от Control)
OnDragOver(DragEventArgs)

Вызывается перед событием DragOver .

(Унаследовано от Control)
OnDrop(DragEventArgs)

Вызывается перед событием Drop .

(Унаследовано от Control)
OnGotFocus(RoutedEventArgs)

Вызывается перед событием GotFocus .

(Унаследовано от Control)
OnHolding(HoldingRoutedEventArgs)

Вызывается перед событием Holding .

(Унаследовано от Control)
OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs)

Вызывается при обработке сочетания клавиш (или ускорителя) в приложении. Переопределите этот метод для обработки реакции приложения при вызове ускорителя клавиатуры.

(Унаследовано от UIElement)
OnKeyDown(KeyRoutedEventArgs)

Вызывается перед событием KeyDown .

(Унаследовано от Control)
OnKeyUp(KeyRoutedEventArgs)

Вызывается перед событием KeyUp .

(Унаследовано от Control)
OnLostFocus(RoutedEventArgs)

Вызывается перед событием LostFocus .

(Унаследовано от Control)
OnManipulationCompleted(ManipulationCompletedRoutedEventArgs)

Вызывается перед событием ManipulationCompleted .

(Унаследовано от Control)
OnManipulationDelta(ManipulationDeltaRoutedEventArgs)

Вызывается перед событием ManipulationDelta .

(Унаследовано от Control)
OnManipulationInertiaStarting(ManipulationInertiaStartingRoutedEventArgs)

Вызывается перед событием ManipulationInertiaStarting .

(Унаследовано от Control)
OnManipulationStarted(ManipulationStartedRoutedEventArgs)

Вызывается перед событием ManipulationStarted .

(Унаследовано от Control)
OnManipulationStarting(ManipulationStartingRoutedEventArgs)

Вызывается перед событием ManipulationStarting .

(Унаследовано от Control)
OnPointerCanceled(PointerRoutedEventArgs)

Вызывается перед событием PointerCanceled .

(Унаследовано от Control)
OnPointerCaptureLost(PointerRoutedEventArgs)

Вызывается перед событием PointerCaptureLost .

(Унаследовано от Control)
OnPointerEntered(PointerRoutedEventArgs)

Вызывается перед событием PointerEntered .

(Унаследовано от Control)
OnPointerExited(PointerRoutedEventArgs)

Вызывается перед событием PointerExited .

(Унаследовано от Control)
OnPointerMoved(PointerRoutedEventArgs)

Вызывается перед событием PointerMoved .

(Унаследовано от Control)
OnPointerPressed(PointerRoutedEventArgs)

Вызывается перед событием PointerPressed .

(Унаследовано от Control)
OnPointerReleased(PointerRoutedEventArgs)

Вызывается перед событием PointerReleased .

(Унаследовано от Control)
OnPointerWheelChanged(PointerRoutedEventArgs)

Вызывается перед событием PointerWheelChanged .

(Унаследовано от Control)
OnPreviewKeyDown(KeyRoutedEventArgs)

Вызывается перед событием PreviewKeyDown .

(Унаследовано от Control)
OnPreviewKeyUp(KeyRoutedEventArgs)

Вызывается перед событием PreviewKeyUp .

(Унаследовано от Control)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)

Вызывается непосредственно перед обработкой сочетания клавиш (или ускорителя) в приложении. Вызывается всякий раз, когда код приложения или внутренние процессы вызывают ProcessKeyboardAccelerators. Переопределите этот метод, чтобы повлиять на обработку ускорителя по умолчанию.

(Унаследовано от UIElement)
OnRightTapped(RightTappedRoutedEventArgs)

Вызывается перед событием RightTapped .

(Унаследовано от Control)
OnTapped(TappedRoutedEventArgs)

Вызывается перед событием Tapped .

(Унаследовано от Control)
PopulatePropertyInfo(String, AnimationPropertyInfo)

Определяет свойство, которое можно анимировать.

(Унаследовано от UIElement)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)

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

(Унаследовано от UIElement)
ReadLocalValue(DependencyProperty)

Возвращает локальное значение свойства зависимостей, если задано локальное значение.

(Унаследовано от DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Регистрирует функцию уведомления для прослушивания изменений определенной DependencyProperty в этом экземпляре DependencyObject .

(Унаследовано от DependencyObject)
ReleasePointerCapture(Pointer)

Освобождает записи указателя для захвата одного конкретного указателя данным элементом UIElement.

(Унаследовано от UIElement)
ReleasePointerCaptures()

Освобождает все записи указателей, хранящиеся в этом элементе.

(Унаследовано от UIElement)
RemoveFocusEngagement()

Освобождает фокус от границ элемента управления для элемента управления с фокусом (для игровой панели или удаленного взаимодействия).

(Унаследовано от Control)
RemoveHandler(RoutedEvent, Object)

Удаляет указанный обработчик перенаправленных событий из этого элемента UIElement. Как правило, рассматриваемый обработчик был добавлен с помощью AddHandler.

(Унаследовано от UIElement)
SetBinding(DependencyProperty, BindingBase)

Присоединяет привязку к Объекту FrameworkElement с помощью предоставленного объекта привязки.

(Унаследовано от FrameworkElement)
SetValue(DependencyProperty, Object)

Задает локальное значение свойства зависимостей для Объекта DependencyObject.

(Унаследовано от DependencyObject)
StartAnimation(ICompositionAnimationBase)

Начинает указанную анимацию элемента.

(Унаследовано от UIElement)
StartBringIntoView()

Инициирует запрос к платформе XAML для представления элемента в любых прокручиваемых областях, в которые он содержится.

(Унаследовано от UIElement)
StartBringIntoView(BringIntoViewOptions)

Инициирует запрос к платформе XAML для вывода элемента в представление с помощью указанных параметров.

(Унаследовано от UIElement)
StartDragAsync(PointerPoint)

Инициирует операцию перетаскивания.

(Унаследовано от UIElement)
StopAnimation(ICompositionAnimationBase)

Останавливает указанную анимацию в элементе .

(Унаследовано от UIElement)
TransformToVisual(UIElement)

Возвращает объект преобразования, который можно использовать для преобразования координат из UIElement в указанный объект.

(Унаследовано от UIElement)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)

Пытается вызвать сочетание клавиш (или ускоритель), выполнив поиск сочетания клавиш во всем визуальном дереве UIElement.

(Унаследовано от UIElement)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Отменяет уведомление об изменениях, которое было ранее зарегистрировано путем вызова метода RegisterPropertyChangedCallback.

(Унаследовано от DependencyObject)
UpdateLayout()

Обеспечивает правильное обновление всех положений дочерних объектов UIElement для макета.

(Унаследовано от UIElement)

События

AccessKeyDisplayDismissed

Происходит, когда ключи доступа больше не должны отображаться.

(Унаследовано от UIElement)
AccessKeyDisplayRequested

Происходит, когда пользователь запрашивает отображение ключей доступа.

(Унаследовано от UIElement)
AccessKeyInvoked

Происходит, когда пользователь завершает последовательность ключей доступа.

(Унаследовано от UIElement)
ActualThemeChanged

Происходит при изменении значения свойства ActualTheme.

(Унаследовано от FrameworkElement)
BringIntoViewRequested

Происходит при вызове StartBringIntoView для этого элемента или одного из его потомков.

(Унаследовано от UIElement)
CharacterReceived

Происходит при получении одного составного символа входной очередью.

(Унаследовано от UIElement)
ContextCanceled

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

(Унаследовано от UIElement)
ContextRequested

Происходит, когда пользователь завершил жест ввода контекста, например щелчок правой кнопкой мыши.

(Унаследовано от UIElement)
DataContextChanged

Происходит при изменении значения свойства FrameworkElement.DataContext .

(Унаследовано от FrameworkElement)
DoubleTapped

Происходит, когда необработанное в противном случае взаимодействие DoubleTap происходит над областью проверки попадания этого элемента.

(Унаследовано от UIElement)
DragEnter

Происходит, когда система ввода сообщает о базовом событии перетаскивания с этим элементом в качестве целевого объекта.

(Унаследовано от UIElement)
DragLeave

Происходит, когда система ввода сообщает о базовом событии перетаскивания с этим элементом в качестве источника.

(Унаследовано от UIElement)
DragOver

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

(Унаследовано от UIElement)
DragStarting

Происходит при инициации операции перетаскивания.

(Унаследовано от UIElement)
Drop

Происходит, когда система ввода сообщает о базовом событии удаления с этим элементом в качестве цели удаления.

(Унаследовано от UIElement)
DropCompleted

Происходит при завершении операции перетаскивания с этим элементом в качестве источника.

(Унаследовано от UIElement)
EffectiveViewportChanged

Происходит при изменении действующего окна просмотраFrameworkElement.

(Унаследовано от FrameworkElement)
FocusDisengaged

Происходит при освобождении фокуса от границ элемента управления (для игровой площадки или удаленного взаимодействия).

(Унаследовано от Control)
FocusEngaged

Происходит, когда фокус ограничен в пределах границ элемента управления (для игровой площадки или удаленного взаимодействия).

(Унаследовано от Control)
GettingFocus

Происходит до того, как элемент UIElement получит фокус. Это событие создается синхронно, чтобы фокус не перемещался во время восходящего события.

(Унаследовано от UIElement)
GotFocus

Происходит, когда элемент UIElement получает фокус. Это событие возникает асинхронно, поэтому фокус может снова переместиться до завершения восходящего движения.

(Унаследовано от UIElement)
Holding

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

(Унаследовано от UIElement)
IsEnabledChanged

Происходит при изменении свойства IsEnabled .

(Унаследовано от Control)
KeyDown

Происходит при нажатии клавиши клавиатуры, когда элемент UIElement находится в фокусе.

(Унаследовано от UIElement)
KeyUp

Происходит при отпускание клавиши клавиатуры, когда элемент UIElement находится в фокусе.

(Унаследовано от UIElement)
LayoutUpdated

Происходит при изменении макета визуального дерева из-за изменения значения свойств, относящихся к макету, или другого действия, которое обновляет макет.

(Унаследовано от FrameworkElement)
Loaded

Происходит, когда FrameworkElement был создан и добавлен в дерево объектов и готов к взаимодействию.

(Унаследовано от FrameworkElement)
Loading

Происходит, когда FrameworkElement начинает загружаться.

(Унаследовано от FrameworkElement)
LosingFocus

Происходит до того, как элемент UIElement теряет фокус. Это событие создается синхронно, чтобы фокус не перемещался во время восходящего события.

(Унаследовано от UIElement)
LostFocus

Происходит, когда элемент UIElement теряет фокус. Это событие возникает асинхронно, поэтому фокус может снова переместиться до завершения восходящего движения.

(Унаследовано от UIElement)
ManipulationCompleted

Происходит после завершения манипуляции с UIElement .

(Унаследовано от UIElement)
ManipulationDelta

Происходит, когда устройство ввода меняет положение в процессе манипуляции.

(Унаследовано от UIElement)
ManipulationInertiaStarting

Происходит, если во время манипуляции устройство ввода теряет контакт с объектом UIElement и начинает действовать инерция.

(Унаследовано от UIElement)
ManipulationStarted

Происходит, когда устройство ввода начинает манипуляцию над UIElement.

(Унаследовано от UIElement)
ManipulationStarting

Происходит при первоначальном создании процессора манипулирования.

(Унаследовано от UIElement)
NoFocusCandidateFound

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

(Унаследовано от UIElement)
PaneClosed

Происходит при закрытии области SplitView .

PaneClosing

Происходит при закрытии области SplitView .

PaneOpened

Происходит при открытии области SplitView .

PaneOpening

Происходит при открытии панели SplitView .

PointerCanceled

Происходит, когда указатель, создающий контакт, теряет контакт.

(Унаследовано от UIElement)
PointerCaptureLost

Происходит, когда захват указателя, ранее удерживаемый этим элементом, перемещается в другой элемент или в другое место.

(Унаследовано от UIElement)
PointerEntered

Происходит, когда указатель входит в область проверки попадания этого элемента.

(Унаследовано от UIElement)
PointerExited

Происходит, когда указатель покидает область проверки попадания этого элемента.

(Унаследовано от UIElement)
PointerMoved

Происходит при перемещении указателя, в то время как указатель остается в области проверки попадания этого элемента.

(Унаследовано от UIElement)
PointerPressed

Происходит, когда указатель инициирует действие Нажатие в этом элементе.

(Унаследовано от UIElement)
PointerReleased

Происходит при освобождении устройства указателя, которое ранее инициировало действие Нажатие , в этом элементе. Обратите внимание, что окончание действия Нажатие не гарантирует срабатывание события PointerReleased. Вместо этого могут возникать другие события. Дополнительные сведения см. в разделе Примечания.

(Унаследовано от UIElement)
PointerWheelChanged

Происходит при изменении разностного значения колесика указателя.

(Унаследовано от UIElement)
PreviewKeyDown

Происходит при нажатии клавиши клавиатуры, когда элемент UIElement находится в фокусе.

(Унаследовано от UIElement)
PreviewKeyUp

Происходит при отпускание клавиши клавиатуры, когда элемент UIElement находится в фокусе.

(Унаследовано от UIElement)
ProcessKeyboardAccelerators

Происходит при нажатии сочетания клавиш (или сочетания клавиш).

(Унаследовано от UIElement)
RightTapped

Возникает при возникновении стимула ввода правой кнопкой касания, когда указатель находится над элементом.

(Унаследовано от UIElement)
SizeChanged

Происходит при изменении значения свойства ActualHeight или ActualWidth в FrameworkElement.

(Унаследовано от FrameworkElement)
Tapped

Происходит, когда в противном случае происходит необработанное взаимодействие с касанием в области проверки попадания этого элемента.

(Унаследовано от UIElement)
Unloaded

Происходит, когда этот объект больше не подключен к дереву объектов main.

(Унаследовано от FrameworkElement)

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

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