FrameworkElement Classe

Définition

Fournit une classe d’élément de base pour Windows Runtime objets d’interface utilisateur. FrameworkElement définit une API commune qui prend en charge l’interaction de l’interface utilisateur et le système de disposition automatique. FrameworkElement définit également l’API liée à la liaison de données, à la définition et à l’examen de l’arborescence des objets et au suivi de la durée de vie des objets.

public ref class FrameworkElement : UIElement
/// [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 FrameworkElement : UIElement
[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 FrameworkElement : UIElement
Public Class FrameworkElement
Inherits UIElement
Héritage
Object Platform::Object IInspectable DependencyObject UIElement FrameworkElement
Dérivé
Attributs

Remarques

FrameworkElementest 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, les méthodes et les événements qui FrameworkElement définissent sont hérités par des centaines d’autres classes Windows Runtime.

De nombreuses classes d’interface utilisateur XAML courantes dérivent de FrameworkElement, directement ou via des classes de base intermédiaires telles que Panel ou Control. En règle générale, vous ne dérivez pas de classes directement à partir de FrameworkElement, car certains services attendus pour une classe destinée à une représentation de l’interface utilisateur (par exemple, la prise en charge des modèles) n’y sont pas entièrement implémentés. Les classes de base les plus couramment utilisées pour les classes personnalisées dérivées sont les suivantes :

Frameworkelement API et fonctionnalités

FrameworkElementétend UIElement, qui est un autre élément de base, et ajoute la prise en charge de différents domaines de fonctionnalités Windows Runtime.

Layout

Le système de disposition reconnaît tous les objets qui dérivent de FrameworkElement pour être des éléments qui participent potentiellement à la disposition et doivent avoir une zone d’affichage dans l’interface utilisateur de l’application. Le système de disposition lit différentes propriétés définies au FrameworkElement niveau, telles que MinWidth. La plupart des éléments d’interface utilisateur utilisent la FrameworkElementlargeur et la hauteur définies pour leurs informations de dimensionnement de base. FrameworkElement fournit des méthodes extensibles pour un comportement de disposition spécialisé que les panneaux et les contrôles avec du contenu peuvent remplacer dans leurs implémentations de classe. Pour plus d’informations, consultez Définir des dispositions avec XAML.

API FrameworkElement de premier plan qui prend en charge la disposition : Height, Width, ActualHeight, ActualWidth, Margin, MeasureOverride, ArrangeOverride, HorizontalAlignment, VerticalAlignment, LayoutUpdated.

Événements de la durée de vie d’un objet

Vous voulez souvent savoir quand un objet est chargé pour la première fois (le chargement est défini comme lorsqu’un objet est attaché à une arborescence d’objets qui se connecte au visuel racine). FrameworkElement définit des événements liés à la durée de vie des objets qui fournissent des hooks utiles pour les opérations code-behind. Par exemple, vous avez besoin d’informations sur la durée de vie des objets pour ajouter des objets enfants à une collection ou définir des propriétés sur des objets enfants juste avant l’utilisation, avec l’assurance que les objets nécessaires dans l’arborescence d’objets ont déjà été instanciés à partir du balisage XAML. Pour plus d’informations, consultez Vue d’ensemble des événements et des événements routés.

API de premier plan qui FrameworkElement prend en charge les événements de durée de vie des objets : Loaded, SizeChanged, Unloaded, OnApplyTemplate.

Liaison de données

La possibilité de définir une valeur pour un contexte de données potentiellement hérité pour une liaison de données est implémentée par FrameworkElement. FrameworkElement a également une API pour établir une liaison de données dans le code plutôt que dans XAML. Pour plus d’informations, voir Présentation détaillée de la liaison de données.

API de premier plan qui FrameworkElement prend en charge la liaison de données : DataContext, DataContextChanged, SetBinding, GetBindingExpression.

Intégration du langage XAML et du modèle de programmation

En règle générale, la structure d’élément de votre application ressemble au balisage XAML que vous avez défini pour créer l’interface utilisateur, mais cette structure change parfois après l’analyse du CODE XAML. FrameworkElement définit la propriété Name et l’API associée, qui sont utiles pour rechercher des éléments et des relations d’éléments au moment de l’exécution. Pour plus d’informations, voir Namescopes XAML.

API de premier plan qui FrameworkElement prend en charge xaml et le modèle de programmation : Name, FindName, Parent, BaseUri, OnApplyTemplate.

Globalisation

La FrameworkElement classe définit la propriété Language et la propriété FlowDirection . Pour plus d’informations, consultez Globalisation de votre application.

Prise en charge du style et du thème

La FrameworkElement classe définit la propriété Style et la propriété RequestedTheme . En outre, la propriété Resources est utilisée pour définir les dictionnaires de ressources XAML au niveau de la page qui définissent généralement des styles et des modèles, ainsi que d’autres ressources partagées. Pour plus d’informations, consultez Contrôles de style et Références aux ressources ResourceDictionary et XAML.

Propriétés de dépendance FrameworkElement

La plupart des propriétés en lecture-écriture de la classe d’élément FrameworkElement de base 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 SDK d'application Windows en 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 de modification des propriétés. 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 de FrameworkElement

FrameworkElement est la classe parente de plusieurs classes dérivées immédiatement qui distinguent plusieurs classifications générales des éléments d’interface utilisateur. Voici quelques-unes des classes dérivées notables :

Constructeurs

FrameworkElement()

Fournit le comportement d’initialisation de classe de base pour les classes dérivées de FrameworkElement.

Propriétés

AccessKey

Obtient ou définit la clé d’accès (mnémonique) de cet élément.

(Hérité de UIElement)
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.

(Hérité de UIElement)
ActualHeight

Obtient la hauteur rendue d’un FrameworkElement. Consultez la section Notes.

ActualHeightProperty

Identifie la propriété de dépendance ActualHeight . Consultez la section Notes.

ActualOffset

Obtient la position de cet UIElement, par rapport à son parent, calculée lors de la passe d’organisation du processus de disposition.

(Hérité de UIElement)
ActualSize

Obtient la taille calculée par ce 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’élément RequestedTheme.

ActualThemeProperty

Identifie la propriété de dépendance ActualTheme.

ActualWidth

Obtient la largeur rendue d’un FrameworkElement. Consultez la section Notes.

ActualWidthProperty

Identifie la propriété de dépendance ActualWidth . Consultez la section Notes.

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.

(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.

AllowFocusOnInteractionProperty

Identifie la propriété de dépendance AllowFocusOnInteraction .

AllowFocusWhenDisabled

Obtient ou définit si un contrôle désactivé peut recevoir le focus.

AllowFocusWhenDisabledProperty

Identifie la propriété de dépendance AllowFocusWhenDisabled .

BaseUri

Obtient un URI (Uniform Resource Identifier) qui représente l’URI de base d’un objet construit en XAML au moment du chargement XAML. Cette propriété est utile pour la résolution d’URI au moment de l’exécution.

CacheMode

Obtient ou définit une valeur qui indique que le contenu rendu doit être mis en cache sous forme de bitmap composite lorsque cela est possible.

(Hérité de UIElement)
CanBeScrollAnchor

Obtient ou définit une valeur qui indique si l’élément UIElement peut être un candidat pour 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 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 MIXTE XAML/Microsoft DirectX.

(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’un FrameworkElement. Une utilisation courante d’un contexte de données est quand un FrameworkElement utilise l’extension de balisage {Binding} et participe à la liaison de données.

DataContextProperty

Identifie la propriété de dépendance DataContext .

DesiredSize

Obtient la taille calculée par ce UIElement pendant la passe de mesure du processus de disposition.

(Hérité de UIElement)
Dispatcher

Retourne null toujours dans une application SDK d'application Windows. Utilisez DispatcherQueue à la place.

(Hérité de DependencyObject)
DispatcherQueue

Obtient le DispatcherQueue auquel cet objet est associé. DispatcherQueue représente une installation qui peut accéder au 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)
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. La définition FlowDirection de sur RightToLeft n’importe quel élément définit l’alignement à droite, l’ordre de lecture de droite à gauche et la disposition du contrôle pour qu’elle passe de droite à gauche.

FlowDirectionProperty

Identifie la propriété de dépendance FlowDirection .

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.

FocusVisualMarginProperty

Identifie la propriété de dépendance FocusVisualMargin .

FocusVisualPrimaryBrush

Obtient ou définit le pinceau utilisé pour dessiner la bordure externe d’un HighVisibility visuel ou Reveal de focus pour un FrameworkElement.

FocusVisualPrimaryBrushProperty

Identifie la propriété de dépendance FocusVisualPrimaryBrush .

FocusVisualPrimaryThickness

Obtient ou définit l’épaisseur de la bordure externe d’un HighVisibility visuel ou Reveal focus pour un FrameworkElement.

FocusVisualPrimaryThicknessProperty

Identifie la propriété de dépendance FocusVisualPrimaryThickness .

FocusVisualSecondaryBrush

Obtient ou définit le pinceau utilisé pour dessiner la bordure interne d’un HighVisibility visuel ou Reveal de focus pour un FrameworkElement.

FocusVisualSecondaryBrushProperty

Identifie la propriété de dépendance FocusVisualSecondaryBrush .

FocusVisualSecondaryThickness

Obtient ou définit l’épaisseur de la bordure interne d’un HighVisibility visuel ou Reveal de focus pour un FrameworkElement.

FocusVisualSecondaryThicknessProperty

Identifie la propriété de dépendance FocusVisualSecondaryThickness .

Height

Obtient ou définit la hauteur suggérée d’un FrameworkElement.

HeightProperty

Identifie la propriété de dépendance Height .

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.

(Hérité de UIElement)
HorizontalAlignment

Obtient ou définit les caractéristiques d’alignement horizontal qui sont appliquées à un FrameworkElement lorsqu’il est composé dans un parent de disposition, tel qu’un contrôle de panneau ou d’éléments.

HorizontalAlignmentProperty

Identifie la propriété de dépendance HorizontalAlignment .

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 autonome de cet élément UIElement peut retourner des valeurs vraies pour le test d’accès.

(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.

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 l'inclusion ou non d'un contrôle dans la navigation par onglets.

(Hérité de UIElement)
IsTapEnabled

Obtient ou définit une valeur qui détermine si l’événement Tapped peut provenir de cet élément.

(Hérité de UIElement)
KeyboardAcceleratorPlacementMode

Obtient ou définit une valeur qui indique si l’info-bulle de contrôle 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 l’info-bulle de contrôle 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 accélérateurs de clavier pour différents éléments de menu
Exemple de menu montrant les accélérateurs de clavier pour différents éléments de menu

(Hérité de UIElement)
KeyTipHorizontalOffset

Obtient ou définit une valeur qui indique la distance à gauche ou à droite de l’élément clé par rapport à l’élément UIElement.

(Hérité de UIElement)
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.

(Hérité de UIElement)
KeyTipTarget

Obtient ou définit une valeur qui indique l’élément ciblé par le conseil de clé d’accès.

(Hérité de UIElement)
KeyTipVerticalOffset

Obtient ou définit une valeur qui indique jusqu’à quel point le key tip est placé 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’élément FrameworkElement actuel dans la représentation d’objet et dans l’interface utilisateur.

LanguageProperty

Identifie la propriété de dépendance Language .

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 le comportement et l’interaction uiElement avec les mouvements. La définition de cette valeur permet de gérer les événements de manipulation de cet élément dans le code d’application.

(Hérité de UIElement)
Margin

Obtient ou définit la marge externe d’un FrameworkElement.

MarginProperty

Identifie la propriété de dépendance Margin .

MaxHeight

Obtient ou définit la contrainte de hauteur maximale d’un FrameworkElement.

MaxHeightProperty

Identifie la propriété de dépendance MaxHeight .

MaxWidth

Obtient ou définit la contrainte de largeur maximale d’un FrameworkElement.

MaxWidthProperty

Identifie la propriété de dépendance MaxWidth .

MinHeight

Obtient ou définit la contrainte de hauteur minimale d’un FrameworkElement.

MinHeightProperty

Identifie la propriété de dépendance MinHeight .

MinWidth

Obtient ou définit la contrainte de largeur minimale d’un FrameworkElement.

MinWidthProperty

Identifie la propriété de dépendance MinWidth .

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é XAML par ce nom.

NameProperty

Identifie la propriété de dépendance Name .

Opacity

Obtient ou définit le degré d’opacité de l’objet.

(Hérité de UIElement)
OpacityTransition

Obtient ou définit le ScalarTransition qui anime les modifications apportées à la propriété Opacity.

(Hérité de UIElement)
Parent

Obtient l’objet parent de ce FrameworkElement dans l’arborescence d’objets.

PointerCaptures

Obtient l’ensemble de tous les pointeurs capturés, représentés en tant que valeurs de 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, consultez Remarques.

(Hérité de UIElement)
RenderTransform

Obtient ou définit les 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 de l’élément UIElement.

(Hérité de UIElement)
RequestedTheme

Obtient ou définit le thème d’interface utilisateur utilisé par l’élément UIElement (et ses éléments enfants) pour la détermination des ressources. Le thème de l’interface utilisateur avec RequestedTheme lequel vous spécifiez peut remplacer le thème RequestedTheme au niveau de l’application.

RequestedThemeProperty

Identifie la propriété de dépendance RequestedTheme .

Resources

Obtient le dictionnaire de ressources défini localement. En XAML, vous pouvez établir des éléments de ressources en tant qu’éléments d’objet enfants d’un frameworkElement.Resources élément de propriété, via la syntaxe de collection implicite XAML.

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.

(Hérité de UIElement)
RotationAxis

Obtient ou définit l’axe pour faire pivoter l’élément.

(Hérité de UIElement)
RotationTransition

Obtient ou définit le 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 le Vector3Transition qui anime les modifications apportées à la propriété Scale.

(Hérité de UIElement)
Shadow

Obtient ou définit l’effet d’ombre casté par l’élément .

(Hérité de UIElement)
Style

Obtient ou définit un style instance appliqué à cet objet pendant la disposition et le rendu.

StyleProperty

Identifie la propriété de dépendance Style .

TabFocusNavigation

Obtient ou définit une valeur qui modifie le fonctionnement de la tabulation et de TabIndex 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 Tab .

(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.

TagProperty

Identifie la propriété de dépendance Tag .

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 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 la propriété 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. Ce n’est pas couramment utilisé. Consultez la section Notes.

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.

(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 des 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 qui sont appliquées à un FrameworkElement lorsqu’il est composé dans un objet parent tel qu’un contrôle de panneau ou d’éléments.

VerticalAlignmentProperty

Identifie la propriété de dépendance VerticalAlignment .

Visibility

Obtient ou définit la visibilité d’un élément UIElement. Un UIElement qui n’est pas visible n’est pas rendu et ne communique pas sa taille souhaitée à la disposition.

(Hérité de UIElement)
Width

Obtient ou définit la largeur d’un FrameworkElement.

WidthProperty

Identifie la propriété de dépendance Width .

XamlRoot

Obtient ou définit le XamlRoot dans lequel cet élément est visualisé.

(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 la 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 de gauche.

(Hérité de UIElement)
XYFocusRight

Obtient ou définit l’objet qui obtient le focus lorsqu’un utilisateur appuie vers la 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)

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 que true le gestionnaire fourni doit être 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 la disposition. Les classes peuvent remplacer cette méthode pour définir leur propre comportement de passage « Arrange ».

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.

(Hérité de UIElement)
CapturePointer(Pointer)

Définit la capture de pointeur sur un UIElement. Une fois capturé, seul l’élément qui a la capture 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)
DeferTree(DependencyObject)

Supprime l’élément spécifié de l’arborescence visuelle XAML de manière à ce qu’il puisse être supprimé ultérieurement.

FindName(String)

Récupère un objet qui a le nom d’identificateur spécifié.

FindSubElementsForTouchTargeting(Point, Rect)

Permet à une sous-classe UIElement d’exposer des éléments enfants qui aident à résoudre le ciblage tactile.

(Hérité de UIElement)
Focus(FocusState)

Essaie d'affecter 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.

GetChildrenInTabFocusOrder()

Permet à une sous-classe UIElement d’exposer des éléments enfants qui participent au focus Tab.

(Hérité de UIElement)
GetValue(DependencyProperty)

Retourne la valeur effective actuelle d’une propriété de dépendance à partir d’un objet DependencyObject.

(Hérité de DependencyObject)
GetVisualInternal()

Récupère le Visual auquel 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, plutôt qu’en chargeant XAML pour tous les états au démarrage du contrôle.

InvalidateArrange()

Invalide l’état d’organisation (disposition) d’un UIElement. Après l’invalidation, la disposition de l’élément UIElement est mise à jour, ce qui se produit de manière 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 élément UIElement utilisé pour calculer la fenêtre d’affichage effective.

Measure(Size)

Mises à jour le DesiredSize d’un 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.

(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 passage « Measure ».

OnApplyTemplate()

Appelé chaque fois que le code d’application ou les processus internes (par exemple, une passe de disposition de reconstruction) appellent ApplyTemplate. En termes 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.

OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)

Appelé avant l’événement BringIntoViewRequested .

(Hérité de UIElement)
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.

(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’une propriété enfant ou de contenu spécifique à une classe.

(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 de 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 d’application ou les processus internes appellent ProcessKeyboardAccelerators. Remplacez cette méthode pour influencer la gestion de l’accélérateur par défaut.

(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 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 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és spécifié de cet 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.

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 à l’infrastructure XAML pour afficher l’élément dans toutes les régions défilantes dans lesquelles il se trouve.

(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)

Fournit une classe d’élément de base pour Windows Runtime objets d’interface utilisateur. FrameworkElement définit une API commune qui prend en charge l’interaction de l’interface utilisateur et le système de disposition automatique. FrameworkElement définit également l’API liée à la liaison de données, à la définition et à l’examen de l’arborescence des objets et au suivi de la durée de vie des objets.

(Hérité de UIElement)
StartDragAsync(PointerPoint)

Démarre 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’élément UIElement en l’objet spécifié.

(Hérité de UIElement)
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.

(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é.

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 continue 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 terminé 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.

DoubleTapped

Se produit lorsqu’une interaction DoubleTap non prise en charge se produit sur la zone de test d’accès 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 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.

(Hérité de UIElement)
DragStarting

Se produit lorsqu’une opération de glisser-glisser est lancée.

(Hérité de UIElement)
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.

(Hérité de UIElement)
DropCompleted

Se produit lorsqu’une opération de glisser-déplacer avec cet élément comme source est terminée.

(Hérité de UIElement)
EffectiveViewportChanged

Se produit lorsque la fenêtre d’affichage effective de FrameworkElement change.

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 bulles.

(Hérité de UIElement)
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 que le bouillonnement ne soit terminé.

(Hérité de UIElement)
Holding

Se produit lorsqu’une interaction hold non prise en charge se produit sur la zone de test d’accès de cet élément.

(Hérité de UIElement)
KeyDown

Se produit lorsqu’une touche de clavier est enfoncée alors que l’élément UIElement a le focus.

(Hérité de UIElement)
KeyUp

Se produit lorsqu’une touche de clavier est libérée alors que l’élément 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.

Loaded

Se produit lorsqu’un frameworkElement a été construit et ajouté à l’arborescence d’objets et qu’il est prêt pour l’interaction.

Loading

Se produit lorsqu’un frameworkElement commence à charger.

LosingFocus

Se produit avant qu’un élément UIElement ne 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 bulles.

(Hérité de UIElement)
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 que le bouillonnement ne soit terminé.

(Hérité de UIElement)
ManipulationCompleted

Se produit lorsqu’une manipulation sur l’élément UIElement est terminée.

(Hérité de UIElement)
ManipulationDelta

Se produit lorsque le périphérique d'entrée change de position pendant une manipulation.

(Hérité de UIElement)
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.

(Hérité de UIElement)
ManipulationStarted

Se produit lorsqu’un périphérique d’entrée entame une manipulation sur l’objet UIElement.

(Hérité de UIElement)
ManipulationStarting

Se produit lorsque le processeur de manipulation est créé initialement.

(Hérité de UIElement)
NoFocusCandidateFound

Se produit lorsqu’un utilisateur tente de déplacer le focus (via des onglets ou des flèches directionnelles), mais que le focus ne se déplace pas, car aucun candidat de focus n’est trouvé dans la direction du mouvement.

(Hérité de UIElement)
PointerCanceled

Se produit lorsqu’un pointeur qui a effectué un contact anormalement perd 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 d’accès de cet élément.

(Hérité de UIElement)
PointerExited

Se produit lorsqu’un pointeur quitte la zone de test d’accès de cet élément.

(Hérité de UIElement)
PointerMoved

Se produit lorsqu’un pointeur se déplace alors que le pointeur reste dans la zone de test d’accès de cet élément.

(Hérité de UIElement)
PointerPressed

Se produit lorsque l’appareil pointeur lance une action Appuyer dans cet élément.

(Hérité de UIElement)
PointerReleased

Se produit lorsque l’appareil pointeur qui a précédemment lancé une action Appuyer est libéré, au sein de cet élément. Notez que la fin d’une action Appuyer n’est pas garantie pour déclencher un PointerReleased événement ; 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 de clavier est enfoncée alors que l’élément UIElement a le focus.

(Hérité de UIElement)
PreviewKeyUp

Se produit lorsqu’une touche de clavier est libérée alors que l’élément UIElement a le focus.

(Hérité de UIElement)
ProcessKeyboardAccelerators

Se produit lorsqu’un raccourci clavier (ou un accélérateur) est enfoncé.

(Hérité de UIElement)
RightTapped

Se produit lorsqu’un stimulus d’entrée à droite se produit alors que le pointeur se trouve sur l’élément.

(Hérité de UIElement)
SizeChanged

Se produit lorsque la propriété ActualHeight ou ActualWidth modifie la valeur d’un FrameworkElement.

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.

(Hérité de UIElement)
Unloaded

Se produit lorsque cet objet n’est plus connecté à l’arborescence d’objets main.

S’applique à

Voir aussi