RelativePanel Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет область, в которой можно размещать и выравнивать дочерние объекты по отношению друг к другу или родительской панели.
/// [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 RelativePanel : Panel[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 class RelativePanel : PanelPublic Class RelativePanel
Inherits Panel<RelativePanel ...>
oneOrMoreUIElements
</RelativePanel>
-or-
<RelativePanel .../>
- Наследование
- Атрибуты
Требования к Windows
| Семейство устройств |
Windows 10 (появилось в 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (появилось в v1.0)
|
Примеры
Кончик
Дополнительные сведения, рекомендации по проектированию и примеры кода см. в панелях макета.
Если у вас установлено приложение
Комментарии
RelativePanel — это контейнер макета, полезный для создания пользовательского интерфейса, который не имеет четкого линейного шаблона; То есть макеты, которые не находятся в основном в виде стека, упакованы или табличны, где можно естественно использовать StackPanel или Grid.
Если пользовательский интерфейс состоит из нескольких вложенных панелей, ОтносительнаяPanel является хорошим вариантом для рассмотрения.
Ниже приведен пример пользовательского интерфейса с помощью RelativePanel для его макета:
<RelativePanel BorderBrush="Gray" BorderThickness="10">
<Rectangle x:Name="RedRect" Fill="Red" MinHeight="100" MinWidth="100"/>
<Rectangle x:Name="BlueRect" Fill="Blue" MinHeight="100" MinWidth="100"
RelativePanel.RightOf="RedRect"/>
<!-- Width is not set on the green and yellow rectangles.
It's determined by the RelativePanel properties. -->
<Rectangle x:Name="GreenRect" Fill="Green" MinHeight="100" Margin="0,5,0,0"
RelativePanel.Below="RedRect"
RelativePanel.AlignLeftWith="RedRect"
RelativePanel.AlignRightWith="BlueRect"/>
<Rectangle Fill="Yellow" MinHeight="100"
RelativePanel.Below="GreenRect"
RelativePanel.AlignLeftWith="BlueRect"
RelativePanel.AlignRightWithPanel="True"/>
</RelativePanel>
RelativePanel, используемый в сочетании с AdaptiveTrigger s, может быть мощным инструментом для создания адаптивного пользовательского интерфейса, который масштабируется хорошо по разным размерам экрана. Дополнительные примеры см. в примере адаптивных методов XAML.
Позиция по умолчанию
По умолчанию любой необъявленный элемент, объявленный как дочерний элемент RelativePanel, получает все доступное пространство и размещается в координатах (0, 0) (верхний левый угол) панели. Таким образом, если вы размещаете второй элемент относительно неограниченного элемента, помните, что второй элемент может быть отправлен из панели.
В этом примере RectA не имеет ограничений, поэтому он расположен в (0,0).
RectB не отображается на экране, так как он объявлен вышеRectA и поэтому выводится из панели.
<RelativePanel>
<Rectangle Name="RectA" Fill="Red" Height="40" Width="40"/>
<Rectangle Name="RectB" Fill="Blue" Height="40" Width="40"
RelativePanel.Above="RectA"/>
</RelativePanel>
Циклическая зависимость
Циклическая зависимость возникает, когда два элемента внутри RelativePanel объявляют связи друг с другом в любом направлении. Например, этот КОД XAML приводит к исключению во время разработки "Ошибка RelativePanel: обнаружена циклическая зависимость. Макет не удалось завершить".
<RelativePanel>
<Rectangle Name="RectA" Fill="Red" Height="40" Width="40"
RelativePanel.Above="RectB"/>
<Rectangle Name="RectB" Fill="Blue" Height="40" Width="40"
RelativePanel.Below="RectA"/>
</RelativePanel>
Конфликтующие связи
Если задать несколько связей, предназначенных для одного края элемента, в макете могут возникнуть конфликтующие связи. В этом случае отношения применяются в следующем порядке приоритета:
- Отношения выравнивания панели (AlignTopWithPanel, AlignLeftWithPanel, ...) применяются сначала.
- Связи выравнивания с братом (AlignTopWith, AlignLeftWith, ...) применяются второе.
- Отношения с позициональными элементами (выше, ниже, RightOf, LeftOf) применяются последним.
Свойства выравнивания по центру панели (AlignVerticalCenterWith, AlignHorizontalCenterWithPanel, ...) обычно используются независимо от других ограничений и применяются, если конфликт отсутствует.
Свойства HorizontalAlignment и VerticalAlignment для элементов пользовательского интерфейса применяются после оценки и применения свойств связи. Эти свойства управляют размещением элемента в доступном размере элемента, если нужный размер меньше размера.
Свойства границы
RelativePanel определяет свойства границы, позволяющие нарисовать границу вокруг RelativePanel без использования дополнительного элемента Border. Свойства RelativePanel.BorderBrush, RelativePanel.BorderThickness, RelativePanel.CornerRadiusи RelativePanel.Padding.
<RelativePanel BorderBrush="Red" BorderThickness="2" CornerRadius="10" Padding="12">
<TextBox x:Name="textBox1" RelativePanel.AlignLeftWithPanel="True"/>
<Button Content="Submit" RelativePanel.Below="textBox1"/>
</RelativePanel>
Присоединенные свойства XAML
RelativePanel — это класс службы узла для нескольких присоединенных свойств XAML
Для поддержки доступа процессора XAML к присоединенным свойствам, а также для предоставления эквивалентных получения и задания операций с кодом, каждое присоединенное свойство XAML имеет пару методов доступа Get и Set. Другой способ получить или задать значение в коде — использовать систему свойств зависимостей, вызывая GetValue или SetValue и передав поле идентификатора в качестве идентификатора свойства зависимостей.
| Присоединенное свойство | Описание |
|---|---|
| выше | Возвращает или задает целевой элемент, расположенный над этим элементом. |
| AlignBottomWith | Возвращает или задает целевой элемент, с которым выравнивается нижний край этого элемента. |
| AlignBottomWithPanel | Возвращает или задает значение, указывающее, касается ли нижнего края этого элемента нижнего края панели. |
| AlignHorizontalCenterWith | Возвращает или задает целевой элемент, с которым выровнен горизонтальный центр этого элемента. |
| AlignHorizontalCenterWithPanel | Возвращает или задает значение, указывающее, касается ли горизонтальная ось этого элемента, касающаяся горизонтальной оси панели. |
| AlignLeftWith | Возвращает или задает целевой элемент, с которым выравнивается левый край этого элемента. |
| AlignLeftWithPanel | Получает или задает значение, указывающее, касается ли левый край этого элемента левого края панели. |
| AlignRightWith | Возвращает или задает целевой элемент, с которым выравнивается правый край этого элемента. |
| AlignRightWithPanel | Возвращает или задает значение, указывающее, касается ли правый край этого элемента, касающийся правого края панели. |
| AlignTopWith | Получает или задает целевой элемент, с которым выравнивается верхний край этого элемента. |
| AlignTopWithPanel | Возвращает или задает значение, указывающее, касается ли верхний край этого элемента, касающийся верхнего края панели. |
| AlignVerticalCenterWith | Возвращает или задает целевой элемент, с которым выравнивается вертикальный центр этого элемента. |
| AlignVerticalCenterWithPanel | Возвращает или задает значение, указывающее, касается ли вертикальная ось этого элемента, касающаяся горизонтальной оси панели. |
| ниже | Возвращает или задает целевой элемент, расположенный ниже этого элемента. |
| LeftOf | Возвращает или задает целевой элемент, расположенный в левой части этого элемента. |
| RightOf | Возвращает или задает целевой элемент, расположенный этот элемент справа. |
Журнал версий
| Версия Windows | Версия пакета SDK | Добавлено значение |
|---|---|---|
| 1809 | 17763 | Фоновое масштабирование |
Конструкторы
| RelativePanel() |
Инициализирует новый экземпляр класса RelativePanel. |
Свойства
| AboveProperty |
Определяет присоединенное свойство XAML RelativePanel.Above. |
| AccessKey |
Получает или задает ключ доступа (mnemonic) для этого элемента. (Унаследовано от UIElement) |
| AccessKeyScopeOwner |
Возвращает или задает исходный элемент, предоставляющий область ключа доступа для этого элемента, даже если он не находится в визуальном дереве исходного элемента. (Унаследовано от UIElement) |
| ActualHeight |
Возвращает отрисованную высоту FrameworkElement. См. примечания. (Унаследовано от FrameworkElement) |
| ActualOffset |
Получает позицию этого UIElement относительно родительского элемента, вычисляемого во время прохождения процесса макета. (Унаследовано от UIElement) |
| ActualSize |
Возвращает размер, вычисляемый этим UIElement во время упорядочивания процесса макета. (Унаследовано от UIElement) |
| ActualTheme |
Возвращает тему пользовательского интерфейса, которая в настоящее время используется элементом, который может отличаться от запрошенной. (Унаследовано от FrameworkElement) |
| ActualWidth |
Возвращает отрисованную ширину FrameworkElement. См. примечания. (Унаследовано от FrameworkElement) |
| AlignBottomWithPanelProperty |
Определяет присоединенное свойство XAML RelativePanel.AlignBottomWithPanel xaml. |
| AlignBottomWithProperty |
Определяет присоединенное свойство XAML RelativePanel.AlignBottomWith XAML. |
| AlignHorizontalCenterWithPanelProperty |
Определяет присоединенное свойство XAML RelativePanel.AlignHorizontalCenterWithPanel xaml. |
| AlignHorizontalCenterWithProperty |
Возвращает значение присоединенного свойства XAML RelativePanel.AlignHorizontalCenterWith присоединенного свойства XAML для целевого элемента. |
| AlignLeftWithPanelProperty |
Определяет присоединенное свойство XAML RelativePanel.AlignLeftWithPanel присоединенное свойство XAML. |
| AlignLeftWithProperty |
Определяет присоединенное свойство XAML RelativePanel.AlignLeftWith XAML. |
| AlignRightWithPanelProperty |
Определяет присоединенное свойство XAML RelativePanel.AlignRightWithPanel xaml. |
| AlignRightWithProperty |
Определяет присоединенное свойство XAML RelativePanel.AlignRightWith XAML. |
| AlignTopWithPanelProperty |
Определяет присоединенное свойство XAML RelativePanel.AlignTopWithPanel xaml. |
| AlignTopWithProperty |
Определяет присоединенное свойство XAML RelativePanel.AlignTopWith XAML. |
| AlignVerticalCenterWithPanelProperty |
Определяет присоединенное свойство XAML RelativePanel.AlignVerticalCenterWithPanel xaml. |
| AlignVerticalCenterWithProperty |
Возвращает значение присоединенного свойства XAML RelativePanel.AlignVerticalCenterWith присоединенного свойства XAML для целевого элемента. |
| AllowDrop |
Возвращает или задает значение, определяющее, может ли этот UIElement быть целевым объектом для операций перетаскивания. (Унаследовано от UIElement) |
| AllowFocusOnInteraction |
Возвращает или задает значение, указывающее, автоматически ли элемент получает фокус при взаимодействии с ним пользователем. (Унаследовано от FrameworkElement) |
| AllowFocusWhenDisabled |
Возвращает или задает, может ли отключенный элемент управления получать фокус. (Унаследовано от FrameworkElement) |
| Background |
Возвращает или задает Кисть, которая заполняет область содержимого панели. (Унаследовано от Panel) |
| BackgroundSizing |
Возвращает или задает значение, указывающее, насколько далеко фон расширяется относительно границы этого элемента. |
| BackgroundSizingProperty |
Определяет свойство зависимостей BackgroundSizing. |
| BackgroundTransition |
Возвращает или задает экземпляр BrushTransition для автоматического анимации изменений в свойстве Background. (Унаследовано от Panel) |
| BaseUri |
Возвращает универсальный идентификатор ресурса (URI), представляющий базовый универсальный идентификатор ресурса (URI) для объекта XAML, созданного во время загрузки XAML. Это свойство полезно для разрешения универсального идентификатора ресурса (URI) во время выполнения. (Унаследовано от FrameworkElement) |
| BelowProperty |
Определяет присоединенное свойство XAML RelativePanel. Below. |
| BorderBrush |
Возвращает или задает кисть, описывающую заливку границы панели. |
| BorderBrushProperty |
Определяет свойство зависимостей BorderBrush. |
| BorderThickness |
Возвращает или задает толщину границы панели. |
| BorderThicknessProperty |
Определяет свойство зависимостей |
| CacheMode |
Возвращает или задает значение, указывающее, что отображаемое содержимое должно кэшироваться как составное растровое изображение, когда это возможно. (Унаследовано от UIElement) |
| CanBeScrollAnchor |
Возвращает или задает значение, указывающее, может ли UIElement быть кандидатом на привязку прокрутки. (Унаследовано от UIElement) |
| CanDrag |
Возвращает или задает значение, указывающее, можно ли перетаскивать элемент в виде данных в операции перетаскивания. (Унаследовано от UIElement) |
| CenterPoint |
Возвращает или задает центральную точку элемента, которая является точкой, в которой происходит поворот или масштабирование. Влияет на положение отрисовки элемента. (Унаследовано от UIElement) |
| Children |
Возвращает коллекцию дочерних элементов панели. (Унаследовано от Panel) |
| ChildrenTransitions |
Возвращает или задает коллекцию элементов стиля Переход, которые применяются к дочернему содержимому подкласса панели . (Унаследовано от Panel) |
| Clip |
Возвращает или задает |
| CompositeMode |
Возвращает или задает свойство, которое объявляет альтернативные режимы композиции и смешивания для элемента в родительском макете и окне. Это относится к элементам, участвующим в смешанном пользовательском интерфейсе XAML или Microsoft DirectX. (Унаследовано от UIElement) |
| ContextFlyout |
Возвращает или задает всплывающий элемент, связанный с этим элементом. (Унаследовано от UIElement) |
| CornerRadius |
Получает или задает радиус для углов границы панели. |
| CornerRadiusProperty |
Определяет свойство зависимостей CornerRadius. |
| DataContext |
Возвращает или задает контекст данных для FrameworkElement. Обычно используется контекст данных, если FrameworkElement использует расширение разметки {Binding} и участвует в привязке данных. (Унаследовано от FrameworkElement) |
| DesiredSize |
Возвращает размер, который этот UIElement вычисляется во время прохождения меры процесса макета. (Унаследовано от UIElement) |
| Dispatcher |
Возвращает CoreDispatcher, с которым связан этот объект. CoreDispatcher представляет собой объект, который может получить доступ к DependencyObject в потоке пользовательского интерфейса, даже если код инициируется потоком, отличным от пользовательского интерфейса. (Унаследовано от DependencyObject) |
| ExitDisplayModeOnAccessKeyInvoked |
Возвращает или задает значение, указывающее, закрывается ли отображение ключа доступа при вызове ключа доступа. (Унаследовано от UIElement) |
| FlowDirection |
Получает или задает направление, в котором поток текста и других элементов пользовательского интерфейса в любом родительском элементе, который управляет их макетом. Это свойство можно задать как LeftToRight, так и RightToLeft. Задание FlowDirection на RightToLeft на любом элементе задает выравнивание справа, порядок чтения справа налево и макет элемента управления, который будет передаваться справа налево. (Унаследовано от FrameworkElement) |
| FocusVisualMargin |
Возвращает или задает внешнее поле визуального элемента фокуса для FrameworkElement. (Унаследовано от FrameworkElement) |
| FocusVisualPrimaryBrush |
Получает или задает кисть, используемую для рисования внешней границы визуального элемента |
| FocusVisualPrimaryThickness |
Возвращает или задает толщину внешней границы визуального элемента |
| FocusVisualSecondaryBrush |
Возвращает или задает кисть, используемую для рисования внутренней границы визуального элемента фокуса |
| FocusVisualSecondaryThickness |
Возвращает или задает толщину внутренней границы визуального элемента |
| Height |
Возвращает или задает рекомендуемую высоту FrameworkElement. (Унаследовано от FrameworkElement) |
| HighContrastAdjustment |
Возвращает или задает значение, указывающее, настраивает ли платформа визуальные свойства элемента автоматически при включении тем высокой контрастности. (Унаследовано от UIElement) |
| HorizontalAlignment |
Возвращает или задает характеристики горизонтального выравнивания, применяемые к FrameworkElement при создании в родительском элементе макета, например панели или элемента управления элементами. (Унаследовано от FrameworkElement) |
| IsAccessKeyScope |
Возвращает или задает значение, указывающее, определяет ли элемент собственную область ключа доступа. (Унаследовано от UIElement) |
| IsDoubleTapEnabled |
Возвращает или задает значение, определяющее, может ли событие doubleTapped |
| IsHitTestVisible |
Возвращает или задает, может ли содержащаяся область этого UIElement возвращать истинные значения для тестирования попаданий. (Унаследовано от UIElement) |
| IsHoldingEnabled |
Возвращает или задает значение, определяющее, может ли событие Holding исходить из этого элемента. (Унаследовано от UIElement) |
| IsItemsHost |
Возвращает значение, указывающее, является ли этот Панель контейнером для элементов пользовательского интерфейса, созданных ItemsControl. (Унаследовано от Panel) |
| IsLoaded |
Возвращает значение, указывающее, был ли элемент добавлен в дерево элементов и готов к взаимодействию. (Унаследовано от FrameworkElement) |
| IsRightTapEnabled |
Возвращает или задает значение, определяющее, может ли событие rightTapped |
| IsTapEnabled |
Возвращает или задает значение, определяющее, может ли событие |
| KeyboardAcceleratorPlacementMode |
Возвращает или задает значение, указывающее, отображает ли элемент управления подсказки сочетание клавиш для связанного акселератора клавиатуры. (Унаследовано от UIElement) |
| KeyboardAcceleratorPlacementTarget |
Возвращает или задает значение, указывающее подсказки элемента управления с сочетанием клавиш акселератора. (Унаследовано от UIElement) |
| KeyboardAccelerators |
Возвращает коллекцию сочетаний клавиш, которые вызывают действие с помощью клавиатуры. Ускорители обычно назначаются кнопкам или элементам меню.
|
| KeyTipHorizontalOffset |
Возвращает или задает значение, указывающее, насколько слева или справа подсказка ключа помещается в отношение uiElement. (Унаследовано от UIElement) |
| KeyTipPlacementMode |
Возвращает или задает значение, указывающее, где находится подсказка ключа доступа относительно границы UIElement. (Унаследовано от UIElement) |
| KeyTipTarget |
Возвращает или задает значение, указывающее элемент, предназначенный для подсказки ключа доступа. (Унаследовано от UIElement) |
| KeyTipVerticalOffset |
Возвращает или задает значение, указывающее, насколько далеко вверх или вниз подсказка ключа помещается в отношение к элементу пользовательского интерфейса. (Унаследовано от UIElement) |
| Language |
Возвращает или задает сведения о языке локализации и глобализации, которые применяются к FrameworkElement, а также ко всем дочерним элементам текущего FrameworkElement в представлении объекта и пользовательском интерфейсе. (Унаследовано от FrameworkElement) |
| LeftOfProperty |
Определяет присоединенное свойство XAML RelativePanel.Left Of. |
| 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) |
| Padding |
Возвращает или задает расстояние между границей и его дочерним объектом. |
| PaddingProperty |
Определяет свойство зависимостей |
| Parent |
Возвращает родительский объект этого FrameworkElement в дереве объектов. (Унаследовано от FrameworkElement) |
| PointerCaptures |
Возвращает набор всех захваченных указателей, представленных как указателя значений. (Унаследовано от UIElement) |
| Projection |
Получает или задает проекцию перспективы (эффект 3-D), применяемую при отрисовке этого элемента. (Унаследовано от UIElement) |
| RenderSize |
Возвращает окончательный размер отрисовки UIElement. Использование не рекомендуется, см. примечания. (Унаследовано от UIElement) |
| RenderTransform |
Возвращает или задает сведения о преобразовании, влияющие на положение отрисовки UIElement. (Унаследовано от UIElement) |
| RenderTransformOrigin |
Возвращает или задает точку источника любого возможного преобразования отрисовки, объявленного RenderTransformотносительно границ UIElement. (Унаследовано от UIElement) |
| RequestedTheme |
Возвращает или задает тему пользовательского интерфейса, используемую UIElement (и ее дочерние элементы) для определения ресурсов. Тема пользовательского интерфейса, указанная с помощью RequestedTheme, может переопределить уровня приложения. (Унаследовано от FrameworkElement) |
| Resources |
Возвращает локально определенный словарь ресурсов. В XAML можно установить элементы ресурсов в качестве дочерних элементов объекта элемента свойства |
| RightOfProperty |
Определяет присоединенное свойство XAML RelativePanel.RightOf XAML. |
| Rotation |
Получает или задает угол поворота по часовой стрелке в градусах. Поворот по отношению к RotationAxis и CenterPoint. Влияет на положение отрисовки элемента. (Унаследовано от UIElement) |
| RotationAxis |
Возвращает или задает ось для поворота элемента вокруг. (Унаследовано от UIElement) |
| RotationTransition |
Возвращает или задает ScalarTransition, который анимирует изменения свойства "Поворот". (Унаследовано от UIElement) |
| Scale |
Возвращает или задает масштаб элемента. Масштабируется относительно ЦентраPoint элемента. Влияет на положение отрисовки элемента. (Унаследовано от UIElement) |
| ScaleTransition |
Возвращает или задает объект Vector3Transition, который анимирует изменения свойства Scale. (Унаследовано от UIElement) |
| Shadow |
Возвращает или задает эффект тени, приведение к элементу. (Унаследовано от UIElement) |
| Style |
Возвращает или задает стиля экземпляра |
| TabFocusNavigation |
Возвращает или задает значение, которое изменяет способ работы табуляции и TabIndex для этого элемента управления. (Унаследовано от UIElement) |
| Tag |
Возвращает или задает произвольное значение объекта, которое можно использовать для хранения пользовательских сведений об этом объекте. (Унаследовано от FrameworkElement) |
| Transform3D |
Возвращает или задает эффект преобразования 3-D, применяемый при отрисовке этого элемента. (Унаследовано от UIElement) |
| TransformMatrix |
Возвращает или задает матрицу преобразования, применяемую к элементу. (Унаследовано от UIElement) |
| Transitions |
Возвращает или задает коллекцию элементов стиля перехода |
| Translation |
Возвращает или задает положение отрисовки элемента x, y и z. (Унаследовано от UIElement) |
| TranslationTransition |
Возвращает или задает объект Vector3Transition, который анимирует изменения свойства Translation. (Унаследовано от UIElement) |
| Triggers |
Возвращает коллекцию триггеров для анимаций, определенных для FrameworkElement. Часто не используется. См. примечания. (Унаследовано от FrameworkElement) |
| UIContext |
Возвращает идентификатор контекста для элемента. (Унаследовано от UIElement) |
| UseLayoutRounding |
Возвращает или задает значение, определяющее, должна ли отрисовка объекта и его визуального поддерева использовать циклический режим, который выравнивает отрисовку по всему пикселям. (Унаследовано от UIElement) |
| VerticalAlignment |
Возвращает или задает характеристики вертикального выравнивания, применяемые к FrameworkElement при создании в родительском объекте, например панели или элемента управления элементами. (Унаследовано от FrameworkElement) |
| Visibility |
Возвращает или задает видимость UIElement. UIElement, который не отображается, не отображается и не передает требуемый размер макету. (Унаследовано от UIElement) |
| Width |
Возвращает или задает ширину FrameworkElement. (Унаследовано от FrameworkElement) |
| XamlRoot |
Возвращает или задает |
| XYFocusDownNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации вниз. (Унаследовано от UIElement) |
| XYFocusKeyboardNavigation |
Возвращает или задает значение, которое включает или отключает навигацию с помощью клавишных стрелков. (Унаследовано от UIElement) |
| XYFocusLeftNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации слева. (Унаследовано от UIElement) |
| XYFocusRightNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента правой навигации. (Унаследовано от UIElement) |
| XYFocusUpNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации вверх. (Унаследовано от UIElement) |
Присоединенные свойства
| Above |
Возвращает или задает целевой элемент, расположенный над этим элементом. |
| AlignBottomWith |
Возвращает или задает целевой элемент, с которым выравнивается нижний край этого элемента. |
| AlignBottomWithPanel |
Возвращает или задает значение, указывающее, касается ли нижнего края этого элемента нижнего края панели. |
| AlignHorizontalCenterWith |
Возвращает или задает целевой элемент, с которым выровнен горизонтальный центр этого элемента. |
| AlignHorizontalCenterWithPanel |
Возвращает или задает значение, указывающее, касается ли горизонтальная ось этого элемента, касающаяся горизонтальной оси панели. |
| AlignLeftWith |
Возвращает или задает целевой элемент, с которым выравнивается левый край этого элемента. |
| AlignLeftWithPanel |
Получает или задает значение, указывающее, касается ли левый край этого элемента левого края панели. |
| AlignRightWith |
Возвращает или задает целевой элемент, с которым выравнивается правый край этого элемента. |
| AlignRightWithPanel |
Возвращает или задает значение, указывающее, касается ли правый край этого элемента, касающийся правого края панели. |
| AlignTopWith |
Получает или задает целевой элемент, с которым выравнивается верхний край этого элемента. |
| AlignTopWithPanel |
Возвращает или задает значение, указывающее, касается ли верхний край этого элемента, касающийся верхнего края панели. |
| AlignVerticalCenterWith |
Возвращает или задает целевой элемент, с которым выравнивается вертикальный центр этого элемента. |
| AlignVerticalCenterWithPanel |
Возвращает или задает значение, указывающее, касается ли вертикальная ось этого элемента, касающаяся горизонтальной оси панели. |
| Below |
Возвращает или задает целевой элемент, расположенный ниже этого элемента. |
| LeftOf |
Возвращает или задает целевой элемент, расположенный в левой части этого элемента. |
| RightOf |
Возвращает или задает целевой элемент, расположенный этот элемент справа. |
Методы
| AddHandler(RoutedEvent, Object, Boolean) |
Добавляет перенаправленный обработчик событий для указанного перенаправленного события, добавив обработчик в коллекцию обработчика текущего элемента. Укажите handledEventsToo как true для вызова предоставленного обработчика, даже если событие обрабатывается в другом месте. (Унаследовано от UIElement) |
| Arrange(Rect) |
Позиционирует дочерние объекты и определяет размер UIElement. Родительские объекты, реализующие пользовательский макет для дочерних элементов, должны вызывать этот метод из реализации переопределения макета, чтобы сформировать рекурсивное обновление макета. (Унаследовано от UIElement) |
| ArrangeOverride(Size) |
Предоставляет поведение для передачи макета "Упорядочить". Классы могут переопределить этот метод, чтобы определить собственное поведение передачи "Упорядочить". (Унаследовано от FrameworkElement) |
| CancelDirectManipulations() |
Отменяет текущую прямую обработку манипуляций (системное сдвига и масштабирование) на любом родительском элементе ScrollViewer |
| CapturePointer(Pointer) |
Задает запись указателя на UIElement. После захвата только элемент, имеющий запись, будет запускать события, связанные с указателем. (Унаследовано от UIElement) |
| ClearValue(DependencyProperty) |
Очищает локальное значение свойства зависимостей. (Унаследовано от DependencyObject) |
| FindName(String) |
Извлекает объект с указанным именем идентификатора. (Унаследовано от FrameworkElement) |
| FindSubElementsForTouchTargeting(Point, Rect) |
Позволяет UIElement подклассу предоставлять дочерние элементы, которые помогают разрешать целевое назначение касания. (Унаследовано от UIElement) |
| GetAbove(UIElement) |
Возвращает значение присоединенного свойства XAML RelativePanel.Above для целевого элемента. |
| GetAlignBottomWith(UIElement) |
Возвращает значение присоединенного свойства XAML RelativePanel.AlignBottomWith присоединенного свойства XAML для целевого элемента. |
| GetAlignBottomWithPanel(UIElement) |
Возвращает значение присоединенного свойства XAML RelativePanel.AlignBottomWithPanel XAML для целевого элемента. |
| GetAlignHorizontalCenterWith(UIElement) |
Возвращает значение присоединенного свойства XAML RelativePanel.AlignHorizontalCenterWith присоединенного свойства XAML для целевого элемента. |
| GetAlignHorizontalCenterWithPanel(UIElement) |
Возвращает значение присоединенного свойства XAML RelativePanel.AlignHorizontalCenterWithPanel присоединенного свойства XAML для целевого элемента. |
| GetAlignLeftWith(UIElement) |
Возвращает значение присоединенного свойства XAML RelativePanel.AlignLeftWith XAML для целевого элемента. |
| GetAlignLeftWithPanel(UIElement) |
Возвращает значение присоединенного свойства XAML RelativePanel.AlignLeftWithPanel присоединенного свойства XAML для целевого элемента. |
| GetAlignRightWith(UIElement) |
Возвращает значение присоединенного свойства XAML RelativePanel.AlignRightWith присоединенного свойства XAML для целевого элемента. |
| GetAlignRightWithPanel(UIElement) |
Возвращает значение присоединенного свойства XAML RelativePanel.AlignRightWithPanel присоединенного свойства XAML для целевого элемента. |
| GetAlignTopWith(UIElement) |
Возвращает значение присоединенного свойства XAML RelativePanel.AlignTopWith XAML для целевого элемента. |
| GetAlignTopWithPanel(UIElement) |
Возвращает значение присоединенного свойства XAML RelativePanel.AlignTopWithPanel присоединенного свойства XAML для целевого элемента. |
| GetAlignVerticalCenterWith(UIElement) |
Возвращает значение присоединенного свойства XAML RelativePanel.AlignVerticalCenterWith присоединенного свойства XAML для целевого элемента. |
| GetAlignVerticalCenterWithPanel(UIElement) |
Возвращает значение присоединенного свойства XAML RelativePanel.AlignVerticalCenterWithPanel присоединенного свойства XAML для целевого элемента. |
| GetAnimationBaseValue(DependencyProperty) |
Возвращает любое базовое значение, установленное для свойства зависимостей, которое будет применяться в случаях, когда анимация не активна. (Унаследовано от DependencyObject) |
| GetBelow(UIElement) |
Возвращает значение присоединенного свойства XAML RelativePanel.Below присоединенного свойства XAML для целевого элемента. |
| GetBindingExpression(DependencyProperty) |
Возвращает BindingExpression, представляющий привязку для указанного свойства. (Унаследовано от FrameworkElement) |
| GetChildrenInTabFocusOrder() |
Позволяет подклассу UIElement предоставлять дочерние элементы, участвующие в фокусе TAB. (Унаследовано от UIElement) |
| GetLeftOf(UIElement) |
Возвращает значение присоединенного свойства XAML RelativePanel.LeftOf XAML для целевого элемента. |
| GetRightOf(UIElement) |
Возвращает значение присоединенного свойства XAML RelativePanel.RightOf XAML для целевого элемента. |
| GetValue(DependencyProperty) |
Возвращает текущее эффективное значение свойства зависимостей из DependencyObject. (Унаследовано от DependencyObject) |
| GoToElementStateCore(String, Boolean) |
При реализации в производном классе позволяет создавать визуальное дерево визуального дерева для шаблона элемента управления в коде, а не загружать XAML для всех состояний при запуске элемента управления. (Унаследовано от FrameworkElement) |
| InvalidateArrange() |
Недопустимое состояние упорядочивания (макет) для UIElement. После недопустимости UIElement будет обновлен его макет, который будет выполняться асинхронно. (Унаследовано от UIElement) |
| InvalidateMeasure() |
Отменяет состояние измерения (макет) для UIElement. (Унаследовано от UIElement) |
| InvalidateViewport() |
Отменяет состояние окна просмотра для UIElement, который используется для вычисления эффективногопредставления. (Унаследовано от FrameworkElement) |
| Measure(Size) |
Обновляет DesiredSizeUIElement. Как правило, объекты, реализующие настраиваемый макет для дочерних элементов макета, вызывают этот метод из собственных реализации MeasureOverride для формирования рекурсивного обновления макета. (Унаследовано от UIElement) |
| MeasureOverride(Size) |
Предоставляет поведение для прохода "Measure" цикла макета. Классы могут переопределить этот метод, чтобы определить собственное поведение передачи Measure. (Унаследовано от FrameworkElement) |
| OnApplyTemplate() |
Вызывается всякий раз, когда код приложения или внутренние процессы (например, перестроение передачи макета) вызывается ApplyTemplate. В самых простых терминах это означает, что метод вызывается непосредственно перед отображением элемента пользовательского интерфейса в приложении. Переопределите этот метод, чтобы повлиять на логику после шаблона по умолчанию класса. (Унаследовано от FrameworkElement) |
| OnBringIntoViewRequested(BringIntoViewRequestedEventArgs) |
Вызывается перед событием BringIntoViewRequested. (Унаследовано от UIElement) |
| OnCreateAutomationPeer() |
При реализации в производном классе возвращает конкретные классы реализации AutomationPeer для инфраструктуры автоматизации пользовательского интерфейса Майкрософт. (Унаследовано от UIElement) |
| OnDisconnectVisualChildren() |
Переопределите этот метод, чтобы реализовать поведение макета и логики при удалении элементов из содержимого определенного класса или дочернего свойства. (Унаследовано от UIElement) |
| OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs) |
Вызывается, когда сочетания клавиш (или акселератор) обрабатывается в приложении. Переопределите этот метод для обработки реагирования приложения при вызове акселератора клавиатуры. (Унаследовано от UIElement) |
| OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) |
Вызывается непосредственно перед обработкой |
| PopulatePropertyInfo(String, AnimationPropertyInfo) |
Определяет свойство, которое может быть анимировано. (Унаследовано от UIElement) |
| PopulatePropertyInfoOverride(String, AnimationPropertyInfo) |
При переопределении в производном классе определяет свойство, которое может быть анимировано. (Унаследовано от UIElement) |
| ReadLocalValue(DependencyProperty) |
Возвращает локальное значение свойства зависимостей, если задано локальное значение. (Унаследовано от DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Регистрирует функцию уведомлений для прослушивания изменений в определенном экземпляре DependencyProperty в этом экземпляре DependencyObj ect. (Унаследовано от DependencyObject) |
| ReleasePointerCapture(Pointer) |
Освобождает записи указателя для записи одного конкретного указателя на этот UIElement. (Унаследовано от UIElement) |
| ReleasePointerCaptures() |
Освобождает все записи указателя, удерживаемые этим элементом. (Унаследовано от UIElement) |
| RemoveHandler(RoutedEvent, Object) |
Удаляет указанный обработчик перенаправленных событий из этого UIElement. Обычно обработчик был добавлен AddHandler. (Унаследовано от UIElement) |
| SetAbove(UIElement, Object) |
Задает значение присоединенного свойства XAML RelativePanel.Above XAML для целевого элемента. |
| SetAlignBottomWith(UIElement, Object) |
Задает значение присоединенного свойства XAML RelativePanel.AlignBottomWith XAML для целевого элемента. |
| SetAlignBottomWithPanel(UIElement, Boolean) |
Задает значение присоединенного свойства XAML RelativePanel.AlignBottomWithPanel присоединенного свойства XAML для целевого элемента. |
| SetAlignHorizontalCenterWith(UIElement, Object) |
Задает значение присоединенного свойства XAML RelativePanel.AlignHorizontalCenterWith XAML для целевого элемента. |
| SetAlignHorizontalCenterWithPanel(UIElement, Boolean) |
Задает значение присоединенного свойства XAML RelativePanel.AlignHorizontalCenterWithPanel xaml для целевого элемента. |
| SetAlignLeftWith(UIElement, Object) |
Задает значение присоединенного свойства XAML RelativePanel.AlignLeftWith xaml для целевого элемента. |
| SetAlignLeftWithPanel(UIElement, Boolean) |
Задает значение присоединенного свойства XAML RelativePanel.AlignLeftWithPanel присоединенного свойства XAML для целевого элемента. |
| SetAlignRightWith(UIElement, Object) |
Задает значение присоединенного свойства XAML RelativePanel.AlignRightWith XAML для целевого элемента. |
| SetAlignRightWithPanel(UIElement, Boolean) |
Задает значение присоединенного свойства XAML RelativePanel.AlignRightWithPanel присоединенного свойства XAML для целевого элемента. |
| SetAlignTopWith(UIElement, Object) |
Задает значение присоединенного свойства XAML RelativePanel.AlignTopWith xaml для целевого элемента. |
| SetAlignTopWithPanel(UIElement, Boolean) |
Задает значение присоединенного свойства XAML RelativePanel.AlignTopWithPanel присоединенного свойства XAML для целевого элемента. |
| SetAlignVerticalCenterWith(UIElement, Object) |
Задает значение присоединенного свойства XAML RelativePanel.AlignVerticalCenterWith xaml для целевого элемента. |
| SetAlignVerticalCenterWithPanel(UIElement, Boolean) |
Задает значение присоединенного свойства XAML RelativePanel.AlignVerticalCenterWithPanel присоединенного свойства XAML для целевого элемента. |
| SetBelow(UIElement, Object) |
Задает значение присоединенного свойства XAML RelativePanel.Below присоединенное свойство XAML для целевого элемента. |
| SetBinding(DependencyProperty, BindingBase) |
Присоединяет привязку к FrameworkElement, используя предоставленный объект привязки. (Унаследовано от FrameworkElement) |
| SetLeftOf(UIElement, Object) |
Задает значение присоединенного свойства XAML RelativePanel.LeftOf XAML для целевого элемента. |
| SetRightOf(UIElement, Object) |
Задает значение присоединенного свойства XAML RelativePanel.Right Of для целевого элемента. |
| 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 |
Происходит, когда |
| GettingFocus |
Происходит до UIElement получает фокус. Это событие вызывается синхронно, чтобы убедиться, что фокус не перемещается, пока событие бурно. (Унаследовано от UIElement) |
| GotFocus |
Происходит, когда UIElement получает фокус. Это событие возникает асинхронно, поэтому фокус может снова перемещаться до завершения пузырьков. (Унаследовано от UIElement) |
| Holding |
Происходит, когда в противном случае необработанные удержание происходит через область тестирования этого элемента. (Унаследовано от UIElement) |
| 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) |
| PointerCanceled |
Происходит, когда указатель, который сделал контакт ненормально теряет контакт. (Унаследовано от UIElement) |
| PointerCaptureLost |
Происходит, когда запись указателя, ранее удерживаемая этим элементом, перемещается в другой элемент или в другом месте. (Унаследовано от UIElement) |
| PointerEntered |
Происходит, когда указатель входит в область теста попадания этого элемента. (Унаследовано от UIElement) |
| PointerExited |
Происходит, когда указатель покидает область теста попадания этого элемента. (Унаследовано от UIElement) |
| PointerMoved |
Происходит при перемещении указателя, пока указатель остается в области теста попадания этого элемента. (Унаследовано от UIElement) |
| PointerPressed |
Происходит, когда устройство указателя инициирует действие Нажатие в этом элементе. (Унаследовано от UIElement) |
| PointerReleased |
Происходит при выпуске указателя устройства, которое ранее инициировало действие Нажатие, в то время как в этом элементе. Обратите внимание, что конец действия нажатия клавиши не гарантируется, что событие PointerReleased; Другие события могут вместо этого сработить. Дополнительные сведения см. в разделе "Примечания". (Унаследовано от UIElement) |
| PointerWheelChanged |
Происходит при изменении разностного значения колесика указателя. (Унаследовано от UIElement) |
| PreviewKeyDown |
Происходит при нажатии клавиши клавиатуры во время фокуса UIElement. (Унаследовано от UIElement) |
| PreviewKeyUp |
Происходит при выпуске клавиши клавиатуры во время фокуса UIElement. (Унаследовано от UIElement) |
| ProcessKeyboardAccelerators |
Происходит при нажатии |
| RightTapped |
Происходит, когда стимул ввода правого касания происходит, пока указатель находится над элементом. (Унаследовано от UIElement) |
| SizeChanged |
Происходит при изменении значения свойства ActualHeight или ActualWidth для FrameworkElement. (Унаследовано от FrameworkElement) |
| Tapped |
Происходит, если в противном случае необработанные касание взаимодействие происходит через область тестирования этого элемента. (Унаследовано от UIElement) |
| Unloaded |
Происходит, когда этот объект больше не подключен к дереву основного объекта. (Унаследовано от FrameworkElement) |
Применяется к
См. также раздел
- Panel
- Canvas
- Grid
- StackPanel
- VariableSizedWrapGrid
- Определение макетов с помощью XAML
- Краткое руководство по . Добавление элементов управления макетом
- выравнивание, поле и заполнение
- список элементов управления
- Элементы управления по функциям