AnimatedIcon Classe

Référence

Définition

Espace de noms:: Microsoft.UI.Xaml.Controls

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Représente une icône qui affiche et contrôle un visuel qui peut s’animer en réponse aux modifications d’interaction utilisateur et d’état visuel.

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

Héritage: Object IInspectable DependencyObject UIElement FrameworkElement IconElement AnimatedIcon

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Exemples

Pourboire

Pour plus d’informations, des conseils de conception et des exemples de code, consultez icône Animée.

Ouvrir l’application galerie WinUI 3 et voir l’objet AnimatedIcon en action.

L’application galerie WinUI 3 inclut des exemples interactifs de la plupart des contrôles, fonctionnalités et fonctionnalités WinUI 3. Obtenez l’application à partir du du Microsoft Store ou obtenez le code source sur GitHub

Ajouter un animationIcon à un bouton

Cet exemple illustre un bouton Précédent avec une icône de flèche arrière qui s’anime lorsque des événements de pointeur se produisent.

Le AnimatedBackVisualSource est une animation de flèche arrière fournie par WinUI.
La FallbackIconSource est utilisée lorsque les animations ne peuvent pas être lues.
La méthode UIElement.AddHandler avec handledEventsToo définie sur true est utilisée pour les événements que le bouton marque comme 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");
}

Remarques

Définissez la propriété AnimatedIcon.Source pour spécifier le visuel animé de l’icône. WinUI fournit des visuels animés pour certaines icônes courantes dans l’espace de noms Microsoft.UI.Xaml.Controls.AnimatedVisuals.

Dans certains cas, les paramètres système ou les limitations peuvent empêcher l’icône d’être animée.

Si l’utilisateur désactive les animations dans ses paramètres système, AnimatedIcon affiche l’image finale de la transition d’état dans laquelle le contrôle était activé.
Spécifiez une FallbackIconSource à utiliser lorsque les animations ne sont pas prises en charge, comme sur les versions antérieures de Windows qui ne prennent pas en charge les animations Lottie.

Animations personnalisées

Vous pouvez créer des animations personnalisées à utiliser comme icône animée dans votre application. Les animations peuvent être créées avec Adobe AfterEffects, puis vous pouvez utiliser cette sortie avec la bibliothèque Lottie-Windows pour générer une classe personnalisée qui implémente IAnimatedVisualSource2. Vous pouvez utiliser cette classe comme source pour une icône animée. Pour plus d’informations, consultez Use Lottie pour créer du contenu animé pour unAnimatedIcon.

Contrôler l’état de l’icône animée

Vous modifiez la position de lecture et l’état de l’animation en définissant la propriété jointe AnimatedIcon.State. La propriété d’état prend une valeur de chaîne qui décrit l’état visuel, tel que «Normal», «PointerOver» ou «Pressed». Vous pouvez également spécifier une transition d’état spécifique, telle que «PressedToNormal».

Une icône animée source contient marqueurs qui mappent une position dans la chronologie d’animation à un état visuel. Les valeurs de chaîne qu’un Source prend en charge pour définir la propriété jointe State sont définies dans la collection Markers. Pour plus d’informations, consultez Définir des marqueurs AnimatedIcon.

Les sources visuelles animées utilisées dans les modèles de contrôle ont souvent un ensemble plus complexe de Markers qui mappe aux états de contrôle, tandis que les visuels animés pour une utilisation plus générale ont souvent un ensemble plus simple de Markers qui mappent aux événements de pointeur.

Où définir l’état

Vous pouvez définir la propriété sur le AnimatedIcon ou sur un ancêtre dans l’arborescence XAML. Dans les deux cas, vous devez utiliser la syntaxe de propriété jointe, comme suit :

<AnimatedIcon AnimatedIcon.State="Normal">...</AnimatedIcon>

Important

Si vous ajoutez une AnimatedIcon à l’arborescence XAML et définissez la propriété State sur un élément ancêtre, la propriété State doit être définie sur une valeur initiale avant que l’icône animée soit chargée pour que l’icône s’anime. Vous définissez généralement l’état initial en XAML, comme indiqué ici.

<StackPanel AnimatedIcon.State="Normal" ...>
   <AnimatedIcon>
       <animatedvisuals:AnimatedBackVisualSource/>
   </AnimatedIcon>
</StackPanel>

Utiliser des états visuels

Vous pouvez ajouter un AnimatedIcon au ControlTemplate d’un contrôle XAML et utiliser un VisualStateManager pour définir son état. Certains contrôles, tels que NavigationViewItem, définissent automatiquement l’état d’un AnimatedIcon défini comme Icône.

Pour voir un exemple qui définit AnimatedIcon.State dans un état visuel de modèle de contrôle, consultez le modèle par défaut pour CheckBox. Le contrôle utilise la AnimatedAcceptVisualSource pour sa coche. Les setters d’état visuel ressemblent à ceci :

<VisualState x:Name="CheckedPointerOver">
    ...
    <VisualState.Setters>
        <Setter Target="CheckGlyph.(AnimatedIcon.State)" Value="PointerOverOn"/>
    </VisualState.Setters>
</VisualState>

Gérer les événements de pointeur

Pour rendre le AnimatedIcon répondre à l’interaction utilisateur, vous devez définir la propriété AnimatedIcon.State jointe en réponse à certains événements de pointeur. Ce tableau affiche les événements de pointeur que vous gérerez généralement et les états courants qui correspondent à ces événements. (Toutefois, toutes les sources d’icône animées ne sont pas mappées exactement à ces états.)

Événement	État
UIElement.PointerEntered	«`PointerOver`»
UIElement.PointerPressed	«`Pressed`»
UIElement.PointerReleased	«`Normal`»
UIElement.PointerExited	«`Normal`»

Pourboire

Si vous placez le AnimatedIcon à l’intérieur d’un Button ou d’un autre contrôle qui a un événement Click, les événements PointerPressed et PointerReleased sont marqués comme PointerRoutedEventArgs.Handled. Pour gérer ces événements sur un bouton, utilisez la méthode UIElement.AddHandler pour connecter votre gestionnaire d’événements et spécifier handledEventsToo en tant que true. Utilisez UIElement.RemoveHandler pour déconnecter le gestionnaire d’événements.

Consultez la section Exemples pour obtenir des exemples de code qui illustrent ces gestionnaires d’événements.

Propriétés jointes XAML

AnimatedIcon est la classe de service hôte pour une propriété jointe XAML .

Pour prendre en charge l’accès au processeur XAML aux propriétés jointes, ainsi que pour exposer des équivalents obtenir et définir des opérations de sur du code, chaque propriété jointe XAML a une paire de méthodes d’accesseur Get et Set. Une autre façon d’obtenir ou de définir la valeur dans le code consiste à utiliser le système de propriétés de dépendance, en appelant GetValue ou SetValue et en passant le champ d’identificateur comme identificateur de propriété de dépendance.

Constructeurs

AnimatedIcon()

Initialise une nouvelle instance de la classe AnimatedIcon.

Propriétés

AccessKey	Obtient ou définit la clé d’accès (mnémonique) pour cet élément. (Hérité de UIElement)
AccessKeyScopeOwner	Obtient ou définit un élément source qui fournit l’étendue de clé d’accès pour cet élément, même s’il n’est pas dans l’arborescence visuelle de l’élément source. (Hérité de UIElement)
ActualHeight	Obtient la hauteur rendue d’unFrameworkElement . Voir les remarques. (Hérité de FrameworkElement)
ActualOffset	Obtient la position de cet UIElement, par rapport à son parent, calculée pendant la passe d’organisation du processus de disposition. (Hérité de UIElement)
ActualSize	Obtient la taille calculée par cet UIElement pendant la passe d’organisation du processus de disposition. (Hérité de UIElement)
ActualTheme	Obtient le thème d’interface utilisateur actuellement utilisé par l’élément, qui peut être différent de l'RequestedTheme. (Hérité de FrameworkElement)
ActualWidth	Obtient la largeur rendue d’un FrameworkElement. Voir les remarques. (Hérité de FrameworkElement)
AllowDrop	Obtient ou définit une valeur qui détermine si ce UIElement peut être une cible de déplacement à des fins d’opérations de glisser-déplacer. (Hérité de UIElement)
AllowFocusOnInteraction	Obtient ou définit une valeur qui indique si l’élément obtient automatiquement le focus lorsque l’utilisateur interagit avec lui. (Hérité de FrameworkElement)
AllowFocusWhenDisabled	Obtient ou définit si un contrôle désactivé peut recevoir le focus. (Hérité de FrameworkElement)
BaseUri	Obtient un URI (Uniform Resource Identifier) qui représente l’URI de base d’un objet construit par XAML au moment du chargement XAML. Cette propriété est utile pour la résolution d’URI au moment de l’exécution. (Hérité de FrameworkElement)
CacheMode	Obtient ou définit une valeur qui indique que le contenu rendu doit être mis en cache en tant que bitmap composite si possible. (Hérité de UIElement)
CanBeScrollAnchor	Obtient ou définit une valeur qui indique si l'UIElement peut être un candidat à l’ancrage de défilement. (Hérité de UIElement)
CanDrag	Obtient ou définit une valeur qui indique si l’élément peut être déplacé en tant que données dans une opération de glisser-déplacer. (Hérité de UIElement)
CenterPoint	Obtient ou définit le point central de l’élément, qui est le point sur lequel la rotation ou la mise à l’échelle se produit. Affecte la position de rendu de l’élément. (Hérité de UIElement)
Clip	Obtient ou définit le RectangleGeometry utilisé pour définir le contour du contenu d’un UIElement. (Hérité de UIElement)
CompositeMode	Obtient ou définit une propriété qui déclare des modes de composition et de fusion alternatifs pour l’élément dans sa disposition et sa fenêtre parentes. Cela s’applique aux éléments impliqués dans une interface utilisateur XAML/Microsoft DirectX mixte. (Hérité de UIElement)
ContextFlyout	Obtient ou définit le menu volant associé à cet élément. (Hérité de UIElement)
DataContext	Obtient ou définit le contexte de données d’unFrameworkElement . Une utilisation courante d’un contexte de données est lorsqu’un `FrameworkElement` utilise le {Binding} extension de balisage et participe à la liaison de données. (Hérité de FrameworkElement)
DesiredSize	Obtient la taille que cette UIElement calculée pendant la passe de mesure du processus de disposition. (Hérité de UIElement)
Dispatcher	Retourne toujours `null` dans une application sdk d’application Windows. Utilisez DispatcherQueue à la place. (Hérité de DependencyObject)
DispatcherQueue	Obtient le `DispatcherQueue` auquel cet objet est associé. L'`DispatcherQueue` représente une installation qui peut accéder à l'`DependencyObject` sur le thread d’interface utilisateur, même si le code est initié par un thread autre que l’interface utilisateur. (Hérité de DependencyObject)
ExitDisplayModeOnAccessKeyInvoked	Obtient ou définit une valeur qui spécifie si l’affichage de la clé d’accès est ignoré lorsqu’une clé d’accès est appelée. (Hérité de UIElement)
FallbackIconSource	Obtient ou définit l’icône statique à utiliser lorsque l’icône animée ne peut pas s’exécuter.
FallbackIconSourceProperty	Identifie la propriété de dépendance FallbackIconSource.
FlowDirection	Obtient ou définit la direction dans laquelle le texte et d’autres éléments d’interface utilisateur circulent dans n’importe quel élément parent qui contrôle leur disposition. Cette propriété peut être définie sur `LeftToRight` ou `RightToLeft`. Définir `FlowDirection` sur `RightToLeft` sur n’importe quel élément définit l’alignement à droite, l’ordre de lecture sur droite à gauche et la disposition du contrôle à passer de droite à gauche. (Hérité de FrameworkElement)
FocusState	Obtient une valeur qui spécifie si ce contrôle a le focus et le mode par lequel le focus a été obtenu. (Hérité de UIElement)
FocusVisualMargin	Obtient ou définit la marge externe du visuel focus pour un FrameworkElement. (Hérité de FrameworkElement)
FocusVisualPrimaryBrush	Obtient ou définit le pinceau utilisé pour dessiner la bordure externe d’un visuel de focus `HighVisibility` ou `Reveal` pour un FrameworkElement. (Hérité de FrameworkElement)
FocusVisualPrimaryThickness	Obtient ou définit l’épaisseur de la bordure externe d’un visuel de focus `HighVisibility` ou `Reveal` pour un FrameworkElement. (Hérité de FrameworkElement)
FocusVisualSecondaryBrush	Obtient ou définit le pinceau utilisé pour dessiner la bordure interne d’un visuel de focus ou pour unFrameworkElement . (Hérité de FrameworkElement)
FocusVisualSecondaryThickness	Obtient ou définit l’épaisseur de la bordure interne d’un visuel de focus `HighVisibility` ou `Reveal` pour un FrameworkElement. (Hérité de FrameworkElement)
Foreground	Obtient ou définit un pinceau qui décrit la couleur de premier plan. (Hérité de IconElement)
Height	Obtient ou définit la hauteur suggérée d’unFrameworkElement . (Hérité de FrameworkElement)
HighContrastAdjustment	Obtient ou définit une valeur qui indique si l’infrastructure ajuste automatiquement les propriétés visuelles de l’élément lorsque des thèmes à contraste élevé sont activés. (Hérité de UIElement)
HorizontalAlignment	Obtient ou définit les caractéristiques d’alignement horizontale appliquées à un FrameworkElement lorsqu’elle est composée dans un parent de disposition, telle qu’un panneau ou un contrôle d’éléments. (Hérité de FrameworkElement)
IsAccessKeyScope	Obtient ou définit une valeur qui indique si un élément définit sa propre étendue de clé d’accès. (Hérité de UIElement)
IsDoubleTapEnabled	Obtient ou définit une valeur qui détermine si l’événement DoubleTapped peut provenir de cet élément. (Hérité de UIElement)
IsHitTestVisible	Obtient ou définit si la zone contenue de cette UIElement peut retourner des valeurs vraies pour les tests de positionnement. (Hérité de UIElement)
IsHoldingEnabled	Obtient ou définit une valeur qui détermine si l’événement Holding peut provenir de cet élément. (Hérité de UIElement)
IsLoaded	Obtient une valeur qui indique si l’élément a été ajouté à l’arborescence d’éléments et est prêt pour l’interaction. (Hérité de FrameworkElement)
IsRightTapEnabled	Obtient ou définit une valeur qui détermine si l’événement RightTapped peut provenir de cet élément. (Hérité de UIElement)
IsTabStop	Obtient ou définit une valeur qui indique si un contrôle est inclus dans la navigation par onglets. (Hérité de UIElement)
IsTapEnabled	Obtient ou définit une valeur qui détermine si l’événement taché peut provenir de cet élément. (Hérité de UIElement)
KeyboardAcceleratorPlacementMode	Obtient ou définit une valeur qui indique si le contrôle info-bulle affiche la combinaison de touches pour son accélérateur de clavier associé. (Hérité de UIElement)
KeyboardAcceleratorPlacementTarget	Obtient ou définit une valeur qui indique le contrôle info-bulle qui affiche la combinaison de touches d’accélérateur. (Hérité de UIElement)
KeyboardAccelerators	Obtient la collection de combinaisons de touches qui appellent une action à l’aide du clavier. Les accélérateurs sont généralement affectés aux boutons ou aux éléments de menu. Exemple de menu montrant les raccourcis clavier pour différents éléments de menu (Hérité de UIElement)
KeyTipHorizontalOffset	Obtient ou définit une valeur qui indique à quel point l’extrémité gauche ou droite de l’info-bulle est placée par rapport à l’élément UIElement. (Hérité de UIElement)
KeyTipPlacementMode	Obtient ou définit une valeur qui indique où la clé d’accès est placée par rapport à la limite de l’UIElement. (Hérité de UIElement)
KeyTipTarget	Obtient ou définit une valeur qui indique l’élément ciblé par l’info-bulle de clé d’accès. (Hérité de UIElement)
KeyTipVerticalOffset	Obtient ou définit une valeur qui indique jusqu’à quel point la pointe de clé est placée par rapport à l’élément d’interface utilisateur. (Hérité de UIElement)
Language	Obtient ou définit les informations de langage de localisation/globalisation qui s’appliquent à un FrameworkElement, ainsi qu’à tous les éléments enfants de l'FrameworkElement actuel dans la représentation d’objet et dans l’interface utilisateur. (Hérité de FrameworkElement)
Lights	Obtient la collection d’objets XamlLight attachés à cet élément. (Hérité de UIElement)
ManipulationMode	Obtient ou définit la valeur ManipulationModes utilisée pour UIElement comportement et interaction avec les mouvements. La définition de cette valeur permet de gérer les événements de manipulation à partir de cet élément dans le code de l’application. (Hérité de UIElement)
Margin	Obtient ou définit la marge externe d’un FrameworkElement. (Hérité de FrameworkElement)
MaxHeight	Obtient ou définit la contrainte de hauteur maximale d’un FrameworkElement. (Hérité de FrameworkElement)
MaxWidth	Obtient ou définit la contrainte de largeur maximale d’un FrameworkElement. (Hérité de FrameworkElement)
MinHeight	Obtient ou définit la contrainte de hauteur minimale d’un FrameworkElement. (Hérité de FrameworkElement)
MinWidth	Obtient ou définit la contrainte de largeur minimale d’un FrameworkElement. (Hérité de FrameworkElement)
MirroredWhenRightToLeft	Obtient ou définit une valeur qui indique si l’icône est mise en miroir lorsque le FlowDirection est RightToLeft.
MirroredWhenRightToLeftProperty	Identifie la propriété de dépendance MirroredWhenRightToLeft.
Name	Obtient ou définit le nom d’identification de l’objet. Lorsqu’un processeur XAML crée l’arborescence d’objets à partir du balisage XAML, le code d’exécution peut faire référence à l’objet déclaré PAR XAML par ce nom. (Hérité de FrameworkElement)
Opacity	Obtient ou définit le degré d’opacité de l’objet. (Hérité de UIElement)
OpacityTransition	Obtient ou définit la ScalarTransition qui anime les modifications apportées à la propriété Opacity. (Hérité de UIElement)
Parent	Obtient l’objet parent de cette FrameworkElement dans l’arborescence d’objets. (Hérité de FrameworkElement)
PointerCaptures	Obtient l’ensemble de tous les pointeurs capturés, représentés en tant que valeurs pointeur. (Hérité de UIElement)
Projection	Obtient ou définit la projection de perspective (effet 3D) à appliquer lors du rendu de cet élément. (Hérité de UIElement)
ProtectedCursor	Obtient ou définit le curseur qui s’affiche lorsque le pointeur se trouve sur cet élément. La valeur par défaut est Null, ce qui indique qu’aucune modification n’est apportée au curseur. (Hérité de UIElement)
RasterizationScale	Obtient une valeur qui représente le nombre de pixels bruts (physiques) pour chaque pixel d’affichage. (Hérité de UIElement)
RenderSize	Obtient la taille de rendu finale d’un UIElement. L’utilisation n’est pas recommandée, voir Remarques. (Hérité de UIElement)
RenderTransform	Obtient ou définit des informations de transformation qui affectent la position de rendu d’un UIElement. (Hérité de UIElement)
RenderTransformOrigin	Obtient ou définit le point d’origine de toute transformation de rendu possible déclarée par RenderTransform, par rapport aux limites du UIElement. (Hérité de UIElement)
RequestedTheme	Obtient ou définit le thème d’interface utilisateur utilisé par l'UIElement (et ses éléments enfants) pour la détermination des ressources. Le thème de l’interface utilisateur que vous spécifiez avec `RequestedTheme` peut remplacer le DemandéThemeau niveau de l’application. (Hérité de FrameworkElement)
Resources	Obtient le dictionnaire de ressources défini localement. En XAML, vous pouvez établir des éléments de ressource en tant qu’éléments d’objet enfant d’un élément de propriété `frameworkElement.Resources`, via la syntaxe de collection implicite XAML. (Hérité de FrameworkElement)
Rotation	Obtient ou définit l’angle de rotation dans le sens des aiguilles d’une montre, en degrés. Fait pivoter par rapport aux RotationAxis et au CentrePoint. Affecte la position de rendu de l’élément. (Hérité de UIElement)
RotationAxis	Obtient ou définit l’axe pour faire pivoter l’élément autour. (Hérité de UIElement)
RotationTransition	Obtient ou définit la ScalarTransition qui anime les modifications apportées à la propriété Rotation. (Hérité de UIElement)
Scale	Obtient ou définit l’échelle de l’élément. Met à l’échelle par rapport au CenterPoint de l’élément. Affecte la position de rendu de l’élément. (Hérité de UIElement)
ScaleTransition	Obtient ou définit vector3Transition qui anime les modifications apportées à la propriété Scale. (Hérité de UIElement)
Shadow	Obtient ou définit le cast de l’effet d’ombre par l’élément. (Hérité de UIElement)
Source	Obtient ou définit le visuel animé affiché par l’objet `AnimatedIcon`.
SourceProperty	Identifie la propriété de dépendance source .
StateProperty	Identifie la propriété jointe XAML AnimatedIcon.State.
Style	Obtient ou définit une instance style qui est appliqué à cet objet pendant la disposition et le rendu. (Hérité de FrameworkElement)
TabFocusNavigation	Obtient ou définit une valeur qui modifie la façon dont tabulation et TabIndex fonctionnent pour ce contrôle. (Hérité de UIElement)
TabIndex	Obtient ou définit une valeur qui détermine l’ordre dans lequel les éléments reçoivent le focus lorsque l’utilisateur navigue dans les contrôles à l’aide de la touche tabulation . (Hérité de UIElement)
Tag	Obtient ou définit une valeur d’objet arbitraire qui peut être utilisée pour stocker des informations personnalisées sur cet objet. (Hérité de FrameworkElement)
Transform3D	Obtient ou définit l’effet de transformation 3D à appliquer lors du rendu de cet élément. (Hérité de UIElement)
TransformMatrix	Obtient ou définit la matrice de transformation à appliquer à l’élément. (Hérité de UIElement)
Transitions	Obtient ou définit la collection d’éléments de style de Transition qui s’appliquent à un UIElement. (Hérité de UIElement)
Translation	Obtient ou définit la position de rendu x, y et z de l’élément. (Hérité de UIElement)
TranslationTransition	Obtient ou définit vector3Transition qui anime les modifications apportées à la propriété Translation. (Hérité de UIElement)
Triggers	Obtient la collection de déclencheurs pour les animations définies pour un FrameworkElement. Non couramment utilisé. Voir les remarques. (Hérité de FrameworkElement)
UseLayoutRounding	Obtient ou définit une valeur qui détermine si le rendu de l’objet et de sa sous-arborescence visuelle doit utiliser le comportement d’arrondi qui aligne le rendu sur des pixels entiers. (Hérité de UIElement)
UseSystemFocusVisuals	Obtient ou définit une valeur qui indique si le contrôle utilise des visuels de focus dessinés par le système ou les visuels de focus définis dans le modèle de contrôle. (Hérité de UIElement)
VerticalAlignment	Obtient ou définit les caractéristiques d’alignement vertical appliquées à un FrameworkElement lorsqu’elle est composée dans un objet parent tel qu’un panneau ou un contrôle d’éléments. (Hérité de FrameworkElement)
Visibility	Obtient ou définit la visibilité d’un UIElement. Une `UIElement` qui n’est pas visible n’est pas rendue et ne communique pas sa taille souhaitée à la disposition. (Hérité de UIElement)
Width	Obtient ou définit la largeur d’unFrameworkElement . (Hérité de FrameworkElement)
XamlRoot	Obtient ou définit la `XamlRoot` dans laquelle cet élément est en cours d’affichage. (Hérité de UIElement)
XYFocusDown	Obtient ou définit l’objet qui obtient le focus lorsqu’un utilisateur appuie sur le pavé directionnel (D-pad) d’un contrôleur de jeu. (Hérité de UIElement)
XYFocusDownNavigationStrategy	Obtient ou définit une valeur qui spécifie la stratégie utilisée pour déterminer l’élément cible d’une navigation vers le bas. (Hérité de UIElement)
XYFocusKeyboardNavigation	Obtient ou définit une valeur qui active ou désactive la navigation à l’aide des flèches directionnelles du clavier. (Hérité de UIElement)
XYFocusLeft	Obtient ou définit l’objet qui obtient le focus lorsqu’un utilisateur appuie sur gauche sur le pavé directionnel (D-pad) d’un contrôleur de jeu. (Hérité de UIElement)
XYFocusLeftNavigationStrategy	Obtient ou définit une valeur qui spécifie la stratégie utilisée pour déterminer l’élément cible d’une navigation gauche. (Hérité de UIElement)
XYFocusRight	Obtient ou définit l’objet qui obtient le focus lorsqu’un utilisateur appuie à droite sur le pavé directionnel (D-pad) d’un contrôleur de jeu. (Hérité de UIElement)
XYFocusRightNavigationStrategy	Obtient ou définit une valeur qui spécifie la stratégie utilisée pour déterminer l’élément cible d’une navigation droite. (Hérité de UIElement)
XYFocusUp	Obtient ou définit l’objet qui obtient le focus lorsqu’un utilisateur appuie sur le pavé directionnel (D-pad) d’un contrôleur de jeu. (Hérité de UIElement)
XYFocusUpNavigationStrategy	Obtient ou définit une valeur qui spécifie la stratégie utilisée pour déterminer l’élément cible d’une navigation vers le haut. (Hérité de UIElement)

Propriétés attachées

State

Propriété que le développeur définit sur AnimatedIcon.

Méthodes

AddHandler(RoutedEvent, Object, Boolean)	Ajoute un gestionnaire d’événements routés pour un événement routé spécifié, en ajoutant le gestionnaire à la collection de gestionnaires sur l’élément actuel. Spécifiez `handledEventsToo` en tant que `true` pour que le gestionnaire fourni soit appelé même si l’événement est géré ailleurs. (Hérité de UIElement)
Arrange(Rect)	Positionne les objets enfants et détermine une taille pour un UIElement. Les objets parents qui implémentent une disposition personnalisée pour leurs éléments enfants doivent appeler cette méthode à partir de leurs implémentations de remplacement de disposition pour former une mise à jour de disposition récursive. (Hérité de UIElement)
ArrangeOverride(Size)	Fournit le comportement de la passe « Organiser » de disposition. Les classes peuvent remplacer cette méthode pour définir leur propre comportement de passe « Arrange ». (Hérité de FrameworkElement)
CancelDirectManipulations()	Annule le traitement continu de manipulation directe (panoramique/zoom défini par le système) sur n’importe quel parent ScrollViewer qui contient le UIElement actuel. (Hérité de UIElement)
CapturePointer(Pointer)	Définit la capture de pointeur vers une UIElement. Une fois capturé, seul l’élément qui a été capturé déclenche des événements liés au pointeur. (Hérité de UIElement)
ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété de dépendance. (Hérité de DependencyObject)
FindName(String)	Récupère un objet qui a le nom d’identificateur spécifié. (Hérité de FrameworkElement)
FindSubElementsForTouchTargeting(Point, Rect)	Permet à un UIElement sous-classe d’exposer des éléments enfants qui aident à résoudre le ciblage tactile. (Hérité de UIElement)
Focus(FocusState)	Tente de définir le focus sur cet élément. (Hérité de UIElement)
GetAnimationBaseValue(DependencyProperty)	Retourne toute valeur de base établie pour une propriété de dépendance, qui s’applique dans les cas où une animation n’est pas active. (Hérité de DependencyObject)
GetBindingExpression(DependencyProperty)	Retourne la BindingExpression qui représente la liaison sur la propriété spécifiée. (Hérité de FrameworkElement)
GetChildrenInTabFocusOrder()	Active un UIElement sous-classe pour exposer les éléments enfants qui participent au focus Tab. (Hérité de UIElement)
GetState(DependencyObject)	Récupère la valeur de la propriété jointe AnimatedIcon.State pour la propriété jointe DependencyObject spécifiée.
GetValue(DependencyProperty)	Retourne la valeur effective actuelle d’une propriété de dépendance à partir d’une DependencyObject. (Hérité de DependencyObject)
GetVisualInternal()	Récupère le `Visual` sur lequel l’élément est résolu. (Hérité de UIElement)
GoToElementStateCore(String, Boolean)	En cas d’implémentation dans une classe dérivée, active la construction par état d’une arborescence visuelle pour un modèle de contrôle dans le code, au lieu de charger le code XAML pour tous les états au démarrage du contrôle. (Hérité de FrameworkElement)
InvalidateArrange()	Invalide l’état d’organisation (disposition) d’un UIElement. Après l’invalidation, l'UIElement aura sa disposition mise à jour, ce qui se produit de façon asynchrone. (Hérité de UIElement)
InvalidateMeasure()	Invalide l’état de mesure (disposition) d’un UIElement. (Hérité de UIElement)
InvalidateViewport()	Invalide l’état de la fenêtre d’affichage d’un UIElement utilisé pour calculer la fenêtre d’affichage effective. (Hérité de FrameworkElement)
Measure(Size)	Met à jour le desiredSize d’unUIElement . En règle générale, les objets qui implémentent une disposition personnalisée pour leurs enfants de disposition appellent cette méthode à partir de leur propre MeasureOverride implémentations pour former une mise à jour de disposition récursive. (Hérité de UIElement)
MeasureOverride(Size)	Fournit le comportement de la passe « Mesure » du cycle de disposition. Les classes peuvent remplacer cette méthode pour définir leur propre comportement de passe « Measure ». (Hérité de FrameworkElement)
OnApplyTemplate()	Appelé chaque fois que le code de l’application ou les processus internes (par exemple, une passe de disposition de reconstruction) appellent ApplyTemplate. En termes les plus simples, cela signifie que la méthode est appelée juste avant qu’un élément d’interface utilisateur ne s’affiche dans votre application. Remplacez cette méthode pour influencer la logique post-modèle par défaut d’une classe. (Hérité de FrameworkElement)
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)	Appelé avant l’événement BringIntoViewRequested se produit. (Hérité de UIElement)
OnCreateAutomationPeer()	En cas d’implémentation dans une classe dérivée, retourne des implémentations spécifiques à la classe AutomationPeer pour l’infrastructure Microsoft UI Automation. (Hérité de UIElement)
OnDisconnectVisualChildren()	Remplacez cette méthode pour implémenter le comportement de la disposition et de la logique lorsque des éléments sont supprimés d’un contenu spécifique à une classe ou d’une propriété enfant. (Hérité de UIElement)
OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs)	Appelé lorsqu’un raccourci clavier (ou accélérateur) est traité dans votre application. Remplacez cette méthode pour gérer la façon dont votre application répond lorsqu’un accélérateur clavier est appelé. (Hérité de UIElement)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)	Appelé juste avant qu’un raccourci clavier (ou accélérateur) ne soit traité dans votre application. Appelé chaque fois que le code de l’application ou les processus internes appellent ProcessKeyboardAccelerators. Remplacez cette méthode pour influencer la gestion par défaut de l’accélérateur. (Hérité de UIElement)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Définit une propriété qui peut être animée. (Hérité de UIElement)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	En cas de substitution dans une classe dérivée, définit une propriété qui peut être animée. (Hérité de UIElement)
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, si une valeur locale est définie. (Hérité de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Inscrit une fonction de notification pour écouter les modifications apportées à un DependencyProperty spécifique sur cette instance DependencyObject. (Hérité de DependencyObject)
ReleasePointerCapture(Pointer)	Libère les captures de pointeurs pour la capture d’un pointeur spécifique par cette UIElement. (Hérité de UIElement)
ReleasePointerCaptures()	Libère toutes les captures de pointeur détenues par cet élément. (Hérité de UIElement)
RemoveHandler(RoutedEvent, Object)	Supprime le gestionnaire d’événements routé spécifié de ce UIElement. En règle générale, le gestionnaire en question a été ajouté par AddHandler. (Hérité de UIElement)
SetBinding(DependencyProperty, BindingBase)	Attache une liaison à un FrameworkElement, à l’aide de l’objet de liaison fourni. (Hérité de FrameworkElement)
SetState(DependencyObject, String)	Spécifie la valeur de la propriété jointe AnimatedIcon.State pour la DependencyObjectspécifiée.
SetValue(DependencyProperty, Object)	Définit la valeur locale d’une propriété de dépendance sur un DependencyObject. (Hérité de DependencyObject)
StartAnimation(ICompositionAnimationBase)	Commence l’animation spécifiée sur l’élément. (Hérité de UIElement)
StartBringIntoView()	Lance une demande adressée à l’infrastructure XAML pour que l’élément soit visible dans toutes les régions défilantes qu’il contient. (Hérité de UIElement)
StartBringIntoView(BringIntoViewOptions)	Lance une demande à l’infrastructure XAML pour afficher l’élément à l’aide des options spécifiées. (Hérité de UIElement)
StartDragAsync(ExpPointerPoint)	Représente une icône qui affiche et contrôle un visuel qui peut s’animer en réponse aux modifications d’interaction utilisateur et d’état visuel. (Hérité de UIElement)
StartDragAsync(PointerPoint)	Lance une opération de glisser-déplacer. Important Non pris en charge si un utilisateur exécute l’application en mode avec élévation de privilèges, en tant qu’administrateur. (Hérité de UIElement)
StopAnimation(ICompositionAnimationBase)	Arrête l’animation spécifiée sur l’élément. (Hérité de UIElement)
TransformToVisual(UIElement)	Retourne un objet de transformation qui peut être utilisé pour transformer les coordonnées de l'UIElement à l’objet spécifié. (Hérité de UIElement)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)	Tente d’appeler un raccourci clavier (ou accélérateur) en recherchant l’arborescence visuelle entière de l’uiElement pour le raccourci. (Hérité de UIElement)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Annule une notification de modification précédemment inscrite en appelant RegisterPropertyChangedCallback. (Hérité de DependencyObject)
UpdateLayout()	Garantit que toutes les positions des objets enfants d’un UIElement sont correctement mises à jour pour la disposition. (Hérité de UIElement)

Événements

AccessKeyDisplayDismissed	Se produit lorsque les clés d’accès ne doivent plus être affichées. (Hérité de UIElement)
AccessKeyDisplayRequested	Se produit lorsque l’utilisateur demande que les clés d’accès soient affichées. (Hérité de UIElement)
AccessKeyInvoked	Se produit lorsqu’un utilisateur termine une séquence de clés d’accès. (Hérité de UIElement)
ActualThemeChanged	Se produit lorsque la valeur de la propriété ActualTheme a changé. (Hérité de FrameworkElement)
BringIntoViewRequested	Se produit lorsque StartBringIntoView est appelé sur cet élément ou l’un de ses descendants. (Hérité de UIElement)
CharacterReceived	Se produit lorsqu’un caractère composé unique est reçu par la file d’attente d’entrée. (Hérité de UIElement)
ContextCanceled	Se produit lorsqu’un mouvement d’entrée de contexte se poursuit dans un mouvement de manipulation, pour avertir l’élément que le menu volant de contexte ne doit pas être ouvert. (Hérité de UIElement)
ContextRequested	Se produit lorsque l’utilisateur a effectué un mouvement d’entrée de contexte, tel qu’un clic droit. (Hérité de UIElement)
DataContextChanged	Se produit lorsque la valeur de la propriété FrameworkElement.DataContext change. (Hérité de FrameworkElement)
DoubleTapped	Se produit lorsqu’une interaction DoubleTap non gérée se produit sur la zone de test de positionnement de cet élément. (Hérité de UIElement)
DragEnter	Se produit lorsque le système d’entrée signale un événement de glissement sous-jacent avec cet élément comme cible. (Hérité de UIElement)
DragLeave	Se produit lorsque le système d’entrée signale un événement de glissement sous-jacent avec cet élément comme origine. (Hérité de UIElement)
DragOver	Se produit lorsque le système d’entrée signale un événement de glissement sous-jacent avec cet élément comme cible de déplacement potentielle. (Hérité de UIElement)
DragStarting	Se produit lorsqu’une opération de glissement est lancée. (Hérité de UIElement)
Drop	Se produit lorsque le système d’entrée signale un événement de suppression sous-jacent avec cet élément comme cible de suppression. (Hérité de UIElement)
DropCompleted	Se produit lorsqu’une opération de glisser-déplacer avec cet élément est terminée. (Hérité de UIElement)
EffectiveViewportChanged	Se produit lorsque le FrameworkElement's fenêtre d’affichage effective modifications. (Hérité de FrameworkElement)
GettingFocus	Se produit avant qu’un élément UIElement reçoit le focus. Cet événement est déclenché de façon synchrone pour vous assurer que le focus n’est pas déplacé pendant que l’événement est en cours de propagation. (Hérité de UIElement)
GotFocus	Se produit lorsqu’un UIElement reçoit le focus. Cet événement est déclenché de façon asynchrone, ce qui permet au focus de se déplacer à nouveau avant la fin de l’opération. (Hérité de UIElement)
Holding	Se produit lorsqu’une interaction hold non gérée se produit sur la zone de test de positionnement de cet élément. (Hérité de UIElement)
KeyDown	Se produit lorsqu’une touche clavier est enfoncée pendant que le UIElement a le focus. (Hérité de UIElement)
KeyUp	Se produit lorsqu’une touche clavier est libérée pendant que le UIElement a le focus. (Hérité de UIElement)
LayoutUpdated	Se produit lorsque la disposition de l’arborescence visuelle change, en raison de la modification de la valeur des propriétés pertinentes pour la disposition ou d’une autre action qui actualise la disposition. (Hérité de FrameworkElement)
Loaded	Se produit lorsqu’un FrameworkElement a été construit et ajouté à l’arborescence d’objets et est prêt à l’interaction. (Hérité de FrameworkElement)
Loading	Se produit lorsqu’un FrameworkElement commence à être chargé. (Hérité de FrameworkElement)
LosingFocus	Se produit avant une UIElement perd le focus. Cet événement est déclenché de façon synchrone pour vous assurer que le focus n’est pas déplacé pendant que l’événement est en cours de propagation. (Hérité de UIElement)
LostFocus	Se produit lorsqu’un élément UIElement perd le focus. Cet événement est déclenché de façon asynchrone, ce qui permet au focus de se déplacer à nouveau avant la fin de l’opération. (Hérité de UIElement)
ManipulationCompleted	Se produit lorsqu’une manipulation sur l'UIElement est terminée. (Hérité de UIElement)
ManipulationDelta	Se produit lorsque l’appareil d’entrée change de position pendant une manipulation. (Hérité de UIElement)
ManipulationInertiaStarting	Se produit lorsque l’appareil d’entrée perd le contact avec l’objet UIElement lors d’une manipulation et de l’inertie commence. (Hérité de UIElement)
ManipulationStarted	Se produit lorsqu’un appareil d’entrée commence une manipulation sur le UIElement. (Hérité de UIElement)
ManipulationStarting	Se produit lorsque le processeur de manipulation est créé pour la première fois. (Hérité de UIElement)
NoFocusCandidateFound	Se produit lorsqu’un utilisateur tente de déplacer le focus (via des flèches tabulation ou directionnelles), mais que le focus ne se déplace pas, car aucun candidat au focus n’est trouvé dans la direction du mouvement. (Hérité de UIElement)
PointerCanceled	Se produit lorsqu’un pointeur qui a rendu le contact perd anormalement le contact. (Hérité de UIElement)
PointerCaptureLost	Se produit lorsque la capture de pointeur précédemment détenue par cet élément se déplace vers un autre élément ou ailleurs. (Hérité de UIElement)
PointerEntered	Se produit lorsqu’un pointeur entre dans la zone de test de positionnement de cet élément. (Hérité de UIElement)
PointerExited	Se produit lorsqu’un pointeur quitte la zone de test de positionnement de cet élément. (Hérité de UIElement)
PointerMoved	Se produit lorsqu’un pointeur se déplace pendant que le pointeur reste dans la zone de test de positionnement de cet élément. (Hérité de UIElement)
PointerPressed	Se produit lorsque l’appareil pointeur lance une action Appuyez sur dans cet élément. (Hérité de UIElement)
PointerReleased	Se produit lorsque l’appareil pointeur qui a précédemment lancé une action Press est libéré, tandis qu’au sein de cet élément. Notez que la fin d’une action Press n’est pas garantie de déclencher un événement de `PointerReleased` ; d’autres événements peuvent se déclencher à la place. Pour plus d’informations, consultez Remarques. (Hérité de UIElement)
PointerWheelChanged	Se produit lorsque la valeur delta d’une roue de pointeur change. (Hérité de UIElement)
PreviewKeyDown	Se produit lorsqu’une touche clavier est enfoncée pendant que le UIElement a le focus. (Hérité de UIElement)
PreviewKeyUp	Se produit lorsqu’une touche clavier est libérée pendant que le UIElement a le focus. (Hérité de UIElement)
ProcessKeyboardAccelerators	Se produit lorsqu’un raccourci clavier (ou accélérateur) est enfoncé. (Hérité de UIElement)
RightTapped	Se produit lorsqu’un stimulus d’entrée de la touche droite se produit pendant que le pointeur se trouve sur l’élément. (Hérité de UIElement)
SizeChanged	Se produit lorsque la propriété ActualHeight ou ActualWidth ActualWidth change de valeur sur un FrameworkElement. (Hérité de FrameworkElement)
Tapped	Se produit lorsqu’une interaction tap non gérée se produit sur la zone de test de positionnement de cet élément. (Hérité de UIElement)
Unloaded	Se produit lorsque cet objet n’est plus connecté à l’arborescence d’objets principale. (Hérité de FrameworkElement)

S’applique à

Voir aussi

AnimatedVisualPlayer
VisualStateManager
IAnimatedVisual
Vue d’ensemble de l’icône animée
Lottie-Windows
segments interactifs sur une chronologie d’animation

Partager via