AnimatedIcon Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет значок, который отображает и управляет визуальным элементом, который может анимироваться в ответ на взаимодействие с пользователем и изменение визуального состояния.
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 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="Source")]
class AnimatedIcon : IconElement
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 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="Source")]
public class AnimatedIcon : IconElement
Public Class AnimatedIcon
Inherits IconElement
- Наследование
- Атрибуты
Примеры
Совет
Дополнительные сведения, рекомендации по проектированию и примеры кода см. в разделе Анимированный значок.
Приложение "Коллекция WinUI 3" содержит интерактивные примеры большинства элементов управления, функций и функций WinUI 3. Получение приложения из Microsoft Store или исходный код на сайте GitHub
Добавление анимации в кнопку
В этом примере показана кнопка "Назад" со значком стрелки "Назад", которая анимирует события указателя.
- AnimationBackVisualSource — это анимация со стрелкой назад, предоставляемая WinUI.
- FallbackIconSource используется, когда не удается воспроизвести анимацию.
- Метод UIElement.AddHandler с заданным
handledEventsToo
значениемtrue
используется для событий, которые кнопка помечает как PointerRoutedEventArgs.Handled.
<!--
xmlns:muxc="using:Microsoft.UI.Xaml.Controls"
xmlns:animatedvisuals="using:Microsoft.UI.Xaml.Controls.AnimatedVisuals"
-->
<AppBarButton x:Name="BackButton" Label="Back"
muxc:AnimatedIcon.State="Normal"
PointerEntered="AppBarButton_PointerEntered"
PointerExited="AppBarButton_PointerExited">
<muxc:AnimatedIcon>
<animatedvisuals:AnimatedBackVisualSource/>
<muxc:AnimatedIcon.FallbackIconSource>
<muxc:SymbolIconSource Symbol="Back"/>
</muxc:AnimatedIcon.FallbackIconSource>
</muxc:AnimatedIcon>
</AppBarButton>
// using muxc = Microsoft.UI.Xaml.Controls;
// Add handlers.
protected override void OnNavigatedTo(NavigationEventArgs e)
{
SettingsButton.AddHandler(UIElement.PointerPressedEvent,
new PointerEventHandler(AppBarButton_PointerPressed), true);
SettingsButton.AddHandler(UIElement.PointerReleasedEvent,
new PointerEventHandler(AppBarButton_PointerReleased), true);
base.OnNavigatedTo(e);
}
// Remove handlers.
protected override void OnNavigatedFrom(NavigationEventArgs e)
{
SettingsButton.RemoveHandler(UIElement.PointerPressedEvent,
(PointerEventHandler)AppBarButton_PointerPressed);
SettingsButton.RemoveHandler(UIElement.PointerReleasedEvent,
(PointerEventHandler)AppBarButton_PointerReleased);
base.OnNavigatedFrom(e);
}
private void AppBarButton_PointerEntered(object sender, PointerRoutedEventArgs e)
{
muxc.AnimatedIcon.SetState((UIElement)sender, "PointerOver");
}
private void AppBarButton_PointerPressed(object sender, PointerRoutedEventArgs e)
{
muxc.AnimatedIcon.SetState((UIElement)sender, "Pressed");
}
private void AppBarButton_PointerReleased(object sender, PointerRoutedEventArgs e)
{
muxc.AnimatedIcon.SetState((UIElement)sender, "Normal");
}
private void AppBarButton_PointerExited(object sender, PointerRoutedEventArgs e)
{
muxc.AnimatedIcon.SetState((UIElement)sender, "Normal");
}
Комментарии
Задайте свойство AnimatedIcon.Source , чтобы указать анимированный визуальный элемент для значка. WinUI предоставляет анимированные визуальные элементы для некоторых распространенных значков в пространстве имен Microsoft.UI.Xaml.Controls.AnimatedVisuals .
В некоторых случаях параметры системы или ограничения могут препятствовать анимации значка.
- Если пользователь отключает анимацию в своих системных параметрах,
AnimatedIcon
отображает окончательный кадр перехода состояния, в котором находился элемент управления. - Укажите FallbackIconSource, который будет использоваться, если анимации не поддерживаются, например в более старых версиях Windows, которые не поддерживают анимации Lottie.
Пользовательские анимации
Вы можете создавать пользовательские анимации для использования в качестве значка анимации в приложении. Анимации можно создавать с помощью Adobe AfterEffects, а затем использовать эти выходные данные с библиотекой Lottie-Windows для создания пользовательского класса, реализующего IAnimatedVisualSource2. Этот класс можно использовать в качестве источника для анимированного значка. Дополнительные сведения см. в разделе Использование Lottie для создания анимированного содержимого для AnimatedIcon.
Управление состоянием анимированного значка
Чтобы изменить положение воспроизведения и состояние анимации, задав присоединенное свойство AnimatedIcon.State . Свойство state принимает строковое значение, описывающее визуальное состояние, например "Normal
", "PointerOver
" или "Pressed
". Можно также указать определенный переход состояния, например "PressedToNormal
".
Анимированный значок Источник содержит маркеры, которые сопоставляют положение в временная шкала анимации с визуальным состоянием. Строковые значения, которые поддерживаются Source
для задания присоединенного State
свойства, определяются в Markers
коллекции. Дополнительные сведения см. в разделе Определение маркеров AnimatedIcon.
Анимированные визуальные источники, используемые в шаблонах элементов управления, часто имеют более сложный набор этих сопоставлений Markers
с контрольными состояниями, в то время как анимированные визуальные элементы для более общего использования часто имеют более простой набор этих сопоставлений Markers
с событиями указателя.
Где задать состояние
Свойство можно задать для AnimatedIcon
или для предка в дереве XAML. В любом случае необходимо использовать синтаксис присоединенного свойства, как показано ниже:
<muxc:AnimatedIcon muxc:AnimatedIcon.State="Normal">...</muxc:AnimatedIcon>
Важно!
Если добавить в AnimatedIcon
дерево XAML и задать State
свойство для элемента-предка, State
свойство должно иметь начальное значение перед первой загрузкой анимированного значка, чтобы значок можно было анимировать. Как правило, начальное состояние задается в XAML, как показано ниже.
<StackPanel muxc:AnimatedIcon.State="Normal" ...>
<muxc:AnimatedIcon>
<animatedvisuals:AnimatedBackVisualSource/>
</muxc:AnimatedIcon>
</StackPanel>
Использование визуальных состояний
Вы можете добавить в AnimatedIcon
ControlTemplate
элемент управления XAML и использовать VisualStateManager для задания его состояния. Некоторые элементы управления, такие как NavigationViewItem, автоматически задают состояние для объекта , заданного AnimatedIcon
в качестве значка.
Пример, который задает AnimatedIcon.State
в визуальном состоянии шаблона элемента управления, см. в статье CheckBox_themeresources.xaml в репозитории WinUI GitHub. Элемент CheckBox
управления использует объект AnimatedAcceptVisualSource для проверка метки. Визуальные методы задания состояния выглядят следующим образом:
<VisualState x:Name="CheckedPointerOver">
...
<VisualState.Setters>
<Setter Target="CheckGlyph.(AnimatedIcon.State)" Value="PointerOverOn"/>
</VisualState.Setters>
</VisualState>
Обработка событий указателя
Чтобы реагировать AnimatedIcon
на взаимодействие с пользователем, необходимо задать присоединенное свойство AnimatedIcon.State в ответ на некоторые события указателя. В этой таблице показаны события указателя, которые обычно обрабатываются, и общие состояния, которые сопоставляют с этими событиями. (Однако не каждый источник анимированных значков будет точно соответствовать этим состояниям.)
Событие | Состояние |
---|---|
UIElement.PointerEntered | "PointerOver " |
UIElement.PointerPressed | "Pressed " |
UIElement.PointerReleased | "Normal " |
UIElement.PointerExited | "Normal " |
Совет
Если поместить AnimatedIcon
внутри элемента управления Button или другого элемента управления с событием PointerPressed
Click, события и PointerReleased
помечаются как PointerRoutedEventArgs.Handled. Чтобы обработать эти события на кнопке, используйте метод UIElement.AddHandler для подключения обработчика событий и укажите handledEventsToo
в качестве true
. Используйте UIElement.RemoveHandler , чтобы отключить обработчик событий.
Пример кода, демонстрирующий эти обработчики событий, см. в разделе Примеры.
Присоединенные свойства XAML
AnimatedIcon
— это класс службы узла для присоединенного свойства XAML.
Для поддержки доступа обработчика XAML к присоединенным свойствам, а также для предоставления коду эквивалентных операций получения и задания , каждое присоединенное свойство XAML имеет пару методов доступа Get и Set. Другой способ получить или задать значение в коде — использовать систему свойств зависимостей, вызывая метод GetValue или SetValue и передавая поле идентификатора в качестве идентификатора свойства зависимостей.
Конструкторы
AnimatedIcon() |
Инициализирует новый экземпляр класса AnimatedIcon . |
Свойства
AccessKey |
Возвращает или задает ключ доступа (мнемонический) для этого элемента. (Унаследовано от UIElement) |
AccessKeyScopeOwner |
Возвращает или задает исходный элемент, предоставляющий ключ доступа область для этого элемента, даже если он не находится в визуальном дереве исходного элемента. (Унаследовано от UIElement) |
ActualHeight |
Возвращает отрисованную высоту объекта FrameworkElement. См. заметки. (Унаследовано от FrameworkElement) |
ActualOffset |
Возвращает позицию этого элемента UIElement относительно его родительского элемента, вычисленного во время этапа упорядочения процесса макета. (Унаследовано от UIElement) |
ActualSize |
Возвращает размер, вычисленный этим элементом UIElement во время этапа упорядочения процесса макета. (Унаследовано от UIElement) |
ActualTheme |
Возвращает тему пользовательского интерфейса, которая в настоящее время используется элементом , который может отличаться от RequestedTheme. (Унаследовано от FrameworkElement) |
ActualWidth |
Возвращает отрисованную ширину элемента FrameworkElement. См. заметки. (Унаследовано от FrameworkElement) |
AllowDrop |
Возвращает или задает значение, определяющее, может ли этот элемент UIElement быть целевым объектом перетаскивания для операций перетаскивания. (Унаследовано от UIElement) |
AllowFocusOnInteraction |
Возвращает или задает значение, указывающее, получает ли элемент фокус автоматически, когда пользователь взаимодействует с ним. (Унаследовано от FrameworkElement) |
AllowFocusWhenDisabled |
Возвращает или задает значение, указывающее, может ли отключенный элемент управления получать фокус. (Унаследовано от FrameworkElement) |
BaseUri |
Возвращает универсальный код ресурса (URI), представляющий базовый URI для объекта, созданного в XAML, во время загрузки XAML. Это свойство полезно для разрешения URI во время выполнения. (Унаследовано от FrameworkElement) |
CacheMode |
Возвращает или задает значение, указывающее, что отображаемое содержимое должно быть кэшировано в виде составного растрового изображения, если это возможно. (Унаследовано от UIElement) |
CanBeScrollAnchor |
Возвращает или задает значение, указывающее, может ли UIElement быть кандидатом на привязку прокрутки. (Унаследовано от UIElement) |
CanDrag |
Возвращает или задает значение, указывающее, можно ли перетаскивать элемент как данные в операции перетаскивания. (Унаследовано от UIElement) |
CenterPoint |
Возвращает или задает центральную точку элемента, то есть точку, относительно которой происходит поворот или масштабирование. Влияет на позицию отрисовки элемента. (Унаследовано от UIElement) |
Clip |
Возвращает или задает объект RectangleGeometry, используемый для определения контура содержимого элемента UIElement. (Унаследовано от UIElement) |
CompositeMode |
Возвращает или задает свойство, объявляющее альтернативные режимы композиции и смешивания для элемента в родительском макете и окне. Это относится к элементам, участвующим в смешанном пользовательском интерфейсе XAML/Microsoft DirectX. (Унаследовано от UIElement) |
ContextFlyout |
Возвращает или задает всплывающий элемент, связанный с этим элементом. (Унаследовано от UIElement) |
DataContext |
Возвращает или задает контекст данных для FrameworkElement. Контекст данных часто используется, когда |
DesiredSize |
Возвращает размер, вычисленный этим элементом UIElement во время прохождения меры процесса макета. (Унаследовано от UIElement) |
Dispatcher |
Всегда возвращает в |
DispatcherQueue |
Возвращает объект , |
ExitDisplayModeOnAccessKeyInvoked |
Возвращает или задает значение, указывающее, закрывается ли отображение ключа доступа при вызове ключа доступа. (Унаследовано от UIElement) |
FallbackIconSource |
Возвращает или задает статический значок, используемый, если не удается запустить анимированный значок. |
FallbackIconSourceProperty |
Определяет свойство зависимости FallbackIconSource . |
FlowDirection |
Возвращает или задает направление, в котором текст и другие элементы пользовательского интерфейса передаются в любом родительском элементе, который управляет их макетом. Этому свойству можно присвоить значение |
FocusState |
Возвращает значение, указывающее, имеет ли этот элемент управления фокус, и режим, с помощью которого был получен фокус. (Унаследовано от UIElement) |
FocusVisualMargin |
Возвращает или задает внешнее поле визуального элемента фокуса для FrameworkElement. (Унаследовано от FrameworkElement) |
FocusVisualPrimaryBrush |
Возвращает или задает кисть, используемую для рисования внешней границы визуального |
FocusVisualPrimaryThickness |
Возвращает или задает толщину внешней границы визуального элемента или |
FocusVisualSecondaryBrush |
Получает или задает кисть, используемую для рисования внутренней границы визуального |
FocusVisualSecondaryThickness |
Возвращает или задает толщину внутренней границы визуального |
Foreground |
Возвращает или задает кисть, которая описывает основной цвет. (Унаследовано от IconElement) |
Height |
Возвращает или задает предполагаемую высоту объекта FrameworkElement. (Унаследовано от FrameworkElement) |
HighContrastAdjustment |
Возвращает или задает значение, указывающее, настраивает ли платформа автоматически визуальные свойства элемента при включении тем с высокой контрастностью. (Унаследовано от UIElement) |
HorizontalAlignment |
Возвращает или задает характеристики горизонтального выравнивания, применяемые к Объекту FrameworkElement при его создании в родительском элементе макета, например в элементе управления "Панель" или "Элементы". (Унаследовано от FrameworkElement) |
IsAccessKeyScope |
Возвращает или задает значение, указывающее, определяет ли элемент собственный ключ доступа область. (Унаследовано от UIElement) |
IsDoubleTapEnabled |
Возвращает или задает значение, определяющее, может ли событие DoubleTapped исходить из этого элемента. (Унаследовано от UIElement) |
IsHitTestVisible |
Возвращает или задает значение, указывающее, может ли автономная область этого элемента UIElement возвращать истинные значения для проверки попадания. (Унаследовано от UIElement) |
IsHoldingEnabled |
Возвращает или задает значение, определяющее, может ли событие Holding исходить из этого элемента. (Унаследовано от UIElement) |
IsLoaded |
Возвращает значение, указывающее, был ли элемент добавлен в дерево элементов и готов ли он к взаимодействию. (Унаследовано от FrameworkElement) |
IsRightTapEnabled |
Возвращает или задает значение, определяющее, может ли событие RightTapped исходить из этого элемента. (Унаследовано от UIElement) |
IsTabStop |
Возвращает или задает значение, показывающее, включается ли элемент управления в переходы по ТАВ. (Унаследовано от UIElement) |
IsTapEnabled |
Возвращает или задает значение, определяющее, может ли событие Tapped исходить из этого элемента. (Унаследовано от UIElement) |
KeyboardAcceleratorPlacementMode |
Возвращает или задает значение, указывающее, отображает ли подсказка элемента управления сочетание клавиш для связанного ускорителя клавиатуры. (Унаследовано от UIElement) |
KeyboardAcceleratorPlacementTarget |
Возвращает или задает значение, указывающее подсказку элемента управления, отображающую сочетание клавиш ускорителя. (Унаследовано от UIElement) |
KeyboardAccelerators |
Возвращает коллекцию сочетаний клавиш, которые вызывают действие с помощью клавиатуры. Ускорители обычно назначаются кнопкам или пунктам меню.
|
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) |
MaxWidth |
Возвращает или задает ограничение максимальной ширины объекта FrameworkElement. (Унаследовано от FrameworkElement) |
MinHeight |
Возвращает или задает ограничение минимальной высоты объекта FrameworkElement. (Унаследовано от FrameworkElement) |
MinWidth |
Возвращает или задает ограничение минимальной ширины объекта FrameworkElement. (Унаследовано от FrameworkElement) |
MirroredWhenRightToLeft |
Возвращает или задает значение, указывающее, отображается ли значок зеркальным отображением, если свойство FlowDirection имеет значение RightToLeft. |
MirroredWhenRightToLeftProperty |
Определяет свойство зависимостей MirroredWhenRightToLeft . |
Name |
Возвращает или задает идентифицирующие имя объекта. Когда обработчик XAML создает дерево объектов из разметки XAML, код времени выполнения может ссылаться на объект, объявленный XAML, с этим именем. (Унаследовано от FrameworkElement) |
Opacity |
Возвращает или задает степень непрозрачности объекта. (Унаследовано от UIElement) |
OpacityTransition |
Возвращает или задает ScalarTransition, который анимирует изменения в свойстве Opacity. (Унаследовано от UIElement) |
Parent |
Возвращает родительский объект этого элемента FrameworkElement в дереве объектов. (Унаследовано от FrameworkElement) |
PointerCaptures |
Возвращает набор всех захваченных указателей, представленных в виде значений указателя . (Унаследовано от UIElement) |
Projection |
Возвращает или задает перспективную проекцию (трехмерный эффект), применяемую при отрисовке этого элемента. (Унаследовано от UIElement) |
ProtectedCursor |
Возвращает или задает курсор, который отображается, когда указатель находится на этом элементе. По умолчанию имеет значение NULL, указывая на отсутствие изменений курсора. (Унаследовано от UIElement) |
RasterizationScale |
Возвращает значение, представляющее количество необработанных (физических) пикселей для каждого пикселя представления. (Унаследовано от UIElement) |
RenderSize |
Возвращает окончательный размер отрисовки элемента UIElement. Использовать не рекомендуется, см. примечания. (Унаследовано от UIElement) |
RenderTransform |
Возвращает или задает сведения о преобразовании, влияющие на положение отрисовки элемента UIElement. (Унаследовано от UIElement) |
RenderTransformOrigin |
Возвращает или задает исходную точку любого возможного преобразования отрисовки, объявленного RenderTransform, относительно границ UIElement. (Унаследовано от UIElement) |
RequestedTheme |
Возвращает или задает тему пользовательского интерфейса, используемую элементом UIElement (и его дочерними элементами) для определения ресурсов. Тема пользовательского интерфейса, указанная с помощью |
Resources |
Возвращает локально определенный словарь ресурсов. В XAML элементы ресурсов можно установить в качестве дочерних объектных |
Rotation |
Возвращает или задает угол поворота по часовой стрелке в градусах. Поворачивается относительно RotationAxis и CenterPoint. Влияет на позицию отрисовки элемента. (Унаследовано от UIElement) |
RotationAxis |
Возвращает или задает ось для поворота элемента вокруг. (Унаследовано от UIElement) |
RotationTransition |
Возвращает или задает scalarTransition, который анимирует изменения в свойстве Rotation. (Унаследовано от UIElement) |
Scale |
Возвращает или задает масштаб элемента. Масштабируется относительно элемента CenterPoint. Влияет на позицию отрисовки элемента. (Унаследовано от UIElement) |
ScaleTransition |
Возвращает или задает объект Vector3Transition, который анимирует изменения в свойстве Scale. (Унаследовано от UIElement) |
Shadow |
Возвращает или задает эффект тени, отбрасываемый элементом . (Унаследовано от UIElement) |
Source |
Возвращает или задает анимированный визуальный элемент, отображаемый |
SourceProperty |
Идентифицирует свойство зависимостей источника . |
StateProperty |
Определяет присоединенное свойство XAML AnimatedIcon.State . |
Style |
Возвращает или задает стиль экземпляра, применяемый к данному объекту во время макета и отрисовки. (Унаследовано от FrameworkElement) |
TabFocusNavigation |
Возвращает или задает значение, изменяющее работу tabbing и TabIndex для этого элемента управления. (Унаследовано от UIElement) |
TabIndex |
Возвращает или задает значение, определяющее порядок, в котором элементы получают фокус при переходе пользователя по элементам управления с помощью клавиши TAB . (Унаследовано от UIElement) |
Tag |
Возвращает или задает произвольное значение объекта, которое можно использовать для хранения пользовательских сведений об этом объекте. (Унаследовано от FrameworkElement) |
Transform3D |
Возвращает или задает эффект трехмерного преобразования, применяемый при отрисовке этого элемента. (Унаследовано от UIElement) |
TransformMatrix |
Возвращает или задает матрицу преобразования, применяемую к элементу . (Унаследовано от UIElement) |
Transitions |
Возвращает или задает коллекцию элементов стиля Перехода , которые применяются к UIElement. (Унаследовано от UIElement) |
Translation |
Возвращает или задает позицию отрисовки x, y и z элемента. (Унаследовано от UIElement) |
TranslationTransition |
Возвращает или задает объект Vector3Transition, который анимирует изменения в свойстве Translation. (Унаследовано от UIElement) |
Triggers |
Возвращает коллекцию триггеров для анимаций, определенных для FrameworkElement. Редко используется. См. заметки. (Унаследовано от FrameworkElement) |
UseLayoutRounding |
Возвращает или задает значение, определяющее, должна ли отрисовка объекта и его визуального поддереви использовать поведение округления, которое выравнивает отрисовку по целым пикселям. (Унаследовано от UIElement) |
UseSystemFocusVisuals |
Возвращает или задает значение, указывающее, использует ли элемент управления визуальные элементы фокуса, нарисованные системой, или визуальные элементы фокуса, определенные в шаблоне элемента управления. (Унаследовано от UIElement) |
VerticalAlignment |
Возвращает или задает характеристики вертикального выравнивания, применяемые к Объекту FrameworkElement при его создании в родительском объекте, например в элементе управления "Панель" или "Элементы". (Унаследовано от FrameworkElement) |
Visibility |
Возвращает или задает видимость uiElement. Невидимый |
Width |
Возвращает или задает ширину элемента FrameworkElement. (Унаследовано от FrameworkElement) |
XamlRoot |
Возвращает или задает объект , |
XYFocusDown |
Возвращает или задает объект, который получает фокус, когда пользователь нажимает на панель направления (D-pad) игрового контроллера. (Унаследовано от UIElement) |
XYFocusDownNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации вниз. (Унаследовано от UIElement) |
XYFocusKeyboardNavigation |
Возвращает или задает значение, которое включает или отключает навигацию с помощью стрелки направления клавиатуры. (Унаследовано от UIElement) |
XYFocusLeft |
Возвращает или задает объект, который получает фокус, когда пользователь нажимает кнопку слева на направленной панели (D-pad) игрового контроллера. (Унаследовано от UIElement) |
XYFocusLeftNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента левой навигации. (Унаследовано от UIElement) |
XYFocusRight |
Возвращает или задает объект, который получает фокус, когда пользователь нажимает прямо на панель направления (D-pad) игрового контроллера. (Унаследовано от UIElement) |
XYFocusRightNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента правильной навигации. (Унаследовано от UIElement) |
XYFocusUp |
Возвращает или задает объект, который получает фокус, когда пользователь нажимает кнопку управления направлением (D-pad) игрового контроллера. (Унаследовано от UIElement) |
XYFocusUpNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации вверх. (Унаследовано от UIElement) |
Присоединенные свойства
State |
Свойство, задающее разработчиком в AnimatedIcon. |
Методы
AddHandler(RoutedEvent, Object, Boolean) |
Добавляет обработчик перенаправленного события для указанного перенаправленного события, помещая этот обработчик в коллекцию обработчиков текущего элемента. Укажите |
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) |
GetState(DependencyObject) |
Извлекает значение присоединенного свойства AnimatedIcon.State для указанного Объекта DependencyObject. |
GetValue(DependencyProperty) |
Возвращает текущее действующее значение свойства зависимостей из DependencyObject. (Унаследовано от DependencyObject) |
GetVisualInternal() |
Извлекает объект , |
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 для конкретного класса для инфраструктуры Microsoft модель автоматизации пользовательского интерфейса. (Унаследовано от 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) |
SetState(DependencyObject, String) |
Задает значение присоединенного свойства AnimatedIcon.State для указанного Объекта DependencyObject. |
SetValue(DependencyProperty, Object) |
Задает локальное значение свойства зависимостей для Объекта DependencyObject. (Унаследовано от DependencyObject) |
StartAnimation(ICompositionAnimationBase) |
Начинает указанную анимацию в элементе . (Унаследовано от UIElement) |
StartBringIntoView() |
Инициирует запрос к платформе XAML, чтобы отобразить элемент в любых прокручиваемых регионах, в которые он содержится. (Унаследовано от UIElement) |
StartBringIntoView(BringIntoViewOptions) |
Инициирует запрос к платформе XAML для вывода элемента в представление с помощью указанных параметров. (Унаследовано от UIElement) |
StartDragAsync(ExpPointerPoint) |
Представляет значок, который отображает и управляет визуальным элементом, который может анимироваться в ответ на взаимодействие с пользователем и изменение визуального состояния. (Унаследовано от UIElement) |
StartDragAsync(PointerPoint) |
Инициирует операцию перетаскивания. Важно! Не поддерживается, если пользователь запускает приложение в режиме с повышенными привилегиями в качестве администратора. |
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) |
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 |
Происходит при освобождении устройства указателя, которое ранее инициировало действие Нажатие , в этом элементе. Обратите внимание, что окончание действия Нажатие не гарантирует, что событие будет вызываться |
PointerWheelChanged |
Происходит при изменении разностного значения колесика указателя. (Унаследовано от UIElement) |
PreviewKeyDown |
Происходит при нажатии клавиши клавиатуры, когда элемент UIElement находится в фокусе. (Унаследовано от UIElement) |
PreviewKeyUp |
Происходит при освобождении клавиши клавиатуры, когда элемент UIElement находится в фокусе. (Унаследовано от UIElement) |
ProcessKeyboardAccelerators |
Происходит при нажатии сочетания клавиш (или ускорителя ). (Унаследовано от UIElement) |
RightTapped |
Возникает при возникновении стимула ввода правой кнопкой касания, когда указатель находится над элементом. (Унаследовано от UIElement) |
SizeChanged |
Происходит при изменении значения свойства ActualHeight или ActualWidth в FrameworkElement. (Унаследовано от FrameworkElement) |
Tapped |
Происходит, когда в противном случае происходит необработанное взаимодействие касания в области проверки попадания этого элемента. (Унаследовано от UIElement) |
Unloaded |
Происходит, когда этот объект больше не подключен к дереву объектов main. (Унаследовано от FrameworkElement) |
Применяется к
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по