Popup Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Отображает содержимое поверх существующего содержимого.
public ref class Popup sealed : FrameworkElement
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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="Child")]
class Popup final : FrameworkElement
/// [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="Child")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class Popup final : FrameworkElement
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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="Child")]
public sealed class Popup : FrameworkElement
[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="Child")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class Popup : FrameworkElement
Public NotInheritable Class Popup
Inherits FrameworkElement
<Popup .../>
- Наследование
- Атрибуты
Требования к Windows
Семейство устройств |
Windows 10 (появилось в 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (появилось в v1.0)
|
Примеры
В этом примере показано простое всплывающее окно со встроенным содержимым.
<Grid x:Name="Output" HorizontalAlignment="Left" VerticalAlignment="Top" Grid.Row="1">
<StackPanel>
<Button Content="Show Popup (using Offset)" Click="ShowPopupOffsetClicked"/>
</StackPanel>
<Popup VerticalOffset="10" HorizontalOffset="200" x:Name="StandardPopup">
<Border BorderBrush="{StaticResource ApplicationForegroundThemeBrush}"
Background="{StaticResource ApplicationPageBackgroundThemeBrush}"
BorderThickness="2" Width="200" Height="200">
<StackPanel HorizontalAlignment="Center" VerticalAlignment="Center">
<TextBlock Text="Simple Popup" FontSize="24.667" HorizontalAlignment="Center"/>
<Button Content="Close" Click="ClosePopupClicked" HorizontalAlignment="Center"/>
</StackPanel>
</Border>
</Popup>
</Grid>
// Handles the Click event on the Button inside the Popup control and
// closes the Popup.
private void ClosePopupClicked(object sender, RoutedEventArgs e)
{
// if the Popup is open, then close it
if (StandardPopup.IsOpen) { StandardPopup.IsOpen = false; }
}
// Handles the Click event on the Button on the page and opens the Popup.
private void ShowPopupOffsetClicked(object sender, RoutedEventArgs e)
{
// open the Popup if it isn't open already
if (!StandardPopup.IsOpen) { StandardPopup.IsOpen = true; }
}
В этом примере показано всплывающее окно, для которого в качестве дочернего элемента задан элемент UserControl. Элемент UserControl определяет содержимое всплывающего окна.
<Popup x:Name="ParentedPopup" HorizontalOffset="200" VerticalOffset="200">
<local:PopupInputContent/>
</Popup>
<UserControl
x:Class="XAMLPopup.PopupInputContent"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="using:PopupExample"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
mc:Ignorable="d"
d:DesignHeight="300"
d:DesignWidth="400">
<Grid>
<StackPanel>
<TextBlock Text="Type some input" FontSize="24.667"/>
<TextBox Width="300" Height="55"/>
<Button Content="Save" Click="SimulateSaveClicked"/>
</StackPanel>
</Grid>
</UserControl>
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
namespace XAMLPopup
{
public sealed partial class PopupInputContent : UserControl
{
public PopupInputContent()
{
this.InitializeComponent();
}
// Handles the Click event of the 'Save' button simulating a save and close
private void SimulateSaveClicked(object sender, RoutedEventArgs e)
{
// in this example we assume the parent of the UserControl is a Popup
Popup p = this.Parent as Popup;
// close the Popup
if (p != null) { p.IsOpen = false; }
}
}
}
Комментарии
Не используйте всплывающее окно, если всплывающие элементы, MenuFlyout, ToolTip или ContentDialog (MessageDialog для приложения Windows 8) являются более подходящими.
Popup — это контейнер общего назначения для размещения объектов UIElementповерх существующего содержимого. Обычно всплывающее окно используется для временного отображения содержимого, выполняющего определенную задачу. Всплывающее окно не имеет визуального шаблона по умолчанию. Вместо этого необходимо задать содержимое самостоятельно, указав в качестве содержимого один дочерний элемент. Содержимое всплывающего окна можно определить встроенным образом, но обычно содержимое определяется как UserControl, а затем — в качестведочернего элемента всплывающего окна.
Чтобы расположить всплывающее окно, задав свойства HorizontalOffset и VerticalOffset . Всплывающее окно имеет смещение относительно его непосредственного родительского контейнера. Всплывающее окно не является модальным, поэтому вход на экран за ним не блокируется. Если свойство ShouldConstrainToRootBounds имеет значение false
, всплывающее окно может быть расположено таким образом, чтобы оно не было внутри границ корня содержимого.
Чтобы отобразить всплывающее окно, задайте для его свойства IsOpenзначение true. Чтобы скрыть всплывающее окно, установите для параметра IsOpen значение false. Вы можете задать параметр IsLightDismissEnabled , чтобы всплывающее окно скрывалось автоматически, когда пользователь нажимает в любом месте.
Всплывающее окно может размещать элементы управления вводом. При размещении элементов управления вводом, таких как TextBox, сенсорная клавиатура может сдвинуться в поле зрения, когда пользователь касается элемента управления вводом. Если родительский контейнер popup уже находится в визуальном дереве, всплывающее окно автоматически перемещается, когда сенсорная клавиатура находится в поле зрения. В противном случае всплывающее окно не перемещается, и сенсорная клавиатура может покрывать его. Это может произойти, если создать всплывающее окно в коде и задать для параметра IsOpen значение true, не добавляя popup в качестве дочернего элемента в визуальном дереве.
Всплывающее окно не запускает routedEvents, например KeyDown и PointerPressed. Обработчик событий для этих событий RoutedEvent можно подключить к дочернему элементу всплывающего окна.
Журнал версий
Версия Windows | Версия пакета SDK | Добавленная стоимость |
---|---|---|
1607 | 14393 | LightDismissOverlayMode |
1903 | 18362 | IsConstrainedToRootBounds |
1903 | 18362 | ShouldConstrainToRootBounds |
Конструкторы
Popup() |
Инициализирует новый экземпляр класса Popup . |
Свойства
AccessKey |
Возвращает или задает ключ доступа (мнемонический) для этого элемента. (Унаследовано от UIElement) |
AccessKeyScopeOwner |
Возвращает или задает исходный элемент, предоставляющий ключ доступа область для этого элемента, даже если он не находится в визуальном дереве исходного элемента. (Унаследовано от UIElement) |
ActualHeight |
Возвращает отрисованную высоту объекта FrameworkElement. См. заметки. (Унаследовано от FrameworkElement) |
ActualOffset |
Возвращает положение этого элемента UIElement относительно его родительского элемента, вычисленное во время прохода упорядочения процесса макета. (Унаследовано от UIElement) |
ActualPlacement |
Возвращает фактическое расположение всплывающего окна относительно целевого объекта размещения. |
ActualSize |
Возвращает размер, вычисленный этим элементом UIElement во время упорядочения процесса макета. (Унаследовано от UIElement) |
ActualTheme |
Возвращает тему пользовательского интерфейса, которая в настоящее время используется элементом , который может отличаться от RequestedTheme. (Унаследовано от FrameworkElement) |
ActualWidth |
Возвращает отрисованную ширину элемента FrameworkElement. См. заметки. (Унаследовано от FrameworkElement) |
AllowDrop |
Возвращает или задает значение, определяющее, может ли этот элемент UIElement быть целевым объектом перетаскивания для операций перетаскивания. (Унаследовано от UIElement) |
AllowFocusOnInteraction |
Возвращает или задает значение, указывающее, получает ли элемент фокус автоматически, когда пользователь взаимодействует с ним. (Унаследовано от FrameworkElement) |
AllowFocusWhenDisabled |
Возвращает или задает значение, указывающее, может ли отключенный элемент управления получать фокус. (Унаследовано от FrameworkElement) |
BaseUri |
Возвращает универсальный код ресурса (URI), представляющий базовый универсальный код ресурса (URI) для созданного в XAML объекта во время загрузки XAML. Это свойство полезно для разрешения универсального кода ресурса (URI) во время выполнения. (Унаследовано от FrameworkElement) |
CacheMode |
Возвращает или задает значение, указывающее, что отображаемое содержимое должно кэшироваться в виде составного растрового изображения, если это возможно. (Унаследовано от UIElement) |
CanBeScrollAnchor |
Возвращает или задает значение, указывающее, может ли UIElement быть кандидатом для привязки прокрутки. (Унаследовано от UIElement) |
CanDrag |
Возвращает или задает значение, указывающее, можно ли перетаскивать элемент как данные в операции перетаскивания. (Унаследовано от UIElement) |
CenterPoint |
Возвращает или задает центральную точку элемента, то есть точку, о которой происходит поворот или масштабирование. Влияет на позицию отрисовки элемента. (Унаследовано от UIElement) |
Child |
Возвращает или задает содержимое для размещения во всплывающем окне. |
ChildProperty |
Возвращает идентификатор для свойства дочерней зависимости. |
ChildTransitions |
Возвращает или задает коллекцию элементов стиля перехода , применяемых к дочернему содержимому всплывающего окна. |
ChildTransitionsProperty |
Определяет свойство зависимостей ChildTransitions . |
Clip |
Возвращает или задает объект RectangleGeometry, используемый для определения структуры содержимого элемента UIElement. (Унаследовано от UIElement) |
CompositeMode |
Возвращает или задает свойство, объявляющее альтернативные режимы композиции и наложения для элемента в родительском макете и окне. Это относится к элементам, участвующим в смешанном пользовательском интерфейсе XAML/Microsoft DirectX. (Унаследовано от UIElement) |
ContextFlyout |
Возвращает или задает всплывающий элемент, связанный с этим элементом. (Унаследовано от UIElement) |
DataContext |
Возвращает или задает контекст данных для FrameworkElement. Контекст данных часто используется, когда FrameworkElement использует расширение разметки {Binding} и участвует в привязке данных. (Унаследовано от FrameworkElement) |
DesiredPlacement |
Возвращает или задает предпочтительное размещение, используемое для всплывающего окна, по отношению к целевому объекту размещения. |
DesiredPlacementProperty |
Определяет свойство зависимости DesiredPlacement . |
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) |
HorizontalOffset |
Возвращает или задает расстояние между левой частью окна приложения и левой стороной всплывающего окна. |
HorizontalOffsetProperty |
Возвращает идентификатор свойства зависимости HorizontalOffset . |
IsAccessKeyScope |
Возвращает или задает значение, указывающее, определяет ли элемент собственный ключ доступа область. (Унаследовано от UIElement) |
IsConstrainedToRootBounds |
Возвращает значение, указывающее, отображается ли всплывающее окно в пределах корня XAML. |
IsDoubleTapEnabled |
Возвращает или задает значение, определяющее, может ли событие DoubleTapped исходить из этого элемента. (Унаследовано от UIElement) |
IsHitTestVisible |
Возвращает или задает значение, указывающее, может ли автономная область этого элемента UIElement возвращать истинные значения для проверки попадания. (Унаследовано от UIElement) |
IsHoldingEnabled |
Возвращает или задает значение, определяющее, может ли событие Holding исходить из этого элемента. (Унаследовано от UIElement) |
IsLightDismissEnabled |
Возвращает или задает значение, определяющее способ закрытия всплывающего окна . |
IsLightDismissEnabledProperty |
Определяет свойство зависимости IsLightDismissEnabled . |
IsLoaded |
Возвращает значение, указывающее, был ли элемент добавлен в дерево элементов и готов ли он к взаимодействию. (Унаследовано от FrameworkElement) |
IsOpen |
Возвращает или задает значение, указывающее, отображается ли всплывающее окно на экране. |
IsOpenProperty |
Возвращает идентификатор свойства зависимостей IsOpen . |
IsRightTapEnabled |
Возвращает или задает значение, определяющее, может ли событие RightTapped исходить из этого элемента. (Унаследовано от UIElement) |
IsTapEnabled |
Возвращает или задает значение, определяющее, может ли событие Tapped исходить из этого элемента. (Унаследовано от UIElement) |
KeyboardAcceleratorPlacementMode |
Возвращает или задает значение, указывающее , отображает ли подсказка элемента управления сочетание клавиш для связанного ускорителя клавиатуры. (Унаследовано от UIElement) |
KeyboardAcceleratorPlacementTarget |
Возвращает или задает значение, указывающее подсказку элемента управления, отображающую сочетание клавиш ускорителя. (Унаследовано от UIElement) |
KeyboardAccelerators |
Возвращает коллекцию сочетаний клавиш, вызывающих действие с помощью клавиатуры. Ускорители обычно назначаются кнопкам или пунктам меню.
|
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) |
Parent |
Возвращает родительский объект этого элемента FrameworkElement в дереве объектов. (Унаследовано от FrameworkElement) |
PlacementTarget |
Возвращает или задает элемент, используемый в качестве целевого объекта размещения всплывающего окна. |
PlacementTargetProperty |
Определяет свойство зависимостей PlacementTarget . |
PointerCaptures |
Возвращает набор всех захваченных указателей, представленных в виде значений указателя . (Унаследовано от UIElement) |
Projection |
Возвращает или задает перспективную проекцию (трехмерный эффект), применяемую при отрисовке этого элемента. (Унаследовано от UIElement) |
RenderSize |
Возвращает окончательный размер отрисовки элемента UIElement. Использовать не рекомендуется, см. примечания. (Унаследовано от UIElement) |
RenderTransform |
Возвращает или задает сведения о преобразовании, влияющие на положение отрисовки элемента UIElement. (Унаследовано от UIElement) |
RenderTransformOrigin |
Возвращает или задает исходную точку любого возможного преобразования отрисовки, объявленного RenderTransform, относительно границ UIElement. (Унаследовано от UIElement) |
RequestedTheme |
Возвращает или задает тему пользовательского интерфейса, используемую элементом UIElement (и его дочерними элементами) для определения ресурсов. Тема пользовательского интерфейса, указанная с помощью RequestedTheme, может переопределить элемент RequestedTheme на уровне приложения. (Унаследовано от FrameworkElement) |
Resources |
Возвращает локально определенный словарь ресурсов. В XAML элементы ресурсов можно установить в качестве дочерних элементов объекта элемента свойства с помощью синтаксиса |
Rotation |
Возвращает или задает угол поворота по часовой стрелке в градусах. Поворачивается относительно RotationAxis и CenterPoint. Влияет на позицию отрисовки элемента. (Унаследовано от UIElement) |
RotationAxis |
Возвращает или задает ось для поворота элемента вокруг. (Унаследовано от UIElement) |
RotationTransition |
Возвращает или задает scalarTransition, который анимирует изменения в свойстве Rotation. (Унаследовано от UIElement) |
Scale |
Возвращает или задает масштаб элемента. Масштабируется относительно элемента CenterPoint. Влияет на позицию отрисовки элемента. (Унаследовано от UIElement) |
ScaleTransition |
Возвращает или задает объект Vector3Transition, который анимирует изменения в свойстве Scale. (Унаследовано от UIElement) |
Shadow |
Возвращает или задает эффект тени, отбрасываемый элементом . (Унаследовано от UIElement) |
ShouldConstrainToRootBounds |
Возвращает или задает значение, указывающее, должно ли отображаться всплывающее окно в пределах корня XAML. |
ShouldConstrainToRootBoundsProperty |
Определяет свойство зависимости ShouldConstrainToRootBounds . |
Style |
Возвращает или задает стиль экземпляра, который применяется к этому объекту во время макета и отрисовки. (Унаследовано от FrameworkElement) |
TabFocusNavigation |
Возвращает или задает значение, изменяющее работу tabbing и TabIndex для этого элемента управления. (Унаследовано от UIElement) |
Tag |
Возвращает или задает произвольное значение объекта, которое можно использовать для хранения пользовательских сведений об этом объекте. (Унаследовано от FrameworkElement) |
Transform3D |
Возвращает или задает эффект трехмерного преобразования, применяемый при отрисовке этого элемента. (Унаследовано от UIElement) |
TransformMatrix |
Возвращает или задает матрицу преобразования, применяемую к элементу . (Унаследовано от UIElement) |
Transitions |
Возвращает или задает коллекцию элементов стиля Перехода , которые применяются к UIElement. (Унаследовано от UIElement) |
Translation |
Возвращает или задает позицию отрисовки x, y и z элемента. (Унаследовано от UIElement) |
TranslationTransition |
Возвращает или задает объект Vector3Transition, который анимирует изменения в свойстве Translation. (Унаследовано от UIElement) |
Triggers |
Возвращает коллекцию триггеров для анимаций, определенных для FrameworkElement. Не часто используется. См. заметки. (Унаследовано от FrameworkElement) |
UIContext |
Возвращает идентификатор контекста для элемента . (Унаследовано от UIElement) |
UseLayoutRounding |
Возвращает или задает значение, определяющее, должна ли отрисовка объекта и его визуального поддереви использовать поведение округления, которое выравнивает отрисовку по целым пикселям. (Унаследовано от UIElement) |
VerticalAlignment |
Возвращает или задает характеристики вертикального выравнивания, применяемые к Объекту FrameworkElement при его создании в родительском объекте, например панели или элемента управления элементами. (Унаследовано от FrameworkElement) |
VerticalOffset |
Возвращает или задает расстояние между верхней частью окна приложения и верхней частью всплывающего окна. |
VerticalOffsetProperty |
Возвращает идентификатор для свойства зависимостей VerticalOffset . |
Visibility |
Возвращает или задает видимость uiElement. Невидимый элемент UIElement не отображается и не передает нужный размер макету. (Унаследовано от UIElement) |
Width |
Возвращает или задает ширину элемента FrameworkElement. (Унаследовано от FrameworkElement) |
XamlRoot |
Возвращает или задает объект , |
XYFocusDownNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации вниз. (Унаследовано от UIElement) |
XYFocusKeyboardNavigation |
Возвращает или задает значение, которое включает или отключает навигацию с помощью стрелки направления клавиатуры. (Унаследовано от UIElement) |
XYFocusLeftNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента левой навигации. (Унаследовано от UIElement) |
XYFocusRightNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента правильной навигации. (Унаследовано от UIElement) |
XYFocusUpNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации вверх. (Унаследовано от UIElement) |
Методы
AddHandler(RoutedEvent, Object, Boolean) |
Добавляет обработчик перенаправленного события для указанного перенаправленного события, помещая этот обработчик в коллекцию обработчиков текущего элемента. Укажите значение handledEventsTooкак true , чтобы вызвать предоставленный обработчик, даже если событие обрабатывается в другом месте. (Унаследовано от UIElement) |
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) |
GetAnimationBaseValue(DependencyProperty) |
Возвращает любое базовое значение, установленное для свойства зависимостей, которое применяется в случаях, когда анимация не активна. (Унаследовано от DependencyObject) |
GetBindingExpression(DependencyProperty) |
Возвращает bindingExpression , представляющее привязку к указанному свойству. (Унаследовано от FrameworkElement) |
GetChildrenInTabFocusOrder() |
Позволяет подклассу UIElement предоставлять дочерние элементы, которые участвуют в фокусе tab. (Унаследовано от UIElement) |
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. Проще говоря, это означает, что метод вызывается непосредственно перед отображением элемента пользовательского интерфейса в приложении. Переопределите этот метод, чтобы повлиять на логику после шаблона класса по умолчанию. (Унаследовано от FrameworkElement) |
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs) |
Вызывается перед событием BringIntoViewRequested . (Унаследовано от UIElement) |
OnCreateAutomationPeer() |
При реализации в производном классе возвращает реализации AutomationPeer для конкретного класса для инфраструктуры автоматизации пользовательского интерфейса Майкрософт. (Унаследовано от UIElement) |
OnDisconnectVisualChildren() |
Переопределите этот метод, чтобы реализовать поведение макета и логики при удалении элементов из свойства содержимого или дочерних элементов класса. (Унаследовано от UIElement) |
OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs) |
Вызывается при обработке сочетания клавиш (или ускорителя) в приложении. Переопределите этот метод для обработки реакции приложения на вызов ускорителя клавиатуры. (Унаследовано от UIElement) |
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) |
Вызывается непосредственно перед обработкой сочетания клавиш (или ускорителя) в приложении. Вызывается всякий раз, когда код приложения или внутренние процессы вызывают ProcessKeyboardAccelerators. Переопределите этот метод, чтобы повлиять на обработку ускорителя по умолчанию. (Унаследовано от UIElement) |
PopulatePropertyInfo(String, AnimationPropertyInfo) |
Определяет свойство, которое можно анимировать. (Унаследовано от UIElement) |
PopulatePropertyInfoOverride(String, AnimationPropertyInfo) |
При переопределении в производном классе определяет свойство, которое можно анимировать. (Унаследовано от UIElement) |
ReadLocalValue(DependencyProperty) |
Возвращает локальное значение свойства зависимостей, если задано локальное значение. (Унаследовано от DependencyObject) |
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Регистрирует функцию уведомления для прослушивания изменений определенного DependencyProperty в этом экземпляре DependencyObject . (Унаследовано от DependencyObject) |
ReleasePointerCapture(Pointer) |
Освобождает записи указателя для захвата одного конкретного указателя этим элементом UIElement. (Унаследовано от UIElement) |
ReleasePointerCaptures() |
Освобождает все записи указателей, хранящиеся этим элементом. (Унаследовано от UIElement) |
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) |
ActualPlacementChanged |
Отображает содержимое поверх существующего содержимого. |
ActualThemeChanged |
Происходит при изменении значения свойства ActualTheme. (Унаследовано от FrameworkElement) |
BringIntoViewRequested |
Происходит при вызове StartBringIntoView для этого элемента или одного из его потомков. (Унаследовано от UIElement) |
CharacterReceived |
Происходит при получении одного составного символа входной очередью. (Унаследовано от UIElement) |
Closed |
Возникает, если свойству IsOpen присвоено значение false. |
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) |
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) |
Opened |
Возникает, если свойству IsOpen присвоено значение true. |
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) |