AnimatedIcon Класс

Ссылка

Определение

Пространство имен:: Microsoft.UI.Xaml.Controls

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Изменить

Представляет значок, который отображает и управляет визуальным элементом, который может анимироваться в ответ на изменения взаимодействия пользователя и визуального состояния.

/// [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

Наследование: Object IInspectable DependencyObject UIElement FrameworkElement IconElement AnimatedIcon

Атрибуты: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Примеры

Кончик

Дополнительные сведения, рекомендации по проектированию и примеры кода см. в анимированных значках.

Откройте приложение коллекции WinUI 3 и просмотрите анимированныйIcon в действии.

Приложение коллекции 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 к присоединенным свойствам, а также для предоставления эквивалентных получения и задания операций с кодом, каждое присоединенное свойство 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	Возвращает или задает rectangleGeometry, используемый для определения структуры содержимого UIElement. (Унаследовано от UIElement)
CompositeMode	Возвращает или задает свойство, которое объявляет альтернативные режимы композиции и смешивания для элемента в родительском макете и окне. Это относится к элементам, участвующим в смешанном пользовательском интерфейсе XAML или Microsoft DirectX. (Унаследовано от UIElement)
ContextFlyout	Возвращает или задает всплывающий элемент, связанный с этим элементом. (Унаследовано от UIElement)
DataContext	Возвращает или задает контекст данных для FrameworkElement. Обычно используется контекст данных, когда `FrameworkElement` использует расширение разметки {Binding} и участвует в привязке данных. (Унаследовано от FrameworkElement)
DesiredSize	Возвращает размер, который этот UIElement вычисляется во время прохождения меры процесса макета. (Унаследовано от UIElement)
Dispatcher	Всегда возвращает `null` в приложении пакета SDK для приложений windows. Вместо этого используйте DispatcherQueue. (Унаследовано от DependencyObject)
DispatcherQueue	Возвращает `DispatcherQueue`, с которым связан этот объект. `DispatcherQueue` представляет собой объект, который может получить доступ к `DependencyObject` в потоке пользовательского интерфейса, даже если код инициируется потоком, отличным от пользовательского интерфейса. (Унаследовано от DependencyObject)
ExitDisplayModeOnAccessKeyInvoked	Возвращает или задает значение, указывающее, закрывается ли отображение ключа доступа при вызове ключа доступа. (Унаследовано от UIElement)
FallbackIconSource	Возвращает или задает статический значок, используемый при невозможности запуска анимированного значка.
FallbackIconSourceProperty	Определяет свойство зависимости FallbackIconSource.
FlowDirection	Получает или задает направление, в котором поток текста и других элементов пользовательского интерфейса в любом родительском элементе, который управляет их макетом. Это свойство можно задать как `LeftToRight`, так и `RightToLeft`. Установка `FlowDirectionRightToLeft` для любого элемента задает выравнивание справа, порядок чтения справа налево и макет элемента управления вправо налево. (Унаследовано от FrameworkElement)
FocusState	Возвращает значение, указывающее, имеет ли этот элемент управления фокус и режим получения фокуса. (Унаследовано от UIElement)
FocusVisualMargin	Возвращает или задает внешнее поле визуального элемента фокуса для FrameworkElement. (Унаследовано от FrameworkElement)
FocusVisualPrimaryBrush	Получает или задает кисть, используемую для рисования внешней границы визуального элемента `HighVisibility` или `Reveal` фокуса для FrameworkElement. (Унаследовано от FrameworkElement)
FocusVisualPrimaryThickness	Возвращает или задает толщину внешней границы визуального элемента `HighVisibility` или `Reveal` фокуса для FrameworkElement. (Унаследовано от FrameworkElement)
FocusVisualSecondaryBrush	Возвращает или задает кисть, используемую для рисования внутренней границы визуального элемента фокуса `HighVisibility` или `Reveal` для FrameworkElement. (Унаследовано от FrameworkElement)
FocusVisualSecondaryThickness	Возвращает или задает толщину внутренней границы визуального элемента `HighVisibility` или `Reveal` фокуса для FrameworkElement. (Унаследовано от FrameworkElement)
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 RightTapped исходить из этого элемента. (Унаследовано от UIElement)
IsTabStop	Возвращает или задает значение, указывающее, включен ли элемент управления в навигацию по вкладкам. (Унаследовано от UIElement)
IsTapEnabled	Возвращает или задает значение, определяющее, может ли событие из этого элемента. (Унаследовано от UIElement)
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)
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	Получает или задает проекцию перспективы (эффект 3-D), применяемую при отрисовке этого элемента. (Унаследовано от UIElement)
ProtectedCursor	Возвращает или задает курсор, отображающийся, когда указатель находится над этим элементом. По умолчанию имеет значение NULL, указывающее, что курсор не изменяется. (Унаследовано от UIElement)
RasterizationScale	Возвращает значение, представляющее количество необработанных (физических) пикселей для каждого пикселя представления. (Унаследовано от UIElement)
RenderSize	Возвращает окончательный размер отрисовки UIElement. Использование не рекомендуется, см. примечания. (Унаследовано от UIElement)
RenderTransform	Возвращает или задает сведения о преобразовании, влияющие на положение отрисовки UIElement. (Унаследовано от UIElement)
RenderTransformOrigin	Возвращает или задает точку источника любого возможного преобразования отрисовки, объявленного RenderTransformотносительно границ UIElement. (Унаследовано от UIElement)
RequestedTheme	Возвращает или задает тему пользовательского интерфейса, используемую UIElement (и ее дочерние элементы) для определения ресурсов. Тема пользовательского интерфейса, указанная с помощью `RequestedTheme`, может переопределить уровня приложения. (Унаследовано от FrameworkElement)
Resources	Возвращает локально определенный словарь ресурсов. В XAML можно установить элементы ресурсов в качестве дочерних элементов объекта элемента свойства `frameworkElement.Resources` с помощью синтаксиса неявной коллекции XAML. (Унаследовано от FrameworkElement)
Rotation	Получает или задает угол поворота по часовой стрелке в градусах. Поворот по отношению к RotationAxis и CenterPoint. Влияет на положение отрисовки элемента. (Унаследовано от UIElement)
RotationAxis	Возвращает или задает ось для поворота элемента вокруг. (Унаследовано от UIElement)
RotationTransition	Возвращает или задает ScalarTransition, который анимирует изменения свойства "Поворот". (Унаследовано от UIElement)
Scale	Возвращает или задает масштаб элемента. Масштабируется относительно ЦентраPoint элемента. Влияет на положение отрисовки элемента. (Унаследовано от UIElement)
ScaleTransition	Возвращает или задает объект Vector3Transition, который анимирует изменения свойства Scale. (Унаследовано от UIElement)
Shadow	Возвращает или задает эффект тени, приведение к элементу. (Унаследовано от UIElement)
Source	Возвращает или задает анимированный визуальный элемент, отображаемый объектом `AnimatedIcon`.
SourceProperty	Определяет свойство зависимостей источника .
StateProperty	Определяет присоединенное свойство XAML AnimatedIcon.State XAML.
Style	Возвращает или задает стиля экземпляра , который применяется для этого объекта во время макета и отрисовки. (Унаследовано от FrameworkElement)
TabFocusNavigation	Возвращает или задает значение, которое изменяет способ работы табуляции и TabIndex для этого элемента управления. (Унаследовано от UIElement)
TabIndex	Возвращает или задает значение, определяющее порядок, в котором элементы получают фокус при переходе пользователя через элементы управления с помощью клавиши tab tab. (Унаследовано от UIElement)
Tag	Возвращает или задает произвольное значение объекта, которое можно использовать для хранения пользовательских сведений об этом объекте. (Унаследовано от FrameworkElement)
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)
VerticalAlignment	Возвращает или задает характеристики вертикального выравнивания, применяемые к FrameworkElement при создании в родительском объекте, например панели или элемента управления элементами. (Унаследовано от FrameworkElement)
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)

Присоединенные свойства

State

Свойство, которое разработчик задает в АнимированномIcon.

Методы

AddHandler(RoutedEvent, Object, Boolean)	Добавляет перенаправленный обработчик событий для указанного перенаправленного события, добавив обработчик в коллекцию обработчика текущего элемента. Укажите `handledEventsToo` как `true` для вызова предоставленного обработчика, даже если событие обрабатывается в другом месте. (Унаследовано от UIElement)
Arrange(Rect)	Позиционирует дочерние объекты и определяет размер UIElement. Родительские объекты, реализующие пользовательский макет для дочерних элементов, должны вызывать этот метод из реализации переопределения макета, чтобы сформировать рекурсивное обновление макета. (Унаследовано от UIElement)
ArrangeOverride(Size)	Предоставляет поведение для передачи макета "Упорядочить". Классы могут переопределить этот метод, чтобы определить собственное поведение передачи "Упорядочить". (Унаследовано от FrameworkElement)
CancelDirectManipulations()	Отменяет текущую прямую обработку манипуляций (системное сдвига и масштабирование) на любом родительском элементе ScrollViewer 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()	Извлекает `Visual`, к которому разрешается элемент. (Унаследовано от UIElement)
GoToElementStateCore(String, Boolean)	При реализации в производном классе позволяет создавать визуальное дерево визуального дерева для шаблона элемента управления в коде, а не загружать XAML для всех состояний при запуске элемента управления. (Унаследовано от FrameworkElement)
InvalidateArrange()	Недопустимое состояние упорядочивания (макет) для UIElement. После недопустимости UIElement будет обновлен его макет, который будет выполняться асинхронно. (Унаследовано от UIElement)
InvalidateMeasure()	Отменяет состояние измерения (макет) для UIElement. (Унаследовано от UIElement)
InvalidateViewport()	Отменяет состояние окна просмотра для UIElement, который используется для вычисления эффективногопредставления. (Унаследовано от FrameworkElement)
Measure(Size)	Обновляет DesiredSize UIElement. Как правило, объекты, реализующие настраиваемый макет для дочерних элементов макета, вызывают этот метод из собственных реализации MeasureOverride для формирования рекурсивного обновления макета. (Унаследовано от UIElement)
MeasureOverride(Size)	Предоставляет поведение для прохода "Measure" цикла макета. Классы могут переопределить этот метод, чтобы определить собственное поведение передачи Measure. (Унаследовано от FrameworkElement)
OnApplyTemplate()	Вызывается всякий раз, когда код приложения или внутренние процессы (например, перестроение передачи макета) вызывается ApplyTemplate. В самых простых терминах это означает, что метод вызывается непосредственно перед отображением элемента пользовательского интерфейса в приложении. Переопределите этот метод, чтобы повлиять на логику после шаблона по умолчанию класса. (Унаследовано от FrameworkElement)
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)	Вызывается перед событием BringIntoViewRequested. (Унаследовано от UIElement)
OnCreateAutomationPeer()	При реализации в производном классе возвращает конкретные классы реализации AutomationPeer для инфраструктуры автоматизации пользовательского интерфейса Майкрософт. (Унаследовано от UIElement)
OnDisconnectVisualChildren()	Переопределите этот метод, чтобы реализовать поведение макета и логики при удалении элементов из содержимого определенного класса или дочернего свойства. (Унаследовано от UIElement)
OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs)	Вызывается, когда сочетания клавиш (или акселератор) обрабатывается в приложении. Переопределите этот метод для обработки реагирования приложения при вызове акселератора клавиатуры. (Унаследовано от UIElement)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)	Вызывается непосредственно перед обработкой сочетания клавиш (или акселератора) в приложении. Вызывается всякий раз, когда код приложения или внутренние процессы вызывают ProcessKeyboardAccelerator. Переопределите этот метод, чтобы повлиять на обработку акселератора по умолчанию. (Унаследовано от UIElement)
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)	Инициирует операцию перетаскивания. Важный Не поддерживается, если пользователь запускает приложение в режиме с повышенными привилегиями, как администратор. (Унаследовано от 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)
GettingFocus	Происходит до UIElement получает фокус. Это событие вызывается синхронно, чтобы убедиться, что фокус не перемещается, пока событие бурно. (Унаследовано от UIElement)
GotFocus	Происходит, когда UIElement получает фокус. Это событие возникает асинхронно, поэтому фокус может снова перемещаться до завершения пузырьков. (Унаследовано от UIElement)
Holding	Происходит, когда в противном случае необработанные удержание происходит через область тестирования этого элемента. (Унаследовано от UIElement)
KeyDown	Происходит при нажатии клавиши клавиатуры во время фокуса UIElement. (Унаследовано от UIElement)
KeyUp	Происходит при выпуске клавиши клавиатуры во время фокуса UIElement. (Унаследовано от UIElement)
LayoutUpdated	Происходит при изменении макета визуального дерева из-за изменения значения свойств макета или другого действия, обновляющего макет. (Унаследовано от FrameworkElement)
Loaded	Происходит, когда FrameworkElement был создан и добавлен в дерево объектов и готов к взаимодействию. (Унаследовано от FrameworkElement)
Loading	Происходит, когда FrameworkElement начинает загружаться. (Унаследовано от FrameworkElement)
LosingFocus	Происходит до того, как UIElement теряет фокус. Это событие вызывается синхронно, чтобы убедиться, что фокус не перемещается, пока событие бурно. (Унаследовано от UIElement)
LostFocus	Происходит, когда UIElement теряет фокус. Это событие возникает асинхронно, поэтому фокус может снова перемещаться до завершения пузырьков. (Унаследовано от UIElement)
ManipulationCompleted	Происходит при завершении манипуляции с UIElement. (Унаследовано от UIElement)
ManipulationDelta	Происходит при изменении положения входного устройства во время манипуляции. (Унаследовано от UIElement)
ManipulationInertiaStarting	Происходит, когда входное устройство теряет контакт с объектом UIElement во время манипуляции и инерции начинается. (Унаследовано от UIElement)
ManipulationStarted	Происходит, когда устройство ввода начинает манипуляцию с UIElement. (Унаследовано от UIElement)
ManipulationStarting	Возникает при первом создании обработчика манипуляций. (Унаследовано от UIElement)
NoFocusCandidateFound	Происходит, когда пользователь пытается переместить фокус (с помощью табуляции или стрелки направления), но фокус не перемещается, так как в направлении перемещения не найден кандидат фокуса. (Унаследовано от UIElement)
PointerCanceled	Происходит, когда указатель, который сделал контакт ненормально теряет контакт. (Унаследовано от UIElement)
PointerCaptureLost	Происходит, когда запись указателя, ранее удерживаемая этим элементом, перемещается в другой элемент или в другом месте. (Унаследовано от UIElement)
PointerEntered	Происходит, когда указатель входит в область теста попадания этого элемента. (Унаследовано от UIElement)
PointerExited	Происходит, когда указатель покидает область теста попадания этого элемента. (Унаследовано от UIElement)
PointerMoved	Происходит при перемещении указателя, пока указатель остается в области теста попадания этого элемента. (Унаследовано от UIElement)
PointerPressed	Происходит, когда устройство указателя инициирует действие Нажатие в этом элементе. (Унаследовано от UIElement)
PointerReleased	Происходит при выпуске указателя устройства, которое ранее инициировало действие Нажатие, в то время как в этом элементе. Обратите внимание, что конец действия нажатия клавиши не гарантируется, что событие `PointerReleased`; Другие события могут вместо этого сработить. Дополнительные сведения см. в разделе "Примечания". (Унаследовано от UIElement)
PointerWheelChanged	Происходит при изменении разностного значения колесика указателя. (Унаследовано от UIElement)
PreviewKeyDown	Происходит при нажатии клавиши клавиатуры во время фокуса UIElement. (Унаследовано от UIElement)
PreviewKeyUp	Происходит при выпуске клавиши клавиатуры во время фокуса UIElement. (Унаследовано от UIElement)
ProcessKeyboardAccelerators	Происходит при нажатии сочетания клавиш (или акселератора). (Унаследовано от UIElement)
RightTapped	Происходит, когда стимул ввода правого касания происходит, пока указатель находится над элементом. (Унаследовано от UIElement)
SizeChanged	Происходит при изменении значения свойства ActualHeight или ActualWidth для FrameworkElement. (Унаследовано от FrameworkElement)
Tapped	Происходит, если в противном случае необработанные касание взаимодействие происходит через область тестирования этого элемента. (Унаследовано от UIElement)
Unloaded	Происходит, когда этот объект больше не подключен к дереву основного объекта. (Унаследовано от FrameworkElement)

Применяется к

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

Обратная связь

Были ли сведения на этой странице полезными?