UIElement Classe
Définition
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.
UIElement
est une classe de base pour la plupart des objets d’interface utilisateur Windows Runtime qui ont une apparence visuelle et peuvent traiter les entrées de base dans le cadre de l’interface utilisateur de votre application.
public ref class UIElement : DependencyObject, IAnimationObject, IVisualElement, IVisualElement2
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class UIElement : DependencyObject, IAnimationObject, IVisualElement, IVisualElement2
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class UIElement : DependencyObject, IAnimationObject, IVisualElement, IVisualElement2
Public Class UIElement
Inherits DependencyObject
Implements IAnimationObject, IVisualElement, IVisualElement2
- Héritage
- Dérivé
- Attributs
- Implémente
Remarques
UIElement
est un élément de base : il s’agit d’une classe dont héritent de nombreuses autres classes Windows Runtime pour prendre en charge le modèle d’élément d’interface utilisateur XAML. Les propriétés, méthodes et événements définis par UIElement
sont hérités par des centaines d’autres classes Windows Runtime.
UIElement
n’expose pas de constructeur public. En règle générale, vous ne dérivez pas les classes de UIElement
ou de FrameworkElement directement. Les classes de base plus généralement utilisées pour les classes personnalisées dérivées sont les suivantes :
- Contrôles spécifiques qui ne sont pas scellés (par exemple, TextBox)
- Classes de base de contrôle (Control, ContentControl, UserControl)
- Éléments de navigation (Page, Frame)
- Classes de panneau (la classe de base Panneau, ou des implémentations non scellées spécifiques telles que Grid)
La classe UIElement
est utilisée comme paramètre de type de nombreuses propriétés et méthodes dans l’API Windows Runtime. Par exemple, la propriété UIElement
pour une telle propriété, y compris les contrôles personnalisés que vous définissez.
La classe UIElementCollection fournit une collection fortement typée d’éléments UIElement
.
UIElementCollection
est utilisé comme type pour les propriétés d’objets qui contiennent plusieurs éléments enfants, par exemple pour la propriété Children d’une classe Panel.
API et fonctionnalités UIElement
UIElement
étend DependencyObject, qui est un autre élément de base, et ajoute la prise en charge de différentes zones de fonctionnalités Windows Runtime.
Entrée et événements pour répondre à l’interaction utilisateur
Une grande partie du comportement d’entrée pour les éléments visibles d’une interface utilisateur est définie dans la classe UIElement
. Cela inclut les événements pour les interactions clavier, souris, tactile, glisser-déplacer et focus. Pour plus d’informations, consultez Gérer lesd’entrée de pointeur, interactions clavieret interactions utilisateur personnalisées.
API de UIElement
de premier plan qui prend en charge l’entrée et l’interaction utilisateur :
- événements pointeur :PointerPressed, PointerReleased, PointerMoved, PointerEntered, PointerExited
- Événements de gestion des clés :KeyDown , KeyUp
- Focus :GotFocus, LostFocus
- capture de pointeur :CapturePointer, PointerCanceled, PointerCaptureLost, ReleasePointerCapture, PointerCaptures
- Glisser-déplacer :DragOver, , DragEnter, DragLeave, AllowDrop
- propriétés qui influencent le traitement de l’entrée de base :IsHitTestVisible, AllowDrop
Mouvements et manipulations
Les mouvements et les manipulations sont également un moyen de gérer l’entrée et l’interaction utilisateur. L’API est répertoriée séparément ici, car ces événements représentent la façon dont le système interagit avec les actions d’entrée au niveau de l’appareil et les interprète comme une interaction utilisateur. Les manipulations sont un moyen de gérer les interactions multi-tactiles dynamiques telles que le pincement et l’étirement. Ensemble, les mouvements et les manipulations fournissent les modèles tactiles pour l’interaction tactile avec l’application UWP. Pour plus d’informations, consultez interactions utilisateur personnalisées et conception d’interaction tactile.
API de UIElement
de premier plan qui prend en charge les mouvements et les manipulations :
- événements mouvement :doubletapped, de conservation, RightTapped , taché
- événements Manipulation :ManipulationCompleted, ManipulationDelta, ManipulationInertiaStarting, ManipulationStarted, ManipulationStarting
- Propriétés qui influencent le traitement des mouvements et des manipulations :IsHoldingEnabled et d’autres Is*Enabled, ManipulationMode
Apparence de base
Les propriétés Visibility et Opacité sont fréquemment utilisées pour ajuster l’apparence d’un élément dans votre interface utilisateur, en particulier dans les styles, les modèles et les états visuels. Les propriétés Clip, RenderTransformet Transitions sont toutes utiles pour produire des interactions et des apparences différentes pour vos éléments d’interface utilisateur.
Disposition de base
La classe UIElement
fournit un point de départ pour les caractéristiques de disposition avec des propriétés telles que DesiredSize et les méthodes Arrange et Measure.
FrameworkElement ajoute d’autres fonctionnalités de disposition. Pour plus d’informations, consultez Définir des dispositions avec des XAML et FrameworkElement.
Événements routés
La plupart des événements d’entrée de UIElement
sont des événements routés . Un événement routé permet un système de notification de gestion des événements intégré, afin qu’un objet parent puisse gérer les événements d’entrée à partir d’objets enfants dans l’arborescence des objets objet si l’événement reste non géré. Ce comportement d’événement d’entrée est utile pour le regroupement de zones d’entrée et pour la composition de contrôle. Pour plus d’informations, consultez Vue d’ensemble des événements et des événements routés.
API de UIElement
qui prend en charge les événements routés : AddHandler, RemoveHandler, *Propriétés d’événements.
Prise en charge d’autres plateformes
OnCreateAutomationPeer permet à une classe d’utiliser un AutomationPeer personnalisépour sa prise en charge de Microsoft UI Automation. - RenderTransform, TransformToVisual, Projection, CompositeMode, CacheMode et FindSubElementsForTouchTargeting sont utiles pour les scénarios de disposition avancés de l’interface utilisateur.
Propriétés de dépendance UIElement
La plupart des propriétés en lecture-écriture de la classe d’élément de base UIElement
sont des propriétés de dépendance. Les propriétés de dépendance prennent en charge certaines des fonctionnalités de modèle de programmation de base d’une application à l’aide de C++ ou C#, telles que les styles et les modèles, la liaison de données, les références de ressources XAML et la logique modifiée par les propriétés. Pour plus d’informations sur les propriétés de dépendance et les fonctionnalités prises en charge, consultez vue d’ensemble des propriétés de dépendance.
Classes dérivées UIElement
La seule classe Windows Runtime qui dérive directement de UIElement
est FrameworkElement. Pour obtenir la liste des classes qui dérivent de FrameworkElement, consultez la section «FrameworkElement classes dérivées » de la rubrique de référence FrameworkElement.
Propriétés
AccessKey |
Obtient ou définit la clé d’accès (mnémonique) pour cet élément. |
AccessKeyProperty |
Identifie la propriété de dépendance AccessKey |
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. |
AccessKeyScopeOwnerProperty |
Identifie la propriété de dépendance AccessKeyScopeOwner. |
ActualOffset |
Obtient la position de cet UIElement, par rapport à son parent, calculée pendant la passe d’organisation du processus de disposition. |
ActualSize |
Obtient la taille calculée par cet UIElement pendant la passe d’organisation du processus de disposition. |
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. |
AllowDropProperty |
Identifie la propriété de dépendance AllowDrop. |
BringIntoViewRequestedEvent |
Obtient l’identificateur de l’événement routé BringIntoViewRequested. |
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. |
CacheModeProperty |
Identifie la propriété de dépendance CacheMode |
CanBeScrollAnchor |
Obtient ou définit une valeur qui indique si l'UIElement peut être un candidat à l’ancrage de défilement. |
CanBeScrollAnchorProperty |
Identifie la propriété de dépendance CanBeScrollAnchor. |
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. |
CanDragProperty |
Identifie la propriété de dépendance CanDrag. |
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. |
CharacterReceivedEvent |
Obtient l’identificateur de l’événement CharacterReceived routé. |
Clip |
Obtient ou définit le RectangleGeometry |
ClipProperty |
Identifie |
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. |
CompositeModeProperty |
Identifie la propriété de dépendance CompositeMode. |
ContextFlyout |
Obtient ou définit le menu volant associé à cet élément. |
ContextFlyoutProperty |
Identifie la propriété de dépendance ContextFlyout. |
ContextRequestedEvent |
Obtient l’identificateur de l’événement routé ContextRequested. |
DesiredSize |
Obtient la taille que cette UIElement calculée pendant la passe de mesure du processus de disposition. |
Dispatcher |
Retourne toujours |
DispatcherQueue |
Obtient le |
DoubleTappedEvent |
Obtient l’identificateur de l’événement DoubleTapped routé. |
DragEnterEvent |
Obtient l’identificateur de l’événement DragEnter routé. |
DragLeaveEvent |
Obtient l’identificateur de l’événement DragLeave routé. |
DragOverEvent |
Obtient l’identificateur de l’événement DragOver routé. |
DropEvent |
Obtient l’identificateur de l’événement Drop routé. |
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. |
ExitDisplayModeOnAccessKeyInvokedProperty |
Identifie la propriété de dépendance ExitDisplayModeOnAccessKeyInvoked. |
FocusState |
Obtient une valeur qui spécifie si ce contrôle a le focus et le mode par lequel le focus a été obtenu. |
FocusStateProperty |
Identifie la propriété de dépendance FocusState. |
GettingFocusEvent |
Obtient l’identificateur de l’événement GettingFocus routé. |
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. |
HighContrastAdjustmentProperty |
Identifie la propriété de dépendance HighContrastAdjustment. |
HoldingEvent |
Obtient l’identificateur de l’événement Holding routé. |
IsAccessKeyScope |
Obtient ou définit une valeur qui indique si un élément définit sa propre étendue de clé d’accès. |
IsAccessKeyScopeProperty |
Identifie la propriété de dépendance IsAccessKeyScope. |
IsDoubleTapEnabled |
Obtient ou définit une valeur qui détermine si l’événement DoubleTapped peut provenir de cet élément. |
IsDoubleTapEnabledProperty |
Identifie la propriété de dépendance IsDoubleTapEnabled. |
IsHitTestVisible |
Obtient ou définit si la zone contenue de cette UIElement peut retourner des valeurs vraies pour les tests de positionnement. |
IsHitTestVisibleProperty |
Identifie la propriété de dépendance IsHitTestVisible. |
IsHoldingEnabled |
Obtient ou définit une valeur qui détermine si l’événement Holding peut provenir de cet élément. |
IsHoldingEnabledProperty |
Identifie la propriété de dépendance IsHoldingEnabled. |
IsRightTapEnabled |
Obtient ou définit une valeur qui détermine si l’événement RightTapped peut provenir de cet élément. |
IsRightTapEnabledProperty |
Identifie la propriété de dépendance IsRightTapEnabled |
IsTabStop |
Obtient ou définit une valeur qui indique si un contrôle est inclus dans la navigation par onglets. |
IsTabStopProperty |
Identifie la propriété de dépendance UIElement.IsTabStop. |
IsTapEnabled |
Obtient ou définit une valeur qui détermine si l’événement taché peut provenir de cet élément. |
IsTapEnabledProperty |
Identifie la propriété de dépendance IsTapEnabled. |
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é. |
KeyboardAcceleratorPlacementModeProperty |
Identifie la propriété de dépendance KeyboardAcceleratorPlacementMode. |
KeyboardAcceleratorPlacementTarget |
Obtient ou définit une valeur qui indique le contrôle info-bulle qui affiche la combinaison de touches d’accélérateur. |
KeyboardAcceleratorPlacementTargetProperty |
Identifie la propriété de dépendance KeyboardAcceleratorPlacementTarget. |
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.
|
KeyDownEvent |
Obtient l’identificateur de l’événement KeyDown routé. |
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. |
KeyTipHorizontalOffsetProperty |
Identifie la propriété de dépendance KeyTipHorizontalOffset. |
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. |
KeyTipPlacementModeProperty |
Identifie la propriété de dépendance KeyTipPlacementMode. |
KeyTipTarget |
Obtient ou définit une valeur qui indique l’élément ciblé par l’info-bulle de clé d’accès. |
KeyTipTargetProperty |
Identifie la propriété de dépendance KeyTipTarget. |
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. |
KeyTipVerticalOffsetProperty |
Identifie la propriété de dépendance KeyTipVerticalOffset. |
KeyUpEvent |
Obtient l’identificateur de l’événement KeyUp routé. |
Lights |
Obtient la collection d’objets XamlLight attachés à cet élément. |
LightsProperty |
Identifie la propriété de dépendance Lights. |
LosingFocusEvent |
Obtient l’identificateur de l’événement LosingFocus routé. |
ManipulationCompletedEvent |
Obtient l’identificateur de l’événement ManipulationCompleted routé. |
ManipulationDeltaEvent |
Obtient l’identificateur de l’événement ManipulationDelta routé. |
ManipulationInertiaStartingEvent |
Obtient l’identificateur de l’événement routé ManipulationInertiaStarting. |
ManipulationMode |
Obtient ou définit la valeur |
ManipulationModeProperty |
Identifie la propriété de dépendance ManipulationMode. |
ManipulationStartedEvent |
Obtient l’identificateur de l’événement ManipulationStarted routé. |
ManipulationStartingEvent |
Obtient l’identificateur de l’événement ManipulationStarting routé. |
NoFocusCandidateFoundEvent |
Obtient l’identificateur de l’événement routé noFocusCandidateFound |
Opacity |
Obtient ou définit le degré d’opacité de l’objet. |
OpacityProperty |
Identifie la propriété de dépendance IsHitTestVisible. |
OpacityTransition |
Obtient ou définit la ScalarTransition qui anime les modifications apportées à la propriété Opacity. |
PointerCanceledEvent |
Obtient l’identificateur de l’événement PointerCanceled routé. |
PointerCaptureLostEvent |
Obtient l’identificateur de l’événement PointerCaptureLost routé. |
PointerCaptures |
Obtient l’ensemble de tous les pointeurs capturés, représentés en tant que valeurs pointeur. |
PointerCapturesProperty |
Identifie la propriété de dépendance PointerCaptures. |
PointerEnteredEvent |
Obtient l’identificateur de l’événement PointerEntered routé. |
PointerExitedEvent |
Obtient l’identificateur de l’événement PointerExited routé. |
PointerMovedEvent |
Obtient l’identificateur de l’événement PointerMoved routé. |
PointerPressedEvent |
Obtient l’identificateur de l’événement PointerPressed routé. |
PointerReleasedEvent |
Obtient l’identificateur de l’événement PointerReleased routé. |
PointerWheelChangedEvent |
Obtient l’identificateur de l’événement PointerWheelChanged routé. |
PreviewKeyDownEvent |
Obtient l’identificateur de l’événement routed PreviewKeyDown. |
PreviewKeyUpEvent |
Obtient l’identificateur de l’événement routed PreviewKeyUp. |
Projection |
Obtient ou définit la projection de perspective (effet 3D) à appliquer lors du rendu de cet élément. |
ProjectionProperty |
Identifie la propriété de dépendance projection |
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. |
RasterizationScale |
Obtient une valeur qui représente le nombre de pixels bruts (physiques) pour chaque pixel d’affichage. |
RenderSize |
Obtient la taille de rendu finale d’un UIElement. L’utilisation n’est pas recommandée, voir Remarques. |
RenderTransform |
Obtient ou définit des informations de transformation qui affectent la position de rendu d’un 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. |
RenderTransformOriginProperty |
Identifie la propriété de dépendance RenderTransformOrigin. |
RenderTransformProperty |
Identifie la propriété de dépendance RenderTransform. |
RightTappedEvent |
Obtient l’identificateur de l’événement routé RightTapped. |
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. |
RotationAxis |
Obtient ou définit l’axe pour faire pivoter l’élément autour. |
RotationTransition |
Obtient ou définit la ScalarTransition qui anime les modifications apportées à la propriété Rotation. |
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. |
ScaleTransition |
Obtient ou définit vector3Transition qui anime les modifications apportées à la propriété Scale. |
Shadow |
Obtient ou définit le cast de l’effet d’ombre par l’élément. |
ShadowProperty |
Identifie la propriété de dépendance shadow |
TabFocusNavigation |
Obtient ou définit une valeur qui modifie la façon dont tabulation et TabIndex fonctionnent pour ce contrôle. |
TabFocusNavigationProperty |
Identifie la propriété de dépendance TabFocusNavigation. |
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 |
TabIndexProperty |
Identifie la propriété de dépendance TabIndex. |
TappedEvent | |
Transform3D |
Obtient ou définit l’effet de transformation 3D à appliquer lors du rendu de cet élément. |
Transform3DProperty |
Identifie la propriété de dépendance transform3D |
TransformMatrix |
Obtient ou définit la matrice de transformation à appliquer à l’élément. |
Transitions |
Obtient ou définit la collection d’éléments de style de Transition qui s’appliquent à un UIElement. |
TransitionsProperty |
Identifie la propriété de dépendance Transitions. |
Translation |
Obtient ou définit la position de rendu x, y et z de l’élément. |
TranslationTransition |
Obtient ou définit vector3Transition qui anime les modifications apportées à la propriété Translation. |
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. |
UseLayoutRoundingProperty |
Identifie la propriété de dépendance UseLayoutRounding |
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. |
UseSystemFocusVisualsProperty |
Identifie la propriété de dépendance UseSystemFocusVisuals. |
Visibility |
Obtient ou définit la visibilité d’un UIElement. Une |
VisibilityProperty |
Identifie la propriété de dépendance Visibility. |
XamlRoot |
Obtient ou définit la |
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. |
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. |
XYFocusDownNavigationStrategyProperty |
Identifie la propriété de dépendance XYFocusDownNavigationStrategy. |
XYFocusDownProperty |
Identifie la propriété de dépendance XYFocusDown. |
XYFocusKeyboardNavigation |
Obtient ou définit une valeur qui active ou désactive la navigation à l’aide des flèches directionnelles du clavier. |
XYFocusKeyboardNavigationProperty |
Identifie la propriété de dépendance XYFocusKeyboardNavigation. |
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. |
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. |
XYFocusLeftNavigationStrategyProperty |
Identifie la propriété de dépendance XYFocusLeftNavigationStrategy. |
XYFocusLeftProperty |
Identifie la propriété de dépendance XYFocusLeft. |
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. |
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. |
XYFocusRightNavigationStrategyProperty |
Identifie la propriété de dépendance XYFocusRightNavigationStrategy. |
XYFocusRightProperty |
Identifie la propriété de dépendance XYFocusRight. |
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. |
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. |
XYFocusUpNavigationStrategyProperty |
Identifie la propriété de dépendance XYFocusUpNavigationStrategy. |
XYFocusUpProperty |
Identifie la propriété de dépendance XYFocusUp. |
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 |
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. |
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. |
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. |
ClearValue(DependencyProperty) |
Efface la valeur locale d’une propriété de dépendance. (Hérité de DependencyObject) |
FindSubElementsForTouchTargeting(Point, Rect) |
Permet à un UIElement sous-classe d’exposer des éléments enfants qui aident à résoudre le ciblage tactile. |
Focus(FocusState) |
Tente de définir le focus sur cet élément. |
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) |
GetChildrenInTabFocusOrder() |
Active un UIElement sous-classe pour exposer les éléments enfants qui participent au focus Tab. |
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 |
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. |
InvalidateMeasure() |
Invalide l’état de mesure (disposition) d’un UIElement. |
Measure(Size) |
Met à jour le desiredSize |
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs) |
Appelé avant l’événement BringIntoViewRequested se produit. |
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. |
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. |
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é. |
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. |
PopulatePropertyInfo(String, AnimationPropertyInfo) |
Définit une propriété qui peut être animée. |
PopulatePropertyInfoOverride(String, AnimationPropertyInfo) |
En cas de substitution dans une classe dérivée, définit une propriété qui peut être animée. |
ReadLocalValue(DependencyProperty) |
Retourne la valeur locale d’une propriété de dépendance, si une valeur locale est définie. (Hérité de DependencyObject) |
RegisterAsScrollPort(UIElement) |
Inscrit un élément comme représentant une fenêtre d’affichage défilante. |
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. |
ReleasePointerCaptures() |
Libère toutes les captures de pointeur détenues par cet élément. |
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. |
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. |
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. |
StartBringIntoView(BringIntoViewOptions) |
Lance une demande à l’infrastructure XAML pour afficher l’élément à l’aide des options spécifiées. |
StartDragAsync(ExpPointerPoint) |
|
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. |
StopAnimation(ICompositionAnimationBase) |
Arrête l’animation spécifiée sur l’élément. |
TransformToVisual(UIElement) |
Retourne un objet de transformation qui peut être utilisé pour transformer les coordonnées de l'UIElement à l’objet spécifié. |
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. |
TryStartDirectManipulation(Pointer) |
Reprend le traitement de manipulation directe (panoramique/zoom défini par le système) sur n’importe quel parent |
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. |
Événements
AccessKeyDisplayDismissed |
Se produit lorsque les clés d’accès ne doivent plus être affichées. |
AccessKeyDisplayRequested |
Se produit lorsque l’utilisateur demande que les clés d’accès soient affichées. |
AccessKeyInvoked |
Se produit lorsqu’un utilisateur termine une séquence de clés d’accès. |
BringIntoViewRequested |
Se produit lorsque StartBringIntoView est appelé sur cet élément ou l’un de ses descendants. |
CharacterReceived |
Se produit lorsqu’un caractère composé unique est reçu par la file d’attente d’entrée. |
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. |
ContextRequested |
Se produit lorsque l’utilisateur a effectué un mouvement d’entrée de contexte, tel qu’un clic droit. |
DoubleTapped |
Se produit lorsqu’une interaction DoubleTap non gérée se produit sur la zone de test de positionnement de cet élément. |
DragEnter |
Se produit lorsque le système d’entrée signale un événement de glissement sous-jacent avec cet élément comme cible. |
DragLeave |
Se produit lorsque le système d’entrée signale un événement de glissement sous-jacent avec cet élément comme origine. |
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. |
DragStarting |
Se produit lorsqu’une opération de glissement est lancée. |
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. |
DropCompleted |
Se produit lorsqu’une opération de glisser-déplacer avec cet élément est terminée. |
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. |
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. |
Holding |
Se produit lorsqu’une interaction hold non gérée se produit sur la zone de test de positionnement de cet élément. |
KeyDown |
Se produit lorsqu’une touche clavier est enfoncée pendant que le UIElement a le focus. |
KeyUp |
Se produit lorsqu’une touche clavier est libérée pendant que le UIElement a le focus. |
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. |
LostFocus |
Se produit lorsqu’un élément UIElement |
ManipulationCompleted |
Se produit lorsqu’une manipulation sur l'UIElement est terminée. |
ManipulationDelta |
Se produit lorsque l’appareil d’entrée change de position pendant une manipulation. |
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. |
ManipulationStarted |
Se produit lorsqu’un appareil d’entrée commence une manipulation sur le UIElement. |
ManipulationStarting |
Se produit lorsque le processeur de manipulation est créé pour la première fois. |
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. |
PointerCanceled |
Se produit lorsqu’un pointeur qui a rendu le contact perd anormalement le contact. |
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. |
PointerEntered |
Se produit lorsqu’un pointeur entre dans la zone de test de positionnement de cet élément. |
PointerExited |
Se produit lorsqu’un pointeur quitte la zone de test de positionnement de cet élément. |
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. |
PointerPressed |
Se produit lorsque l’appareil pointeur lance une action Appuyez sur dans cet élément. |
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 |
PointerWheelChanged |
Se produit lorsque la valeur delta d’une roue de pointeur change. |
PreviewKeyDown |
Se produit lorsqu’une touche clavier est enfoncée pendant que le UIElement a le focus. |
PreviewKeyUp |
Se produit lorsqu’une touche clavier est libérée pendant que le UIElement a le focus. |
ProcessKeyboardAccelerators |
Se produit lorsqu’un raccourci clavier (ou accélérateur) est enfoncé. |
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. |
Tapped |
Se produit lorsqu’une interaction tap non gérée se produit sur la zone de test de positionnement de cet élément. |
S’applique à
Voir aussi
- DependencyObject
- FrameworkElement
- Vue d’ensemble des événements et des événements routés
- Vue d’ensemble des propriétés de dépendance
- exemple de glisser-déplacer
- exemple de d’entrée de base
- exemple d'animations Transform3D