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 : IconElementPublic Class AnimatedIcon
Inherits IconElement- Наследование
- Атрибуты
Примеры
Кончик
Дополнительные сведения, рекомендации по проектированию и примеры кода см. в анимированных значках.
Приложение коллекции WinUI 3
включает интерактивные примеры большинства элементов управления, функций и функций WinUI 3. Получите приложение из Microsoft Store или получите исходный код на GitHub
Добавление анимационного элемента в кнопку
В этом примере показана кнопка "Назад" со значком со стрелкой назад, который анимирует при возникновении событий указателя.
- AnimationBackVisualSource — это анимация со стрелками назад, предоставляемая WinUI.
-
FallbackIconSource используется, когда анимации не могут воспроизводиться. - Метод UIElement.AddHandler с
handledEventsTooдляtrueиспользуется для событий, которые кнопка помечает как PointerRoutedEventArgs.Handled.
<!--
xmlns:animatedvisuals="using:Microsoft.UI.Xaml.Controls.AnimatedVisuals"
-->
<AppBarButton x:Name="BackButton" Label="Back"
AnimatedIcon.State="Normal"
PointerEntered="AppBarButton_PointerEntered"
PointerExited="AppBarButton_PointerExited">
<AnimatedIcon>
<animatedvisuals:AnimatedBackVisualSource/>
<AnimatedIcon.FallbackIconSource>
<SymbolIconSource Symbol="Back"/>
</AnimatedIcon.FallbackIconSource>
</AnimatedIcon>
</AppBarButton>
// 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)
{
AnimatedIcon.SetState((UIElement)sender, "PointerOver");
}
private void AppBarButton_PointerPressed(object sender, PointerRoutedEventArgs e)
{
AnimatedIcon.SetState((UIElement)sender, "Pressed");
}
private void AppBarButton_PointerReleased(object sender, PointerRoutedEventArgs e)
{
AnimatedIcon.SetState((UIElement)sender, "Normal");
}
private void AppBarButton_PointerExited(object sender, PointerRoutedEventArgs e)
{
AnimatedIcon.SetState((UIElement)sender, "Normal");
}
Комментарии
Задайте свойство AnimatedIcon.Source, чтобы указать анимированный визуальный элемент для значка. WinUI предоставляет анимированные визуальные элементы для некоторых распространенных значков в пространстве имен Microsoft.UI.Xaml.Controls.AnimatedVisuals пространства имен.
В некоторых случаях параметры системы или ограничения могут препятствовать анимации значка.
- Если пользователь отключает анимацию в параметрах системы,
AnimatedIconотображает окончательный кадр перехода состояния, в котором был включен элемент управления. - Укажите FallbackIconSource использовать, если анимации не поддерживаются, например в старых версиях Windows, которые не поддерживают анимацию Lottie.
Пользовательские анимации
Вы можете создавать пользовательские анимации для использования в качестве анимированного значка в приложении. Анимации можно создавать с помощью Adobe AfterEffects, а затем использовать эти выходные данные с библиотекой Lottie-Windows для создания пользовательского класса, реализующего IAnimatedVisualSource2. Этот класс можно использовать в качестве исходного для анимированного значка. Дополнительные сведения см. в разделе Use Lottie для создания анимированного содержимого дляанимированного элемента.
Управление состоянием анимированного значка
Вы изменяете положение воспроизведения и состояние анимации, задав присоединенное свойство AnimationIcon.State. Свойство состояния принимает строковое значение, описывающее визуальное состояние, например "Normal", "PointerOver" или "Pressed". Можно также указать определенный переход состояния, например "PressedToNormal".
Анимированный значок исходного содержит маркеры, которые сопоставляют позицию в временной шкале анимации с визуальным состоянием. Строковые значения, поддерживаемые Source для задания присоединенного свойства State, определяются в коллекции Markers. Дополнительные сведения см. в разделе Определение маркеров анимированного икона.
Анимированные визуальные источники, используемые в шаблонах элементов управления, часто имеют более сложный набор Markers, которые сопоставляются с состояниями управления, в то время как анимированные визуальные элементы для более общего использования часто имеют более простой набор Markers, которые сопоставляются с событиями указателя.
Где задать состояние
Свойство можно задать на AnimatedIcon или предке в дереве XAML. В любом случае необходимо использовать синтаксис присоединенного свойства, как показано ниже.
<AnimatedIcon AnimatedIcon.State="Normal">...</AnimatedIcon>
Важный
Если добавить AnimatedIcon в дерево XAML и задать свойство State для элемента предка, свойство State должно быть задано начальное значение, прежде чем анимированный значок сначала загружается, чтобы значок был анимирован. Обычно вы задаете начальное состояние в XAML, как показано здесь.
<StackPanel AnimatedIcon.State="Normal" ...>
<AnimatedIcon>
<animatedvisuals:AnimatedBackVisualSource/>
</AnimatedIcon>
</StackPanel>
Использование визуальных состояний
Вы можете добавить AnimatedIcon в ControlTemplate элемента управления XAML и использовать VisualStateManager для задания его состояния. Некоторые элементы управления, такие как NavigationViewItem, автоматически задают состояние для AnimatedIcon, заданного в качестве значка.
Чтобы просмотреть пример, который задает AnimatedIcon.State в визуальном состоянии шаблона элемента управления, см. шаблон по умолчанию для CheckBox. Элемент управления 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 или другой элемент управления с событием Click, события PointerPressed и PointerReleased помечены как PointerRoutedEventArgs.Handled. Чтобы обрабатывать эти события на кнопке, используйте метод UIElement.AddHandler для подключения обработчика событий и указания handledEventsToo как true. Используйте UIElement.RemoveHandler для отключения обработчика событий.
См. раздел "Примеры" для примера кода, демонстрирующего эти обработчики событий.
Присоединенные свойства XAML
Для поддержки доступа процессора XAML к присоединенным свойствам, а также для предоставления эквивалентных получения и задания операций с кодом, каждое присоединенное свойство XAML имеет пару методов доступа Get и Set. Другой способ получить или задать значение в коде — использовать систему свойств зависимостей, вызывая GetValue или SetValue и передав поле идентификатора в качестве идентификатора свойства зависимостей.
Конструкторы
| AnimatedIcon() |
Инициализирует новый экземпляр класса AnimatedIcon. |
Свойства
| 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) |
| BaseUri |
Возвращает универсальный идентификатор ресурса (URI), представляющий базовый URI для объекта XAML, созданного во время загрузки XAML. Это свойство полезно для разрешения URI во время выполнения. (Унаследовано от FrameworkElement) |
| CacheMode |
Возвращает или задает значение, указывающее, что отображаемое содержимое должно кэшироваться как составное растровое изображение, когда это возможно. (Унаследовано от UIElement) |
| CanBeScrollAnchor |
Возвращает или задает значение, указывающее, может ли UIElement быть кандидатом на привязку прокрутки. (Унаследовано от UIElement) |
| CanDrag |
Возвращает или задает значение, указывающее, можно ли перетаскивать элемент в виде данных в операции перетаскивания. (Унаследовано от UIElement) |
| CenterPoint |
Возвращает или задает центральную точку элемента, которая является точкой, в которой происходит поворот или масштабирование. Влияет на положение отрисовки элемента. (Унаследовано от UIElement) |
| Clip |
Возвращает или задает |
| 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 |
| IsHitTestVisible |
Возвращает или задает, может ли содержащаяся область этого UIElement возвращать истинные значения для тестирования попаданий. (Унаследовано от UIElement) |
| IsHoldingEnabled |
Возвращает или задает значение, определяющее, может ли событие Holding исходить из этого элемента. (Унаследовано от UIElement) |
| IsLoaded |
Возвращает значение, указывающее, был ли элемент добавлен в дерево элементов и готов к взаимодействию. (Унаследовано от FrameworkElement) |
| IsRightTapEnabled |
Возвращает или задает значение, определяющее, может ли событие rightTapped |
| IsTabStop |
Возвращает или задает значение, указывающее, включен ли элемент управления в навигацию по вкладкам. (Унаследовано от UIElement) |
| IsTapEnabled |
Возвращает или задает значение, определяющее, может ли событие |
| 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 |
| MirroredWhenRightToLeftProperty |
Определяет свойство зависимостей MirroredWhenRightToLeft. |
| Name |
Возвращает или задает идентификатор имени объекта. Когда обработчик XAML создает дерево объектов из разметки XAML, код времени выполнения может ссылаться на объект, объявленный XAML, по этому имени. (Унаследовано от FrameworkElement) |
| Opacity |
Возвращает или задает степень непрозрачности объекта. (Унаследовано от UIElement) |
| OpacityTransition |
Возвращает или задает ScalarTransition, который анимирует изменения свойства Opacity. (Унаследовано от UIElement) |
| 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 (и ее дочерние элементы) для определения ресурсов. Тема пользовательского интерфейса, указанная с помощью |
| Resources |
Возвращает локально определенный словарь ресурсов. В XAML можно установить элементы ресурсов в качестве дочерних элементов объекта элемента свойства |
| Rotation |
Получает или задает угол поворота по часовой стрелке в градусах. Поворот по отношению к RotationAxis и CenterPoint. Влияет на положение отрисовки элемента. (Унаследовано от UIElement) |
| RotationAxis |
Возвращает или задает ось для поворота элемента вокруг. (Унаследовано от UIElement) |
| RotationTransition |
Возвращает или задает ScalarTransition, который анимирует изменения свойства "Поворот". (Унаследовано от UIElement) |
| Scale |
Возвращает или задает масштаб элемента. Масштабируется относительно ЦентраPoint элемента. Влияет на положение отрисовки элемента. (Унаследовано от UIElement) |
| ScaleTransition |
Возвращает или задает объект Vector3Transition, который анимирует изменения свойства Scale. (Унаследовано от UIElement) |
| Shadow |
Возвращает или задает эффект тени, приведение к элементу. (Унаследовано от UIElement) |
| Source |
Возвращает или задает анимированный визуальный элемент, отображаемый объектом |
| SourceProperty |
Определяет свойство зависимостей источника |
| StateProperty |
Определяет присоединенное свойство XAML AnimatedIcon.State XAML. |
| Style |
Возвращает или задает стиля экземпляра |
| TabFocusNavigation |
Возвращает или задает значение, которое изменяет способ работы табуляции и TabIndex для этого элемента управления. (Унаследовано от UIElement) |
| TabIndex |
Возвращает или задает значение, определяющее порядок, в котором элементы получают фокус при переходе пользователя через элементы управления с помощью клавиши tab tab. (Унаследовано от UIElement) |
| Tag |
Возвращает или задает произвольное значение объекта, которое можно использовать для хранения пользовательских сведений об этом объекте. (Унаследовано от FrameworkElement) |
| Transform3D |
Возвращает или задает эффект преобразования 3-D, применяемый при отрисовке этого элемента. (Унаследовано от UIElement) |
| TransformMatrix |
Возвращает или задает матрицу преобразования, применяемую к элементу. (Унаследовано от UIElement) |
| Transitions |
Возвращает или задает коллекцию элементов стиля перехода |
| 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 |
Возвращает или задает объект, который получает фокус, когда пользователь нажимает клавишу Directional Pad (D-pad) игрового контроллера. (Унаследовано от UIElement) |
| XYFocusUpNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации вверх. (Унаследовано от UIElement) |
Присоединенные свойства
| State |
Свойство, которое разработчик задает в АнимированномIcon. |
Методы
| AddHandler(RoutedEvent, Object, Boolean) |
Добавляет перенаправленный обработчик событий для указанного перенаправленного события, добавив обработчик в коллекцию обработчика текущего элемента. Укажите |
| Arrange(Rect) |
Позиционирует дочерние объекты и определяет размер UIElement. Родительские объекты, реализующие пользовательский макет для дочерних элементов, должны вызывать этот метод из реализации переопределения макета, чтобы сформировать рекурсивное обновление макета. (Унаследовано от UIElement) |
| ArrangeOverride(Size) |
Предоставляет поведение для передачи макета "Упорядочить". Классы могут переопределить этот метод, чтобы определить собственное поведение передачи "Упорядочить". (Унаследовано от FrameworkElement) |
| CancelDirectManipulations() |
Отменяет текущую прямую обработку манипуляций (системное сдвига и масштабирование) на любом родительском элементе ScrollViewer |
| 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) |
Обновляет DesiredSizeUIElement. Как правило, объекты, реализующие настраиваемый макет для дочерних элементов макета, вызывают этот метод из собственных реализации MeasureOverride для формирования рекурсивного обновления макета. (Унаследовано от UIElement) |
| MeasureOverride(Size) |
Предоставляет поведение для прохода "Measure" цикла макета. Классы могут переопределить этот метод, чтобы определить собственное поведение передачи Measure. (Унаследовано от FrameworkElement) |
| OnApplyTemplate() |
Вызывается всякий раз, когда код приложения или внутренние процессы (например, перестроение передачи макета) вызывается ApplyTemplate. В самых простых терминах это означает, что метод вызывается непосредственно перед отображением элемента пользовательского интерфейса в приложении. Переопределите этот метод, чтобы повлиять на логику после шаблона по умолчанию класса. (Унаследовано от FrameworkElement) |
| OnBringIntoViewRequested(BringIntoViewRequestedEventArgs) |
Вызывается перед событием BringIntoViewRequested. (Унаследовано от UIElement) |
| OnCreateAutomationPeer() |
При реализации в производном классе возвращает конкретные классы реализации AutomationPeer для инфраструктуры автоматизации пользовательского интерфейса Майкрософт. (Унаследовано от UIElement) |
| OnDisconnectVisualChildren() |
Переопределите этот метод, чтобы реализовать поведение макета и логики при удалении элементов из содержимого определенного класса или дочернего свойства. (Унаследовано от UIElement) |
| OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs) |
Вызывается, когда сочетания клавиш (или акселератор) обрабатывается в приложении. Переопределите этот метод для обработки реагирования приложения при вызове акселератора клавиатуры. (Унаследовано от UIElement) |
| OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) |
Вызывается непосредственно перед обработкой |
| PopulatePropertyInfo(String, AnimationPropertyInfo) |
Определяет свойство, которое может быть анимировано. (Унаследовано от UIElement) |
| PopulatePropertyInfoOverride(String, AnimationPropertyInfo) |
При переопределении в производном классе определяет свойство, которое может быть анимировано. (Унаследовано от UIElement) |
| ReadLocalValue(DependencyProperty) |
Возвращает локальное значение свойства зависимостей, если задано локальное значение. (Унаследовано от DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Регистрирует функцию уведомлений для прослушивания изменений в определенном экземпляре DependencyProperty в этом экземпляре DependencyObj ect. (Унаследовано от DependencyObject) |
| ReleasePointerCapture(Pointer) |
Освобождает записи указателя для записи одного конкретного указателя на этот UIElement. (Унаследовано от UIElement) |
| ReleasePointerCaptures() |
Освобождает все записи указателя, удерживаемые этим элементом. (Унаследовано от UIElement) |
| RemoveHandler(RoutedEvent, Object) |
Удаляет указанный обработчик перенаправленных событий из этого UIElement. Обычно обработчик был добавлен AddHandler. (Унаследовано от UIElement) |
| 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 |
Происходит, когда |
| 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 |
Происходит при нажатии |
| RightTapped |
Происходит, когда стимул ввода правого касания происходит, пока указатель находится над элементом. (Унаследовано от UIElement) |
| SizeChanged |
Происходит при изменении значения свойства ActualHeight или ActualWidth для FrameworkElement. (Унаследовано от FrameworkElement) |
| Tapped |
Происходит, если в противном случае необработанные касание взаимодействие происходит через область тестирования этого элемента. (Унаследовано от UIElement) |
| Unloaded |
Происходит, когда этот объект больше не подключен к дереву основного объекта. (Унаследовано от FrameworkElement) |