ProgressRing Класс

Определение

Пространство имен:

Microsoft.UI.Xaml.Controls

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

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class ProgressRing : Control

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class ProgressRing : Control

Public Class ProgressRing
Inherits Control

Наследование

Object IInspectable DependencyObject UIElement FrameworkElement Control ProgressRing

Атрибуты

MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

Примеры

Tip

Дополнительные сведения, рекомендации по проектированию и примеры кода см. в разделе "Элементы управления "Ход выполнения".

Откройте приложение коллекции WinUI 3 и просмотрите ProgressRing в действии

Приложение Галерея WinUI 3 включает интерактивные примеры большинства элементов управления, особенностей и возможностей WinUI 3. Получите приложение из Microsoft Store или получите исходный код в GitHub.

В этом примере показано, как задать свойство IsActive в коде ProgressRing. Для включения или отключения элемента управленияProgressRing используется переключатель ToggleSwitch .

<StackPanel>
   <ProgressRing IsActive="{x:Bind ProgressToggle.IsOn, Mode=OneWay}" />
   <ToggleSwitch x:Name="ProgressToggle" Header="Toggle work" OffContent="Do work" OnContent="Working" IsOn="True" />
</StackPanel>

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

<StackPanel>
   <ProgressRing IsIndeterminate="false">
   <NumberBox x:Name="ProgressValue" Minimum="0" Maximum="100" SpinButtonPlacementMode="Inline" ValueChanged="ProgressValue_ValueChanged"/>
</StackPanel>

 private void ProgressValue_ValueChanged(Microsoft.UI.Xaml.Controls.NumberBox sender, Microsoft.UI.Xaml.Controls.NumberBoxValueChangedEventArgs args)
{
   if (!sender.Value.IsNaN())
   {
         ProgressRing2.Value = sender.Value;
   }
   else
   {
         sender.Value = 0;
   }
}

Комментарии

ProgressRing — это элемент управления, который визуально указывает ход выполнения операции с одним из двух стилей: кольцо, которое многократно анимирует или кольцо, которое заполняется на основе значения.

Используйте ProgressRing, чтобы визуально указать, что операция выполняется. Задайте свойство IsActive , чтобы включить или отключить ProgressRing. Если IsActive имеет значение false, индикатор ProgressRing не отображается, но пространство зарезервировано для него в макете пользовательского интерфейса. Чтобы не зарезервировать пространство для ProgressRing, задайте для свойства Видимости значение Collapsed.

Свойство IsIndeterminate определяет внешний вид ProgressRing.

• Задайте для isIndeterminateзначение true , чтобы отобразить повторяющуюся анимацию. (Это значение по умолчанию)
• Задайте значение IsIndeterminateзначение false , чтобы заполнить строку на основе значения. Если IsIndeterminate имеет значение false, укажите диапазон с свойствами "Минимальное " и "Максимальное ". По умолчанию минимальное значение равно 0, а максимальное — 100. Чтобы указать значение хода выполнения, задайте свойство Value .

Стиль и шаблон элемента управления

Вы можете изменить стиль по умолчанию и ControlTemplate , чтобы предоставить элементу управления уникальный внешний вид. Сведения об изменении стиля и шаблона элемента управления см. в стилях XAML. Стиль, шаблон и ресурсы по умолчанию, определяющие внешний вид элемента управления, включаются в generic.xaml файл. В целях разработки generic.xaml устанавливается с пакетом NuGet Windows App SDK. По умолчанию, это расположение \Users\<username>\.nuget\packages\microsoft.windowsappsdk\<version>\lib\uap10.0\Microsoft.UI\Themes\generic.xaml. Стили и ресурсы из разных версий пакета SDK могут иметь разные значения.

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

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

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

Свойства

Имя	Описание
AccessKey	Получает или задает ключ доступа (mnemonic) для этого элемента. (Унаследовано от UIElement)
AccessKeyScopeOwner	Возвращает или задает исходный элемент, предоставляющий область ключа доступа для этого элемента, даже если он не находится в визуальном дереве исходного элемента. (Унаследовано от UIElement)
ActualHeight	Возвращает отрисованную высоту объекта FrameworkElement. См. примечания. (Унаследовано от FrameworkElement)
ActualOffset	Получает позицию этого UIElement относительно родительского элемента, вычисляемого во время прохождения процесса макета. (Унаследовано от UIElement)
ActualSize	Возвращает размер, вычисляемый этим UIElement во время упорядочивания процесса макета. (Унаследовано от UIElement)
ActualTheme	Возвращает тему пользовательского интерфейса, которая в настоящее время используется элементом, который может отличаться от запрошенного элемента. (Унаследовано от 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 эм. (Унаследовано от Control)
Clip	Возвращает или задает прямоугольникGeometry , используемый для определения структуры содержимого UIElement. (Унаследовано от UIElement)
CompositeMode	Возвращает или задает свойство, которое объявляет альтернативные режимы композиции и смешивания для элемента в родительском макете и окне. Это относится к элементам, участвующим в смешанном пользовательском интерфейсе XAML или Microsoft DirectX. (Унаследовано от UIElement)
ContextFlyout	Возвращает или задает всплывающий элемент, связанный с этим элементом. (Унаследовано от UIElement)
CornerRadius	Возвращает или задает радиус для углов границы элемента управления. (Унаследовано от Control)
DataContext	Возвращает или задает контекст данных для FrameworkElement. Обычно используется контекст данных, когда FrameworkElement используется расширение разметки {Binding} и участвует в привязке данных. (Унаследовано от FrameworkElement)
DefaultStyleKey	Возвращает или задает ключ, ссылающийся на стиль по умолчанию для элемента управления. Авторы пользовательских элементов управления используют это свойство для изменения стиля, используемого их элементом управления по умолчанию. (Унаследовано от Control)
DefaultStyleResourceUri	Возвращает или задает путь к файлу ресурсов, который содержит стиль по умолчанию для элемента управления. (Унаследовано от Control)
DesiredSize	Возвращает размер, вычисляемый этим UIElement во время прохождения меры процесса макета. (Унаследовано от UIElement)
Dispatcher	Всегда возвращается null в приложении пакета SDK для приложений windows. Вместо этого используйте DispatcherQueue . (Унаследовано от DependencyObject)
DispatcherQueue	Возвращает, DispatcherQueue с которым связан этот объект. Представляет DispatcherQueue собой объект, который может получить доступ к DependencyObject потоку пользовательского интерфейса, даже если код инициируется потоком, отличным от пользовательского интерфейса. (Унаследовано от DependencyObject)
ElementSoundMode	Получает или задает значение, указывающее предпочтения элемента управления о том, будут ли воспроизводиться звуки. (Унаследовано от Control)
ExitDisplayModeOnAccessKeyInvoked	Возвращает или задает значение, указывающее, закрывается ли отображение ключа доступа при вызове ключа доступа. (Унаследовано от UIElement)
FlowDirection	Получает или задает направление, в котором поток текста и других элементов пользовательского интерфейса в любом родительском элементе, который управляет их макетом. Это свойство может иметь значение LeftToRight или RightToLeft. RightToLeft Параметр FlowDirection для любого элемента задает выравнивание справа, порядок чтения справа налево и макет элемента управления, который будет передаваться справа налево. (Унаследовано от FrameworkElement)
FocusState	Возвращает значение, указывающее, имеет ли этот элемент управления фокус и режим получения фокуса. (Унаследовано от UIElement)
FocusVisualMargin	Возвращает или задает внешнее поле визуального элемента фокуса для FrameworkElement. (Унаследовано от FrameworkElement)
FocusVisualPrimaryBrush	Возвращает или задает кисть, используемую для рисования внешней границы визуального элемента или Reveal фокуса HighVisibility для FrameworkElement. (Унаследовано от FrameworkElement)
FocusVisualPrimaryThickness	Возвращает или задает толщину внешней границы визуального элемента или Reveal фокуса HighVisibility для FrameworkElement. (Унаследовано от FrameworkElement)
FocusVisualSecondaryBrush	Возвращает или задает кисть, используемую для рисования внутренней границы визуального элемента или Reveal фокуса HighVisibility для 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)
IsActive	Возвращает или задает значение, указывающее, отображается ли ход выполнения ProgressRing .
IsActiveProperty	Определяет свойство зависимостей IsActive .
IsDoubleTapEnabled	Возвращает или задает значение, определяющее, может ли событие DoubleTapped исходить из этого элемента. (Унаследовано от UIElement)
IsEnabled	Возвращает или задает значение, указывающее, может ли пользователь взаимодействовать с элементом управления. (Унаследовано от Control)
IsFocusEngaged	Получает или задает значение, указывающее, ограничен ли фокус элементом управления, когда пользователь нажимает кнопку A/Select на игровом контроллере. (Унаследовано от Control)
IsFocusEngagementEnabled	Получает или задает значение, указывающее, может ли фокус быть ограничен элементом управления, когда пользователь нажимает кнопку A/Select на игровом контроллере. (Унаследовано от Control)
IsHitTestVisible	Возвращает или задает, может ли содержащаяся область этого UIElement возвращать истинные значения для тестирования попаданий. (Унаследовано от UIElement)
IsHoldingEnabled	Возвращает или задает значение, определяющее, может ли событие Holding исходить из этого элемента. (Унаследовано от UIElement)
IsIndeterminate	Возвращает или задает значение, указывающее, передает ли кольцевой ход выполнения универсальный ход выполнения с повторяющимся шаблоном или отчетами о ходе выполнения на основе свойства Value .
IsIndeterminateProperty	Определяет свойство зависимостей IsIndeterminate .
IsLoaded	Возвращает значение, указывающее, был ли элемент добавлен в дерево элементов и готов к взаимодействию. (Унаследовано от FrameworkElement)
IsRightTapEnabled	Возвращает или задает значение, определяющее, может ли событие RightTapped исходить из этого элемента. (Унаследовано от UIElement)
IsTabStop	Возвращает или задает значение, указывающее, включен ли элемент управления в навигацию по вкладкам. (Унаследовано от UIElement)
IsTapEnabled	Возвращает или задает значение, определяющее, может ли событие "Касаться" из этого элемента. (Унаследовано от UIElement)
IsTextScaleFactorEnabled	Возвращает или задает, включен ли автоматическое расширение текста для отражения параметра размера системного текста. (Унаследовано от Control)
KeyboardAcceleratorPlacementMode	Возвращает или задает значение, указывающее, отображается ли подсказка элемента управления сочетание клавиш для связанного акселератора клавиатуры. (Унаследовано от UIElement)
KeyboardAcceleratorPlacementTarget	Возвращает или задает значение, указывающее подсказку элемента управления, отображающую сочетание клавиш акселератора. (Унаследовано от UIElement)
KeyboardAccelerators	Возвращает коллекцию сочетаний клавиш, которые вызывают действие с помощью клавиатуры. Ускорители обычно назначаются кнопкам или элементам меню. Пример меню с акселераторами клавиатуры для различных элементов меню (Унаследовано от UIElement)
KeyTipHorizontalOffset	Возвращает или задает значение, указывающее, насколько слева или справа подсказка ключа помещается в отношение uiElement. (Унаследовано от UIElement)
KeyTipPlacementMode	Возвращает или задает значение, указывающее, где находится подсказка ключа доступа относительно границы UIElement. (Унаследовано от UIElement)
KeyTipTarget	Возвращает или задает значение, указывающее элемент, предназначенный для подсказки ключа доступа. (Унаследовано от UIElement)
KeyTipVerticalOffset	Возвращает или задает значение, указывающее, насколько далеко вверх или вниз подсказка помещается в отношение к элементу пользовательского интерфейса. (Унаследовано от UIElement)
Language	Возвращает или задает сведения о языке локализации и глобализации, которые применяются к FrameworkElement, а также ко всем дочерним элементам текущего FrameworkElement в представлении объекта и пользовательском интерфейсе. (Унаследовано от FrameworkElement)
Lights	Возвращает коллекцию объектов XamlLight , присоединенных к этому элементу. (Унаследовано от UIElement)
ManipulationMode	Возвращает или задает значение ManipulationModes , используемое для поведения uiElement и взаимодействия с жестами. Задание этого значения позволяет обрабатывать события манипуляции из этого элемента в коде приложения. (Унаследовано от UIElement)
Margin	Возвращает или задает внешнее поле FrameworkElement. (Унаследовано от FrameworkElement)
MaxHeight	Возвращает или задает максимальное ограничение высоты frameworkElement. (Унаследовано от FrameworkElement)
Maximum	Возвращает или задает максимально допустимое значение элемента диапазона.
MaximumProperty	Определяет свойство Максимальной зависимости.
MaxWidth	Возвращает или задает максимальное ограничение ширины frameworkElement. (Унаследовано от FrameworkElement)
MinHeight	Возвращает или задает минимальное ограничение высоты платформы FrameworkElement. (Унаследовано от FrameworkElement)
Minimum	Возвращает или задает минимально допустимое значение элемента диапазона.
MinimumProperty	Определяет свойство минимальной зависимости.
MinWidth	Возвращает или задает минимальное ограничение ширины frameworkElement. (Унаследовано от FrameworkElement)
Name	Возвращает или задает идентификатор имени объекта. Когда обработчик XAML создает дерево объектов из разметки XAML, код времени выполнения может ссылаться на объект, объявленный XAML, по этому имени. (Унаследовано от FrameworkElement)
Opacity	Возвращает или задает степень непрозрачности объекта. (Унаследовано от UIElement)
OpacityTransition	Возвращает или задает ScalarTransition, который анимирует изменения свойства Opacity. (Унаследовано от UIElement)
Padding	Возвращает или задает заполнение внутри элемента управления. (Унаследовано от Control)
Parent	Возвращает родительский объект этого FrameworkElement в дереве объектов. (Унаследовано от FrameworkElement)
PointerCaptures	Возвращает набор всех захваченных указателей, представленных как значения указателя . (Унаследовано от UIElement)
Projection	Получает или задает проекцию перспективы (эффект 3-D), применяемую при отрисовке этого элемента. (Унаследовано от UIElement)
ProtectedCursor	Возвращает или задает курсор, отображающийся, когда указатель находится над этим элементом. По умолчанию имеет значение NULL, указывающее, что курсор не изменяется. (Унаследовано от UIElement)
RasterizationScale	Возвращает значение, представляющее дополнительный коэффициент масштабирования, используемый при отрисовке фигур, изображений, текста или мультимедиа, как правило, для отрисовки в более высоком разрешении, чем обычно. (Унаследовано от UIElement)
RenderSize	Возвращает окончательный размер отрисовки пользовательского элемента UIElement. Использование не рекомендуется, см. примечания. (Унаследовано от UIElement)
RenderTransform	Возвращает или задает сведения о преобразовании, влияющие на положение отрисовки пользовательского элемента UIElement. (Унаследовано от UIElement)
RenderTransformOrigin	Возвращает или задает точку источника любого возможного преобразования отрисовки, объявленного RenderTransform, относительно границ uiElement. (Унаследовано от UIElement)
RequestedTheme	Возвращает или задает тему пользовательского интерфейса, используемую UIElement (и ее дочерними элементами) для определения ресурсов. Указанная тема RequestedTheme пользовательского интерфейса может переопределить запрошенную тему приложения. (Унаследовано от FrameworkElement)
RequiresPointer	Возвращает или задает, поддерживает ли элемент пользовательского интерфейса режим мыши, который эмулирует взаимодействие указателя с устройствами ввода без указателя, такими как клавиатура или игровой контроллер. (Унаследовано от Control)
Resources	Возвращает локально определенный словарь ресурсов. В XAML можно установить элементы ресурсов в качестве дочерних frameworkElement.Resources элементов объекта элемента свойства с помощью синтаксиса неявной коллекции XAML. (Унаследовано от FrameworkElement)
Rotation	Получает или задает угол поворота по часовой стрелке в градусах. Поворот по отношению к RotationAxis и CenterPoint. Влияет на положение отрисовки элемента. (Унаследовано от UIElement)
RotationAxis	Возвращает или задает ось для поворота элемента вокруг. (Унаследовано от UIElement)
RotationTransition	Возвращает или задает ScalarTransition, который анимирует изменения свойства "Поворот". (Унаследовано от UIElement)
Scale	Возвращает или задает масштаб элемента. Масштабируется относительно ЦентраPoint элемента. Влияет на положение отрисовки элемента. (Унаследовано от UIElement)
ScaleTransition	Возвращает или задает объект Vector3Transition, который анимирует изменения свойства Scale. (Унаследовано от UIElement)
Shadow	Возвращает или задает эффект тени, приведение к элементу. (Унаследовано от UIElement)
Style	Возвращает или задает стиль экземпляра, применяемый для этого объекта во время макета и отрисовки. (Унаследовано от FrameworkElement)
TabFocusNavigation	Возвращает или задает значение, которое изменяет работу табуляции и tabIndex для этого элемента управления. (Унаследовано от UIElement)
TabIndex	Возвращает или задает значение, определяющее порядок, в котором элементы получают фокус при переходе пользователя через элементы управления с помощью клавиши TAB . (Унаследовано от UIElement)
TabNavigation	Возвращает или задает значение, которое изменяет способ работы табуляции и UIElement.TabIndex для этого элемента управления. Note Для Windows 10 Creators Update (сборка 10.0.15063) и более поздней версии Свойство TabFocusNavigation доступно в базовом классе UIElement для включения объектов в последовательность вкладок, не использующих ControlTemplate. (Унаследовано от Control)
Tag	Возвращает или задает произвольное значение объекта, которое можно использовать для хранения пользовательских сведений об этом объекте. (Унаследовано от FrameworkElement)
Template	Возвращает или задает шаблон элемента управления. Шаблон элемента управления определяет визуальный вид элемента управления в пользовательском интерфейсе и определяется в разметке XAML. (Унаследовано от Control)
TemplateSettings	Возвращает объект, предоставляющий вычисляемые значения, на которые можно ссылаться как источники TemplateBinding при определении шаблонов для элемента управления ProgressRing .
Transform3D	Возвращает или задает эффект преобразования 3-D, применяемый при отрисовке этого элемента. (Унаследовано от UIElement)
TransformMatrix	Возвращает или задает матрицу преобразования, применяемую к элементу. (Унаследовано от UIElement)
Transitions	Возвращает или задает коллекцию элементов стиля перехода , которые применяются к UIElement. (Унаследовано от UIElement)
Translation	Возвращает или задает положение отрисовки элемента x, y и z. (Унаследовано от UIElement)
TranslationTransition	Возвращает или задает объект Vector3Transition, который анимирует изменения свойства Translation. (Унаследовано от UIElement)
Triggers	Возвращает коллекцию триггеров для анимаций, определенных для FrameworkElement. Часто не используется. См. примечания. (Унаследовано от FrameworkElement)
UseLayoutRounding	Возвращает или задает значение, определяющее, должна ли отрисовка объекта и его визуального поддерева использовать циклический режим, который выравнивает отрисовку по всему пикселям. (Унаследовано от UIElement)
UseSystemFocusVisuals	Возвращает или задает значение, указывающее, используется ли элемент управления визуальные элементы фокуса, рисуемые системой или визуальными элементами фокуса, определенными в шаблоне элемента управления. (Унаследовано от UIElement)
Value	Возвращает или задает текущую величину кольца хода выполнения.
ValueProperty	Определяет свойство зависимостей Value .
VerticalAlignment	Возвращает или задает характеристики вертикального выравнивания, применяемые к FrameworkElement , когда он состоит в родительском объекте, например панели или элемента управления элементами. (Унаследовано от FrameworkElement)
VerticalContentAlignment	Возвращает или задает вертикальное выравнивание содержимого элемента управления. (Унаследовано от Control)
Visibility	Возвращает или задает видимость uiElement. Объект UIElement , который не отображается, не отображается и не сообщает требуемому размеру макету. (Унаследовано от UIElement)
Width	Возвращает или задает ширину FrameworkElement. (Унаследовано от FrameworkElement)
XamlRoot	Возвращает или задает объект XamlRoot , в котором просматривается этот элемент. (Унаследовано от UIElement)
XYFocusDown	Получает или задает объект, который получает фокус, когда пользователь нажимает вниз на панели направления (D-pad) игрового контроллера. (Унаследовано от UIElement)
XYFocusDownNavigationStrategy	Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации вниз. (Унаследовано от UIElement)
XYFocusKeyboardNavigation	Возвращает или задает значение, которое включает или отключает навигацию с помощью клавишных стрелков. (Унаследовано от UIElement)
XYFocusLeft	Получает или задает объект, который получает фокус, когда пользователь нажимает слева на панели направления (D-pad) игрового контроллера. (Унаследовано от UIElement)
XYFocusLeftNavigationStrategy	Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации слева. (Унаследовано от UIElement)
XYFocusRight	Получает или задает объект, который получает фокус, когда пользователь нажимает прямо на панели направления (D-pad) игрового контроллера. (Унаследовано от UIElement)
XYFocusRightNavigationStrategy	Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента правой навигации. (Унаследовано от UIElement)
XYFocusUp	Возвращает или задает объект, который получает фокус, когда пользователь нажимает клавишу Directional Pad (D-pad) игрового контроллера. (Унаследовано от UIElement)
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)	Пытается задать фокус для этого элемента. (Унаследовано от UIElement)
GetAnimationBaseValue(DependencyProperty)	Возвращает любое базовое значение, установленное для свойства зависимостей, которое будет применяться в случаях, когда анимация не активна. (Унаследовано от DependencyObject)
GetBindingExpression(DependencyProperty)	Возвращает bindingExpression , представляющий привязку для указанного свойства. (Унаследовано от FrameworkElement)
GetChildrenInTabFocusOrder()	Позволяет подклассу UIElement предоставлять дочерние элементы, участвующие в фокусе TAB. (Унаследовано от UIElement)
GetTemplateChild(String)	Извлекает именованный элемент в экземплярном визуальном дереве ControlTemplate . (Унаследовано от Control)
GetValue(DependencyProperty)	Возвращает текущее эффективное значение свойства зависимостей из DependencyObject. (Унаследовано от DependencyObject)
GetVisualInternal()	Извлекает разрешение Visual элемента. (Унаследовано от UIElement)
GoToElementStateCore(String, Boolean)	При реализации в производном классе позволяет создавать визуальное дерево визуального дерева для шаблона элемента управления в коде, а не загружать XAML для всех состояний при запуске элемента управления. (Унаследовано от FrameworkElement)
InvalidateArrange()	Отменяет состояние упорядочивания (макет) для UIElement. После недопустимости uiElement будет обновлен его макет, который будет выполняться асинхронно. (Унаследовано от UIElement)
InvalidateMeasure()	Отменяет состояние измерения (макет) для UIElement. (Унаследовано от UIElement)
InvalidateViewport()	Отменяет состояние окна просмотра для пользовательского интерфейса, используемого для вычисления эффективного окна просмотра. (Унаследовано от FrameworkElement)
Measure(Size)	Обновляет элемент DesiredSizeпользовательского интерфейса. Как правило, объекты, реализующие настраиваемый макет для дочерних элементов макета, вызывают этот метод из собственных реализаций MeasureOverride для формирования рекурсивного обновления макета. (Унаследовано от UIElement)
MeasureOverride(Size)	Предоставляет поведение для прохода "Measure" цикла макета. Классы могут переопределить этот метод, чтобы определить собственное поведение передачи Measure. (Унаследовано от FrameworkElement)
OnApplyTemplate()	Вызывается всякий раз, когда код приложения или внутренние процессы (например, перестроение прохода макета) вызывают ApplyTemplate. В самых простых терминах это означает, что метод вызывается непосредственно перед отображением элемента пользовательского интерфейса в приложении. Переопределите этот метод, чтобы повлиять на логику после шаблона по умолчанию класса. (Унаследовано от FrameworkElement)
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)	Вызывается перед событием BringIntoViewRequested . (Унаследовано от UIElement)
OnCharacterReceived(CharacterReceivedRoutedEventArgs)	Вызывается перед событием CharacterReceived . (Унаследовано от Control)
OnCreateAutomationPeer()	При реализации в производном классе возвращает AutomationPeer реализации для инфраструктуры Microsoft UI Automation. (Унаследовано от 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)	Вызывается перед событием Холдинга . (Унаследовано от 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)	Вызывается непосредственно перед обработкой сочетания клавиш (или акселератора) в приложении. Вызывается всякий раз, когда код приложения или внутренние процессы вызывают ProcessKeyboardAccelerator. Переопределите этот метод, чтобы повлиять на обработку акселератора по умолчанию. (Унаследовано от UIElement)
OnRightTapped(RightTappedRoutedEventArgs)	Вызывается перед событием RightTapped . (Унаследовано от Control)
OnTapped(TappedRoutedEventArgs)	Вызывается перед событием "Касания ". (Унаследовано от 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()	Освобождает элемент управления из ограничений фокуса, поддерживающих взаимодействие с игровым контроллером (где IsFocusEngaged имеет значение true). (Унаследовано от 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)	Инициирует операцию перетаскивания. Important Не поддерживается, если пользователь запускает приложение в режиме с повышенными привилегиями, как администратор. (Унаследовано от 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	Происходит, как фокус освобождается из элемента управления, когда пользователь нажимает кнопку B/Back на игровом контроллере. (Унаследовано от Control)
FocusEngaged	Происходит, так как фокус ограничен элементом управления, когда пользователь нажимает кнопку A/Select на игровом контроллере. (Унаследовано от 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)
PointerCanceled	Происходит, когда указатель, который сделал контакт ненормально теряет контакт. (Унаследовано от UIElement)
PointerCaptureLost	Происходит, когда запись указателя, ранее удерживаемая этим элементом, перемещается в другой элемент или в другом месте. (Унаследовано от UIElement)
PointerEntered	Происходит, когда указатель входит в область теста попадания этого элемента. (Унаследовано от UIElement)
PointerExited	Происходит, когда указатель покидает область теста попадания этого элемента. (Унаследовано от UIElement)
PointerMoved	Происходит при перемещении указателя, пока указатель остается в области теста попадания этого элемента. (Унаследовано от UIElement)
PointerPressed	Происходит, когда устройство указателя инициирует действие Press в этом элементе. (Унаследовано от UIElement)
PointerReleased	Происходит при выпуске указателя устройства, инициированного ранее действием Press , в то время как в этом элементе. Обратите внимание, что конец действия прессы не гарантируется для запуска PointerReleased события; другие события могут запускаться вместо этого. Дополнительные сведения см. в разделе "Примечания". (Унаследовано от UIElement)
PointerWheelChanged	Происходит при изменении разностного значения колесика указателя. (Унаследовано от UIElement)
PreviewKeyDown	Происходит при нажатии клавиши клавиатуры, когда элемент UIElement имеет фокус. (Унаследовано от UIElement)
PreviewKeyUp	Происходит при выпуске клавиши клавиатуры, когда элемент UIElement имеет фокус. (Унаследовано от UIElement)
ProcessKeyboardAccelerators	Происходит при нажатии сочетания клавиш (или акселератора ). (Унаследовано от UIElement)
RightTapped	Происходит, когда стимул ввода правого касания происходит, пока указатель находится над элементом. (Унаследовано от UIElement)
SizeChanged	Происходит при изменении значения свойства ActualHeight или ActualWidth в FrameworkElement. (Унаследовано от FrameworkElement)
Tapped	Возникает, когда в противном случае необработанное взаимодействие касания происходит через область теста попадания этого элемента. (Унаследовано от UIElement)
Unloaded	Происходит, когда этот объект больше не подключен к дереву основного объекта. (Унаследовано от FrameworkElement)

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

• ProgressBar
• Обзор элементов управления ход выполнения
• Список элементов управления