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 des entrées de base dans le cadre de l’interface utilisateur de votre application.
public ref class UIElement : DependencyObject
public ref class UIElement : DependencyObject, IAnimationObject
public ref class UIElement : DependencyObject, IAnimationObject, IVisualElement
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class UIElement : DependencyObject
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class UIElement : DependencyObject, IAnimationObject
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class UIElement : DependencyObject, IAnimationObject, IVisualElement
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class UIElement : DependencyObject
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class UIElement : DependencyObject, IAnimationObject
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 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
Public Class UIElement
Inherits DependencyObject
Public Class UIElement
Inherits DependencyObject
Implements IAnimationObject
Public Class UIElement
Inherits DependencyObject
Implements IAnimationObject, IVisualElement
- Héritage
- Dérivé
- Attributs
- Implémente
Configuration requise pour Windows
Famille d’appareils |
Windows 10 (introduit dans 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduit dans v1.0)
|
Remarques
UIElement est un élément de base : il s’agit d’une classe dont de nombreuses autres classes Windows Runtime héritent afin de prendre en charge le modèle d’élément d’interface utilisateur XAML. Les propriétés, méthodes et événements que définit UIElement sont hérités par des centaines d’autres classes Windows Runtime.
Bien que UIElement définisse les événements pour la création de rapports de focus (GotFocus, LostFocus), UIElement ne définit pas d’API pour définir le focus par programmation. Cette fonctionnalité est définie par la classe Control .
UIElement n’expose pas un constructeur public. En règle générale, vous ne dérivez pas de classes directement d’UIElement ou de FrameworkElement . Les classes de base plus généralement utilisées pour les classes personnalisées dérivées sont les classes 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 (panneau de la classe de base ou 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é Child de Border prend un seul UIElement, qui représente l’élément autour duquel la bordure est dessinée. Vous pouvez fournir n’importe quel élément dérivé d’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 .
Uielement API et fonctionnalités
UIElement étend DependencyObject, qui est un autre élément de base, et ajoute la prise en charge de différents Windows Runtime domaines de fonctionnalités.
Entrée et événements pour répondre à l’interaction utilisateur
Une grande partie du comportement d’entrée pour les éléments visibles dans 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 l’entrée de pointeur, les interactions avec le clavier et les interactions utilisateur personnalisées.
API importante d’UIElement qui prend en charge l’entrée et l’interaction utilisateur :
- Événements de 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, Drop, 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. Les API sont répertoriées 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ètent 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 importante d’UIElement qui prend en charge les mouvements et les manipulations :
- Événements de mouvement :DoubleTapped, Holding, RightTapped, Tappped
- Événements de manipulation :ManipulationCompleted, ManipulationDelta, ManipulationInertiaStarting, ManipulationStarted, ManipulationStarting
- Propriétés qui influencent le traitement des mouvements et des manipulations :IsHoldingEnabled et autres Is*Enabled, ManipulationMode
Apparence de base
Les propriétés Visibilité 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, RenderTransform et 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 XAML et FrameworkElement.
Événements routés
La plupart des événements d’entrée d’UIElement sont des événements routés. Un événement routé active 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 d’objets enfants dans l’arborescence des objets 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 des contrôles. Pour plus d’informations, consultez Vue d’ensemble des événements et des événements routés.
API importante d’UIElement qui prend en charge les événements routés : AddHandler, RemoveHandler, *Event properties.
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 d’interface utilisateur avancés.
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 base du modèle de programmation pour une application UWP en C++, C# ou Visual Basic, telles que les styles et les modèles, la liaison de données, les références de ressources XAML et la logique de modification de propriété. Pour plus d’informations sur les propriétés de dépendance et les fonctionnalités qu’elles prennent 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 d’UIElement est FrameworkElement. Pour obtenir la liste des classes qui dérivent de FrameworkElement, consultez la section « Classes dérivées de FrameworkElement » de la rubrique de référence FrameworkElement .
Historique des versions
Version de Windows | Version du SDK | Valeur ajoutée |
---|---|---|
1607 | 14393 | AccessKey |
1607 | 14393 | AccessKeyDisplayDismissed |
1607 | 14393 | AccessKeyDisplayRequested |
1607 | 14393 | AccessKeyInvoked |
1607 | 14393 | AccessKeyScopeOwner |
1607 | 14393 | ContextCanceled |
1607 | 14393 | ContextFlyout |
1607 | 14393 | ContextRequested |
1607 | 14393 | ExitDisplayModeOnAccessKeyInvoked |
1607 | 14393 | IsAccessKeyScope |
1703 | 15063 | GettingFocus |
1703 | 15063 | GettingFocusEvent |
1703 | 15063 | HighContrastAdjustment |
1703 | 15063 | KeyTipHorizontalOffset |
1703 | 15063 | KeyTipPlacementMode |
1703 | 15063 | KeyTipVerticalOffset |
1703 | 15063 | Lumières |
1703 | 15063 | LosingFocus |
1703 | 15063 | LosingFocusEvent |
1703 | 15063 | NoFocusCandidateFound |
1703 | 15063 | NoFocusCandidateFoundEvent |
1703 | 15063 | StartBringIntoView |
1703 | 15063 | StartBringIntoView(BringIntoViewOptions) |
1703 | 15063 | TabFocusNavigation |
1703 | 15063 | XYFocusDownNavigationStrategy |
1703 | 15063 | XYFocusKeyboardNavigation |
1703 | 15063 | XYFocusLeftNavigationStrategy |
1703 | 15063 | XYFocusRightNavigationStrategy |
1703 | 15063 | XYFocusUpNavigationStrategy |
1709 | 16299 | CharacterReceived |
1709 | 16299 | CharacterReceivedEvent |
1709 | 16299 | GetChildrenInTabFocusOrder |
1709 | 16299 | KeyboardAccelerators |
1709 | 16299 | OnProcessKeyboardAccelerators |
1709 | 16299 | PreviewKeyDown |
1709 | 16299 | PreviewKeyDownEvent |
1709 | 16299 | PreviewKeyUp |
1709 | 16299 | PreviewKeyUpEvent |
1709 | 16299 | ProcessKeyboardAccelerators |
1709 | 16299 | TryInvokeKeyboardAccelerator |
1803 | 17134 | BringIntoViewRequested |
1803 | 17134 | BringIntoViewRequestedEvent |
1803 | 17134 | ContextRequestedEvent |
1803 | 17134 | KeyboardAcceleratorPlacementMode |
1803 | 17134 | KeyboardAcceleratorPlacementTarget |
1803 | 17134 | KeyTipTarget |
1803 | 17134 | OnBringIntoViewRequested |
1803 | 17134 | OnKeyboardAcceleratorInvoked |
1803 | 17134 | RegisterAsScrollPort |
1809 | 17763 | CanBeScrollAnchor |
1809 | 17763 | CenterPoint |
1809 | 17763 | OpacityTransition |
1809 | 17763 | PopulatePropertyInfo |
1809 | 17763 | PopulatePropertyInfoOverride |
1809 | 17763 | Rotation |
1809 | 17763 | RotationAxis |
1809 | 17763 | RotationTransition |
1809 | 17763 | Scale |
1809 | 17763 | ScaleTransition |
1809 | 17763 | StartAnimation |
1809 | 17763 | StopAnimation |
1809 | 17763 | TransformMatrix |
1809 | 17763 | Traduction |
1809 | 17763 | TranslationTransition |
1903 | 18362 | ActualOffset |
1903 | 18362 | ActualSize |
1903 | 18362 | Shadow |
1903 | 18362 | UIContext |
1903 | 18362 | XamlRoot |
Propriétés
AccessKey |
Obtient ou définit la clé d’accès (mnémonique) pour cet élément. |
AccessKeyProperty |
Identifie pour la propriété de dépendance AccessKey . |
AccessKeyScopeOwner |
Obtient ou définit un élément source qui fournit l’étendue de la clé d’accès pour cet élément, même s’il ne se trouve pas dans l’arborescence visuelle de l’élément source. |
AccessKeyScopeOwnerProperty |
Identifie pour la propriété de dépendance AccessKeyScopeOwner . |
ActualOffset |
Obtient la position de cet ÉLÉMENT UIElement, par rapport à son parent, calculée lors de la passe d’organisation du processus de disposition. |
ActualSize |
Obtient la taille que cet ÉLÉMENT UIElement a calculée pendant la passe d’organisation du processus de disposition. |
AllowDrop |
Obtient ou définit une valeur qui détermine si cet élément 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 sous la forme d’une bitmap composite dans la mesure du possible. |
CacheModeProperty |
Identifie la propriété de dépendance CacheMode . |
CanBeScrollAnchor |
Obtient ou définit une valeur qui indique si l’élément UIElement peut être un candidat pour l’ancrage par 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 routé CharacterReceived . |
Clip |
Obtient ou définit le RectangleGeometry utilisé pour définir le plan du contenu d’un élément UIElement. |
ClipProperty |
Identifie la propriété de dépendance Clip . |
CompositeMode |
Obtient ou définit une propriété qui déclare d’autres modes de composition et de fusion 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 pour la propriété de dépendance ContextFlyout . |
ContextRequestedEvent |
Obtient l’identificateur de l’événement routé ContextRequested. |
DesiredSize |
Obtient la taille que cet UIElement a calculée pendant la passe de mesure du processus de disposition. |
Dispatcher |
Obtient le CoreDispatcher auquel cet objet est associé. CoreDispatcher représente une fonctionnalité qui peut accéder à 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) |
DoubleTappedEvent |
Obtient l’identificateur de l’événement routé DoubleTapped . |
DragEnterEvent |
Obtient l’identificateur de l’événement routé DragEnter . |
DragLeaveEvent |
Obtient l’identificateur de l’événement routé DragLeave . |
DragOverEvent |
Obtient l’identificateur de l’événement routé DragOver . |
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 . |
GettingFocusEvent |
Obtient l’identificateur de l’événement routé GettingFocus . |
HighContrastAdjustment |
Obtient ou définit une valeur qui indique si l’infrastructure ajuste automatiquement les propriétés visuelles de l’élément lorsque les 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 pour 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 cet élément UIElement peut retourner des valeurs vraies pour le test 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 . |
IsTapEnabled |
Obtient ou définit une valeur qui détermine si l’événement Tapped 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 l’info-bulle de contrôle affiche la combinaison de touches pour son raccourci clavier associé. |
KeyboardAcceleratorPlacementModeProperty |
Identifie la propriété de dépendance KeyboardAcceleratorPlacementMode . |
KeyboardAcceleratorPlacementTarget |
Obtient ou définit une valeur qui indique l’info-bulle de contrôle 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 routé KeyDown . |
KeyTipHorizontalOffset |
Obtient ou définit une valeur qui indique la distance à gauche ou à droite de l’info-bulle 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 touche d’accès est placée par rapport à la limite de l’élément UIElement. |
KeyTipPlacementModeProperty |
Identifie la propriété de dépendance KeyTipPlacementMode . |
KeyTipTarget |
Obtient ou définit une valeur qui indique l’élément ciblé par la touche d’accès. |
KeyTipTargetProperty |
Identifie la propriété de dépendance KeyTipTarget . |
KeyTipVerticalOffset |
Obtient ou définit une valeur qui indique jusqu’à quel point l’info-bulle 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 routé KeyUp . |
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 routé LosingFocus . |
ManipulationCompletedEvent |
Obtient l’identificateur de l’événement routé ManipulationCompleted . |
ManipulationDeltaEvent |
Obtient l’identificateur de l’événement routé ManipulationDelta . |
ManipulationInertiaStartingEvent |
Obtient l’identificateur de l’événement routé ManipulationInertiaStarting . |
ManipulationMode |
Obtient ou définit la valeur ManipulationModes utilisée pour le comportement uiElement et l’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. |
ManipulationModeProperty |
Identifie la propriété de dépendance ManipulationMode . |
ManipulationStartedEvent |
Obtient l’identificateur de l’événement routé ManipulationStarted . |
ManipulationStartingEvent |
Obtient l’identificateur de l’événement routé ManipulationStarting . |
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 propriété ScalarTransition qui anime les modifications apportées à la propriété Opacity. |
PointerCanceledEvent |
Obtient l’identificateur de l’événement routé PointerCanceled . |
PointerCaptureLostEvent |
Obtient l’identificateur de l’événement routé PointerCaptureLost . |
PointerCaptures |
Obtient l’ensemble de tous les pointeurs capturés, représentés sous forme de valeurs de pointeur . |
PointerCapturesProperty |
Identifie la propriété de dépendance PointerCaptures . |
PointerEnteredEvent |
Obtient l’identificateur de l’événement routé PointerEntered . |
PointerExitedEvent |
Obtient l’identificateur de l’événement routé PointerExited . |
PointerMovedEvent |
Obtient l’identificateur de l’événement routé PointerMoved . |
PointerPressedEvent |
Obtient l’identificateur de l’événement routé PointerPressed . |
PointerReleasedEvent |
Obtient l’identificateur de l’événement routé PointerReleased . |
PointerWheelChangedEvent |
Obtient l’identificateur de l’événement routé PointerWheelChanged . |
PreviewKeyDownEvent |
Obtient l’identificateur de l’événement routé PreviewKeyDown. |
PreviewKeyUpEvent |
Obtient l’identificateur de l’événement routé 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 . |
RenderSize |
Obtient la taille de rendu finale d’un élément UIElement. L’utilisation n’est pas recommandée, voir Remarques. |
RenderTransform |
Obtient ou définit les 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 de l’élément 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. Effectue une rotation par rapport à RotationAxis et au CenterPoint. Affecte la position de rendu de l’élément. |
RotationAxis |
Obtient ou définit l’axe pour faire pivoter l’élément. |
RotationTransition |
Obtient ou définit le 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 le Vector3Transition qui anime les modifications apportées à la propriété Scale. |
Shadow |
Obtient ou définit l’effet d’ombre casté par l’élément . |
ShadowProperty |
Identifie la propriété de dépendance Shadow . |
TabFocusNavigation |
Obtient ou définit une valeur qui modifie le fonctionnement de la tabulation et de TabIndex pour ce contrôle. |
TabFocusNavigationProperty |
Identifie la propriété de dépendance TabFocusNavigation . |
TappedEvent |
Obtient l’identificateur de l’événement routé Tapped . |
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 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 la propriété Vector3Transition qui anime les modifications apportées à la propriété Translation. |
UIContext |
Obtient l’identificateur de contexte de l’élément. |
UseLayoutRounding |
Obtient ou définit une valeur qui détermine si le rendu de l’objet et de sa sous-arborescence visuelle doit utiliser un comportement d’arrondi qui aligne le rendu sur des pixels entiers. |
UseLayoutRoundingProperty |
Identifie la propriété de dépendance UseLayoutRounding . |
Visibility |
Obtient ou définit la visibilité d’un UIElement. Un élément UIElement qui n’est pas visible n’est pas rendu et ne communique pas sa taille souhaitée à la disposition. |
VisibilityProperty |
Identifie la propriété de dépendance Visibility . |
XamlRoot |
Obtient ou définit le |
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 descendante. |
XYFocusDownNavigationStrategyProperty |
Identifie la propriété de dépendance XYFocusDownNavigationStrategy . |
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 . |
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 . |
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 . |
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 . |
Méthodes
AddHandler(RoutedEvent, Object, Boolean) |
Ajoute un gestionnaire d’événements routé pour un événement routé spécifié, en ajoutant le gestionnaire à la collection de gestionnaires sur l’élément actuel. Spécifiez handledEventsToo sur true pour que le gestionnaire fourni soit appelé même si l’événement est géré ailleurs. |
Arrange(Rect) |
Positionne les objets enfants et détermine la taille d’un élément 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 de manipulation directe en cours (panoramique/zoom défini par le système) sur n’importe quel parent ScrollViewer qui contient l’élément UIElement actuel. |
CapturePointer(Pointer) |
Définit la capture de pointeur sur un élément UIElement. Une fois capturé, seul l’élément qui a la capture déclenche les é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 à une sous-classe UIElement d’exposer des éléments enfants qui aident à résoudre le ciblage tactile. |
GetAnimationBaseValue(DependencyProperty) |
Retourne toute valeur de base établie pour une propriété de dépendance, qui s’appliquerait dans les cas où une animation n’est pas active. (Hérité de DependencyObject) |
GetChildrenInTabFocusOrder() |
Permet à une sous-classe UIElement d’exposer des éléments enfants qui prennent part au focus Tab. |
GetValue(DependencyProperty) |
Retourne la valeur effective actuelle d’une propriété de dépendance à partir d’un DependencyObject. (Hérité de DependencyObject) |
InvalidateArrange() |
Invalide l’état d’organisation (disposition) d’un élément UIElement. Après l’invalidation, la disposition de l’élément UIElement est mise à jour, ce qui se produit de manière asynchrone. |
InvalidateMeasure() |
Invalide l’état de mesure (disposition) d’un UIElement. |
Measure(Size) |
Mises à jour desiredSize d’un ÉLÉMENT UIElement. 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 leurs propres implémentations MeasureOverride pour former une mise à jour de disposition récursive. |
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs) |
Appelé avant que l’événement BringIntoViewRequested ne se produise. |
OnCreateAutomationPeer() |
En cas d’implémentation dans une classe dérivée, retourne des implémentations AutomationPeer spécifiques à la classe 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 le traitement d’un raccourci clavier (ou d’un accélérateur) dans votre application. Appelé chaque fois que du code d’application ou des processus internes appellent ProcessKeyboardAccelerators. Remplacez cette méthode pour influencer la gestion de l’accélérateur par défaut. |
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 avec défilement. |
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Inscrit une fonction de notification pour écouter les modifications apportées à un DependencyProperty spécifique sur ce instance DependencyObject. (Hérité de DependencyObject) |
ReleasePointerCapture(Pointer) |
Libère les captures de pointeur pour la capture d’un pointeur spécifique par cet élément 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és spécifié de cet 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 à l’infrastructure XAML pour afficher l’élément dans toutes les régions défilantes dans lesquelles il se trouve. |
StartBringIntoView(BringIntoViewOptions) |
Lance une demande à l’infrastructure XAML pour afficher l’élément à l’aide des options spécifiées. |
StartDragAsync(PointerPoint) |
Démarre une opération de glisser-déplacer. |
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’élément UIElement en l’objet spécifié. |
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs) |
Tente d’appeler un raccourci clavier (ou accélérateur) en recherchant le raccourci dans toute l’arborescence visuelle de l’élément UIElement. |
TryStartDirectManipulation(Pointer) |
Reprend le traitement de manipulation directe (panoramique/zoom défini par le système) sur n’importe quel parent ScrollViewer qui contient l’élément UIElement actuel. |
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 touches 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 en 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 quand le système d’entrée signale un événement de glissement sous-jacent avec pour cible de dépôt potentielle cet élément. |
DragStarting |
Se produit lorsqu’une opération de glissement est lancée. |
Drop |
Se produit quand le système d’entrée signale un événement de déplacement sous-jacent avec cet élément comme cible de déplacement. |
DropCompleted |
Se produit lorsqu’une opération de glisser-déplacer avec cet élément comme source est terminée. |
GettingFocus |
Se produit avant qu’un élément UIElement ne reçoive le focus. Cet événement est déclenché de manière synchrone pour garantir que le focus n’est pas déplacé pendant que l’événement est en cours de bulle. |
GotFocus |
Se produit lorsqu’un élément UIElement reçoit le focus. Cet événement est déclenché de manière asynchrone, de sorte que le focus peut se déplacer à nouveau avant la fin de la bulle. |
Holding |
Se produit lorsqu’une interaction de conservation non gérée se produit au-dessus de la zone de test d’accès de cet élément. |
KeyDown |
Se produit lorsqu’une touche clavier est enfoncée alors que l’élément UIElement a le focus. |
KeyUp |
Se produit lorsqu’une touche clavier est relâchée alors que l’élément UIElement a le focus. |
LosingFocus |
Se produit avant qu’un élément UIElement perde le focus. Cet événement est déclenché de manière synchrone pour garantir que le focus n’est pas déplacé pendant que l’événement est en cours de bulle. |
LostFocus |
Se produit lorsqu’un élément UIElement perd le focus. Cet événement est déclenché de manière asynchrone, de sorte que le focus peut se déplacer à nouveau avant la fin de la bulle. |
ManipulationCompleted |
Se produit lorsqu’une manipulation sur l’élément UIElement est terminée. |
ManipulationDelta |
Se produit lorsque le périphérique d'entrée change de position pendant une manipulation. |
ManipulationInertiaStarting |
Se produit lorsque le périphérique d’entrée perd le contact avec l’objet UIElement durant une manipulation et que cela entraîne un début d’inertie. |
ManipulationStarted |
Se produit lorsqu’un périphérique d’entrée entame une manipulation sur l’objet UIElement. |
ManipulationStarting |
Se produit lorsque le processeur de manipulation est créé initialement. |
NoFocusCandidateFound |
Se produit lorsqu’un utilisateur tente de déplacer le focus (via des tabulations ou des flèches 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 effectué un 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 d’accès de cet élément. |
PointerExited |
Se produit lorsqu’un pointeur quitte la zone de test d’accès de cet élément. |
PointerMoved |
Se produit lorsqu’un pointeur se déplace alors 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 Appuyer dans cet élément. |
PointerReleased |
Se produit lorsque l’appareil pointeur qui a précédemment lancé une action Appuyer est libéré, dans cet élément. Notez que la fin d’une action Press n’est pas garantie pour déclencher un événement PointerReleased ; d’autres événements peuvent se déclencher à la place. Pour plus d’informations, consultez Remarques. |
PointerWheelChanged |
Se produit lorsque la valeur delta d’une roulette de pointeur change. |
PreviewKeyDown |
Se produit lorsqu’une touche clavier est enfoncée alors que l’élément UIElement a le focus. |
PreviewKeyUp |
Se produit lorsqu’une touche clavier est relâchée alors que l’élément UIElement a le focus. |
ProcessKeyboardAccelerators |
Se produit lorsqu’un raccourci clavier (ou un accélérateur) est appuyé. |
RightTapped |
Se produit lorsqu’un stimulus d’entrée d’appui droit se produit alors que le pointeur se trouve au-dessus de l’élément. |
Tapped |
Se produit lorsqu’une interaction Tap non prise en charge se produit sur la zone de test d’accès de cet élément. |
S’applique à
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour