FrameworkElement 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.
Fournit une classe d’élément de base pour Windows Runtime objets d’interface utilisateur.
FrameworkElement définit l’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 d’objets et au suivi de la durée de vie de l’objet.
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
- Dérivé
- Attributs
Remarques
FrameworkElement 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 qui FrameworkElement définit sont hérités par des centaines d’autres classes Windows Runtime.
De nombreuses classes d’interface utilisateur XAML courantes dérivent directement FrameworkElementou via des classes de base intermédiaires telles que Panel ou Control. En règle générale, vous ne dérivez pas directement FrameworkElementdes classes, car certains services attendus pour une classe destinée à une représentation de l’interface utilisateur (comme la prise en charge du modèle) ne 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 :
- 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 classe de base ou implémentations non scellées spécifiques telles que Grid).
Frameworkelement API et fonctionnalités
FrameworkElement étend UIElement, qui est un autre élément de base, et ajoute la prise en charge de différentes zones de fonctionnalités Windows Runtime.
Mise en page
Le système de disposition reconnaît tous les objets qui dérivent d’être FrameworkElement des éléments qui peuvent participer à 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 largeur et la FrameworkElementhauteur définies pour leurs informations de dimensionnement de base.
FrameworkElement fournit des méthodes extensibles pour le 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 de mise en évidence de FrameworkElement cette disposition : Height, Width, ActualHeight, ActualWidth, Margin, MeasureOverride, ArrangeOverride, HorizontalAlignment, VerticalAlignment, LayoutUpdated.
Événements de durée de vie des objets
Vous souhaitez souvent savoir quand un objet est chargé pour la première fois (le chargement est défini comme lorsqu’un objet devient attaché à une arborescence d’objets qui se connecte au visuel racine).
FrameworkElement définit les événements liés à la durée de vie de l’objet qui fournissent des hooks utiles pour les opérations code-behind. Par exemple, vous avez besoin d’informations de 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 d’utiliser, 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 prise en charge des événements de durée de vie des FrameworkElement 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 l’API permettant d’é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 de cette prise en charge de la liaison de FrameworkElement 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éments de votre application ressemble au balisage XAML que vous avez défini pour créer l’interface utilisateur, mais parfois cette structure change 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ément au moment de l’exécution. Pour plus d'informations, consultez les espaces de noms XAML.
API de premier plan de cette prise en charge du modèle XAML et de FrameworkElement programmation : Name, FindName, Parent, BaseUri, OnApplyTemplate.
Globalization
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 de ressources ResourceDictionary et XAML.
Propriétés de dépendance FrameworkElement
La plupart des propriétés en lecture-écriture de la FrameworkElement classe d’élément 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 Windows App SDK à 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 la vue d’ensemble des propriétés de dépendance.
Classes dérivées de FrameworkElement
FrameworkElement est la classe parente pour plusieurs classes dérivées immédiatement qui distinguent plusieurs classifications générales d’éléments d’interface utilisateur. Voici quelques-unes des classes dérivées notables :
- Control : Control a de nombreuses classes de contrôle dérivées, essentiellement tous les contrôles XAML que vous utilisez pour une interface utilisateur Windows Runtime sont dérivés de Control.
- Présentateurs : un présentateur est une classe qui donne une apparence visuelle, généralement en contribuant à un scénario de contrôle, mais le présentateur lui-même n’est généralement pas interactif. Par exemple : Bordure, ContentPresenter (parent de ScrollContentPresenter et d’autres), ItemsPresenter, Viewbox.
- Éléments multimédias et web : Image, WebView, MediaPlayerElement. Ces contenus affichent du contenu et ont un certain niveau d’interactivité qui se produit dans leur contenu, mais ils ne sont pas réellement des contrôles.
- Éléments d’affichage de texte : TextBlock, RichTextBlock, RichTextBlockOverflow, Glyphes. (Les éléments de texte tels que Run et Hyperlink, qui déclarent souvent le contenu d’un élément d’affichage de texte, ne sont pas dérivés de FrameworkElement.)
- Classe de base panneau : Panel est la classe parente pour les panneaux communs tels que Grid, StackPanel , etc.
- Classe de base Shape : Shape est la classe parente pour Path, Rectangle , et ainsi de suite.
- Classe de base IconElement : classe parente pour FontIcon, SymbolIcon , et ainsi de suite.
- Éléments divers de l’interface utilisateur : Fenêtre contextuelle, TickBar, Viewbox.
Constructeurs
| Nom | Description |
|---|---|
| FrameworkElement() |
Fournit un comportement d’initialisation de classe de base pour les classes dérivées de FrameworkElement. |
Propriétés
| Nom | Description |
|---|---|
| AccessKey |
Obtient ou définit la clé d’accès (mnémonique) pour cet élément. (Hérité de UIElement) |
| AccessKeyScopeOwner |
Obtient ou définit un élément source qui fournit l’étendue de clé d’accès pour cet élément, même s’il n’est pas dans l’arborescence visuelle de l’élément source. (Hérité de UIElement) |
| ActualHeight |
Obtient la hauteur rendue d’un FrameworkElement. Voir les remarques. |
| ActualHeightProperty |
Identifie la propriété de dépendance ActualHeight . Voir les remarques. |
| ActualOffset |
Obtient la position de cet UIElement, par rapport à son parent, calculée pendant la passe d’organisation du processus de disposition. (Hérité de UIElement) |
| ActualSize |
Obtient la taille calculée par cet UIElement pendant la passe d’organisation du processus de disposition. (Hérité de UIElement) |
| ActualTheme |
Obtient le thème d’interface utilisateur actuellement utilisé par l’élément, qui peut être différent de l’élément RequestedTheme. |
| ActualThemeProperty |
Identifie la propriété de dépendance ActualTheme. |
| ActualWidth |
Obtient la largeur rendue d’un FrameworkElement. Voir les remarques. |
| ActualWidthProperty |
Identifie la propriété de dépendance ActualWidth . Voir les remarques. |
| AllowDrop |
Obtient ou définit une valeur qui détermine si cet 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 par 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 en tant que bitmap composite si possible. (Hérité de UIElement) |
| CanBeScrollAnchor |
Obtient ou définit une valeur qui indique si l’UIElement peut être un candidat à l’ancrage de défilement. (Hérité de UIElement) |
| CanDrag |
Obtient ou définit une valeur qui indique si l’élément peut être déplacé en tant que données dans une opération de glisser-déplacer. (Hérité de UIElement) |
| CenterPoint |
Obtient ou définit le point central de l’élément, qui est le point sur lequel la rotation ou la mise à l’échelle se produit. Affecte la position de rendu de l’élément. (Hérité de UIElement) |
| Clip |
Obtient ou définit le RectangleGeometry utilisé pour définir le plan du contenu d’un UIElement. (Hérité de UIElement) |
| CompositeMode |
Obtient ou définit une propriété qui déclare des modes de composition et de fusion alternatifs pour l’élément dans sa disposition et sa fenêtre parentes. Cela s’applique aux éléments impliqués dans une interface utilisateur XAML/Microsoft DirectX mixte. (Hérité de UIElement) |
| ContextFlyout |
Obtient ou définit le menu volant associé à cet élément. (Hérité de UIElement) |
| DataContext |
Obtient ou définit le contexte de données d’un FrameworkElement. Une utilisation courante d’un contexte de données est lorsqu’un |
| DataContextProperty |
Identifie la propriété de dépendance DataContext . |
| DesiredSize |
Obtient la taille calculée par cet UIElement pendant la passe de mesure du processus de disposition. (Hérité de UIElement) |
| Dispatcher |
Retourne |
| DispatcherQueue |
Obtient le |
| 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 l’une ou l’autre |
| 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 |
| FocusVisualPrimaryBrushProperty |
Identifie la propriété de dépendance FocusVisualPrimaryBrush . |
| FocusVisualPrimaryThickness |
Obtient ou définit l’épaisseur de la bordure externe d’un |
| FocusVisualPrimaryThicknessProperty |
Identifie la propriété de dépendance FocusVisualPrimaryThickness . |
| FocusVisualSecondaryBrush |
Obtient ou définit le pinceau utilisé pour dessiner la bordure interne d’un |
| FocusVisualSecondaryBrushProperty |
Identifie la propriété de dépendance FocusVisualSecondaryBrush . |
| FocusVisualSecondaryThickness |
Obtient ou définit l’épaisseur de la bordure interne d’un |
| 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 des thèmes à contraste élevé sont activés. (Hérité de UIElement) |
| HorizontalAlignment |
Obtient ou définit les caractéristiques d’alignement horizontale appliquées à un FrameworkElement lorsqu’il est composé dans un parent de disposition, tel qu’un panneau ou un contrôle 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 UIElement peut retourner des valeurs vraies pour les tests de positionnement. (Hérité de UIElement) |
| IsHoldingEnabled |
Obtient ou définit une valeur qui détermine si l’événement Holding peut provenir de cet élément. (Hérité de UIElement) |
| IsLoaded |
Obtient une valeur qui indique si l’élément a été ajouté à l’arborescence d’éléments et est prêt pour l’interaction. |
| IsRightTapEnabled |
Obtient ou définit une valeur qui détermine si l’événement RightTapped peut provenir de cet élément. (Hérité de UIElement) |
| IsTabStop |
Obtient ou définit une valeur qui indique si un contrôle est inclus dans la navigation par onglets. (Hérité de UIElement) |
| IsTapEnabled |
Obtient ou définit une valeur qui détermine si l’événement 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 de son accélérateur 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.
|
| KeyTipHorizontalOffset |
Obtient ou définit une valeur qui indique à quel point l’extrémité gauche ou droite de l’info-bulle est placée par rapport à l’élément UIElement. (Hérité de UIElement) |
| KeyTipPlacementMode |
Obtient ou définit une valeur qui indique où l’info-clé d’accès est placée par rapport à la limite de l’UIElement. (Hérité de UIElement) |
| KeyTipTarget |
Obtient ou définit une valeur qui indique l’élément ciblé par l’info-bulle de clé d’accès. (Hérité de UIElement) |
| KeyTipVerticalOffset |
Obtient ou définit une valeur qui indique jusqu’à quel point l’info-bulle est placée par rapport à l’élément d’interface utilisateur. (Hérité de UIElement) |
| Language |
Obtient ou définit les informations de langage de localisation/globalisation qui s’appliquent à un FrameworkElement, ainsi qu’à tous les éléments enfants du FrameworkElement actuel dans la représentation d’objet et dans l’interface utilisateur. |
| LanguageProperty |
Identifie la propriété de dépendance de langage . |
| 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 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. (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é PAR 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 la ScalarTransition qui anime les modifications apportées à la propriété Opacity. (Hérité de UIElement) |
| Parent |
Obtient l’objet parent de cet 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 un facteur d’échelle supplémentaire à utiliser lors du rendu de formes, d’images, de texte ou de média, généralement pour afficher à une résolution supérieure à la normale. (Hérité de UIElement) |
| RenderSize |
Obtient la taille de rendu finale d’un UIElement. L’utilisation n’est pas recommandée, voir Remarques. (Hérité de UIElement) |
| RenderTransform |
Obtient ou définit des informations de transformation qui affectent la position de rendu d’un UIElement. (Hérité de UIElement) |
| RenderTransformOrigin |
Obtient ou définit le point d’origine de toute transformation de rendu possible déclarée par RenderTransform, par rapport aux limites de l’uiElement. (Hérité de UIElement) |
| RequestedTheme |
Obtient ou définit le thème d’interface utilisateur utilisé par UIElement (et ses éléments enfants) pour la détermination des ressources. Le thème de l’interface utilisateur que |
| 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 ressource en tant qu’éléments d’objet enfant d’un |
| Rotation |
Obtient ou définit l’angle de rotation dans le sens des aiguilles d’une montre, en degrés. Fait pivoter par rapport aux RotationAxis et au CentrePoint. Affecte la position de rendu de l’élément. (Hérité de UIElement) |
| RotationAxis |
Obtient ou définit l’axe pour faire pivoter l’élément autour. (Hérité de UIElement) |
| RotationTransition |
Obtient ou définit la ScalarTransition qui anime les modifications apportées à la propriété Rotation. (Hérité de UIElement) |
| Scale |
Obtient ou définit l’échelle de l’élément. Met à l’échelle par rapport au CenterPoint de l’élément. Affecte la position de rendu de l’élément. (Hérité de UIElement) |
| ScaleTransition |
Obtient ou définit vector3Transition qui anime les modifications apportées à la propriété Scale. (Hérité de UIElement) |
| Shadow |
Obtient ou définit le cast de l’effet d’ombre par l’élément. (Hérité de UIElement) |
| Style |
Obtient ou définit un style d’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 des tabulations et 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 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é. Voir les remarques. |
| UseLayoutRounding |
Obtient ou définit une valeur qui détermine si le rendu de l’objet et de sa sous-arborescence visuelle doit utiliser le comportement d’arrondi qui aligne le rendu sur des pixels entiers. (Hérité de UIElement) |
| UseSystemFocusVisuals |
Obtient ou définit une valeur qui indique si le contrôle utilise des visuels de focus dessinés par le système ou les visuels de focus définis dans le modèle de contrôle. (Hérité de UIElement) |
| VerticalAlignment |
Obtient ou définit les caractéristiques d’alignement vertical appliquées à un FrameworkElement lorsqu’il est composé dans un objet parent tel qu’un panneau ou un contrôle d’éléments. |
| VerticalAlignmentProperty |
Identifie la propriété de dépendance VerticalAlignment . |
| Visibility |
Obtient ou définit la visibilité d’un UIElement. Un |
| Width |
Obtient ou définit la largeur d’un FrameworkElement. |
| WidthProperty |
Identifie la propriété de dépendance Width . |
| XamlRoot |
Obtient ou définit l’élément |
| XYFocusDown |
Obtient ou définit l’objet qui obtient le focus lorsqu’un utilisateur appuie sur le pavé directionnel (D-pad) d’un contrôleur de jeu. (Hérité de UIElement) |
| XYFocusDownNavigationStrategy |
Obtient ou définit une valeur qui spécifie la stratégie utilisée pour déterminer l’élément cible d’une navigation vers le bas. (Hérité de UIElement) |
| XYFocusKeyboardNavigation |
Obtient ou définit une valeur qui active ou désactive la navigation à l’aide des flèches directionnelles du clavier. (Hérité de UIElement) |
| XYFocusLeft |
Obtient ou définit l’objet qui obtient le focus lorsqu’un utilisateur appuie sur gauche sur le pavé directionnel (D-pad) d’un contrôleur de jeu. (Hérité de UIElement) |
| XYFocusLeftNavigationStrategy |
Obtient ou définit une valeur qui spécifie la stratégie utilisée pour déterminer l’élément cible d’une navigation gauche. (Hérité de UIElement) |
| XYFocusRight |
Obtient ou définit l’objet qui obtient le focus lorsqu’un utilisateur appuie à droite sur le pavé directionnel (D-pad) d’un contrôleur de jeu. (Hérité de UIElement) |
| XYFocusRightNavigationStrategy |
Obtient ou définit une valeur qui spécifie la stratégie utilisée pour déterminer l’élément cible d’une navigation droite. (Hérité de UIElement) |
| XYFocusUp |
Obtient ou définit l’objet qui obtient le focus lorsqu’un utilisateur appuie sur le pavé directionnel (D-pad) d’un contrôleur de jeu. (Hérité de UIElement) |
| XYFocusUpNavigationStrategy |
Obtient ou définit une valeur qui spécifie la stratégie utilisée pour déterminer l’élément cible d’une navigation vers le haut. (Hérité de UIElement) |
Méthodes
| Nom | Description |
|---|---|
| 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. (Hérité de UIElement) |
| ArrangeOverride(Size) |
Fournit le comportement de la passe « Organiser » de disposition. Les classes peuvent remplacer cette méthode pour définir leur propre comportement de passe « Arrange ». |
| CancelDirectManipulations() |
Annule le traitement continu de manipulation directe (panoramique/zoom défini par le système) sur n’importe quel parent ScrollViewer qui contient l’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 été capturé déclenche des événements liés au pointeur. (Hérité de UIElement) |
| ClearValue(DependencyProperty) |
Efface la valeur locale d’une propriété de dépendance. (Hérité de DependencyObject) |
| DeferTree(DependencyObject) |
Supprime l’élément spécifié de l’arborescence visuelle XAML de manière à ce qu’il puisse être non défini 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) |
Tente de définir le focus sur cet élément. (Hérité de UIElement) |
| GetAnimationBaseValue(DependencyProperty) |
Retourne toute valeur de base établie pour une propriété de dépendance, qui s’applique dans les cas où une animation n’est pas active. (Hérité de DependencyObject) |
| GetBindingExpression(DependencyProperty) |
Retourne bindingExpression qui représente la liaison sur la propriété spécifiée. |
| GetChildrenInTabFocusOrder() |
Permet à une sous-classe UIElement d’exposer les é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 DependencyObject. (Hérité de DependencyObject) |
| GetVisualInternal() |
Récupère le |
| GoToElementStateCore(String, Boolean) |
En cas d’implémentation dans une classe dérivée, active la construction par état d’une arborescence visuelle pour un modèle de contrôle dans le code, au lieu de charger le code XAML pour tous les états au démarrage du contrôle. |
| InvalidateArrange() |
Invalide l’état d’organisation (disposition) d’un UIElement. Après l’invalidation, uiElement aura sa disposition 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 pour un UIElement utilisé pour calculer la fenêtre d’affichage effective. |
| Measure(Size) |
Met à jour la taille souhaitée 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 passe « 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 les plus simples, cela signifie que la méthode est appelée juste avant qu’un élément d’interface utilisateur ne s’affiche dans votre application. Remplacez cette méthode pour influencer la logique post-modèle par défaut d’une classe. |
| OnBringIntoViewRequested(BringIntoViewRequestedEventArgs) |
Appelé avant l’événement BringIntoViewRequested se produit. (Hérité de UIElement) |
| OnCreateAutomationPeer() |
En cas d’implémentation dans une classe dérivée, retourne des implémentations spécifiques à la classe AutomationPeer pour l’infrastructure Microsoft UI Automation. (Hérité de UIElement) |
| OnDisconnectVisualChildren() |
Remplacez cette méthode pour implémenter le comportement de la disposition et de la logique lorsque des éléments sont supprimés d’un contenu spécifique à une classe ou d’une propriété enfant. (Hérité de UIElement) |
| OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs) |
Appelé lorsqu’un raccourci clavier (ou accélérateur) est traité dans votre application. Remplacez cette méthode pour gérer la façon dont votre application répond lorsqu’un accélérateur clavier est appelé. (Hérité de UIElement) |
| OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) |
Appelé juste avant le traitement d’un raccourci clavier (ou d’un accélérateur) dans votre application. Appelé chaque fois que le code de l’application ou les processus internes appellent ProcessKeyboardAccelerators. Remplacez cette méthode pour influencer la gestion par défaut de l’accélérateur. (Hérité de UIElement) |
| PopulatePropertyInfo(String, AnimationPropertyInfo) |
Définit une propriété qui peut être animée. (Hérité de UIElement) |
| PopulatePropertyInfoOverride(String, AnimationPropertyInfo) |
En cas de substitution dans une classe dérivée, définit une propriété qui peut être animée. (Hérité de UIElement) |
| ReadLocalValue(DependencyProperty) |
Retourne la valeur locale d’une propriété de dépendance, si une valeur locale est définie. (Hérité de DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Inscrit une fonction de notification pour écouter les modifications apportées à une dependencyProperty spécifique sur cette 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é 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 adressée à l’infrastructure XAML pour que l’élément soit visible dans toutes les régions défilantes qu’il contient. (Hérité de UIElement) |
| StartBringIntoView(BringIntoViewOptions) |
Lance une demande à l’infrastructure XAML pour afficher l’élément à l’aide des options spécifiées. (Hérité de UIElement) |
| StartDragAsync(ExpPointerPoint) |
Fournit une classe d’élément de base pour Windows Runtime objets d’interface utilisateur.
|
| 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. (Hérité de UIElement) |
| TransformToVisual(UIElement) |
Retourne un objet de transformation qui peut être utilisé pour transformer les coordonnées de l’uiElement vers l’objet spécifié. (Hérité de UIElement) |
| TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs) |
Tente d’appeler un raccourci clavier (ou accélérateur) en recherchant l’intégralité de l’arborescence visuelle de l’UIElement pour le raccourci. (Hérité de UIElement) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Annule une notification de modification qui a été 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
| Nom | Description |
|---|---|
| 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 se poursuit dans un mouvement de manipulation, pour avertir l’élément que le menu volant de contexte ne doit pas être ouvert. (Hérité de UIElement) |
| ContextRequested |
Se produit lorsque l’utilisateur a effectué un mouvement d’entrée de contexte, tel qu’un clic droit. (Hérité de UIElement) |
| DataContextChanged |
Se produit lorsque la valeur de la propriété FrameworkElement.DataContext change. |
| DoubleTapped |
Se produit lorsqu’une interaction DoubleTap non gérée n’est pas prise en charge sur la zone de test de positionnement de cet élément. (Hérité de UIElement) |
| DragEnter |
Se produit lorsque le système d’entrée signale un événement de glissement sous-jacent avec cet élément comme cible. (Hérité de UIElement) |
| DragLeave |
Se produit lorsque le système d’entrée signale un événement de glissement sous-jacent avec cet élément comme origine. (Hérité de UIElement) |
| DragOver |
Se produit lorsque le système d’entrée signale un événement de glissement sous-jacent avec cet élément comme cible de déplacement potentielle. (Hérité de UIElement) |
| DragStarting |
Se produit lorsqu’une opération de glissement est lancée. (Hérité de UIElement) |
| Drop |
Se produit lorsque le système d’entrée signale un événement de suppression sous-jacent avec cet élément comme cible de suppression. (Hérité de UIElement) |
| DropCompleted |
Se produit lorsqu’une opération de glisser-déplacer avec cet élément est terminée. (Hérité de UIElement) |
| EffectiveViewportChanged |
Se produit lorsque la fenêtre d’affichage effective de FrameworkElement change. |
| GettingFocus |
Se produit avant qu’un UIElement ne reçoive le focus. Cet événement est déclenché de façon synchrone pour vous assurer que le focus n’est pas déplacé pendant que l’événement est en cours de propagation. (Hérité de UIElement) |
| GotFocus |
Se produit lorsqu’un UIElement reçoit le focus. Cet événement est déclenché de façon asynchrone, ce qui permet au focus de se déplacer à nouveau avant la fin de l’opération. (Hérité de UIElement) |
| Holding |
Se produit lorsqu’une interaction de mise en attente non gérée se produit sur la zone de test de positionnement de cet élément. (Hérité de UIElement) |
| KeyDown |
Se produit lorsqu’une touche clavier est enfoncée pendant que l’élément UIElement a le focus. (Hérité de UIElement) |
| KeyUp |
Se produit lorsqu’une touche de clavier est libérée pendant que l’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 est prêt à l’interaction. |
| Loading |
Se produit lorsqu’un FrameworkElement commence à être chargé. |
| LosingFocus |
Se produit avant qu’un UIElement ne perde le focus. Cet événement est déclenché de façon synchrone pour vous assurer que le focus n’est pas déplacé pendant que l’événement est en cours de propagation. (Hérité de UIElement) |
| LostFocus |
Se produit lorsqu’un UIElement perd le focus. Cet événement est déclenché de façon asynchrone, ce qui permet au focus de se déplacer à nouveau avant la fin de l’opération. (Hérité de UIElement) |
| ManipulationCompleted |
Se produit lorsqu’une manipulation sur l’é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 l’appareil d’entrée perd le contact avec l’objet UIElement pendant une manipulation et l’inertie commence. (Hérité de UIElement) |
| ManipulationStarted |
Se produit lorsqu’un appareil d’entrée commence une manipulation sur l’uiElement. (Hérité de UIElement) |
| ManipulationStarting |
Se produit lorsque le processeur de manipulation est créé pour la première fois. (Hérité de UIElement) |
| NoFocusCandidateFound |
Se produit lorsqu’un utilisateur tente de déplacer le focus (via des flèches tabulation ou directionnelles), mais que le focus ne se déplace pas, car aucun candidat au focus n’est trouvé dans la direction du mouvement. (Hérité de UIElement) |
| PointerCanceled |
Se produit lorsqu’un pointeur qui a rendu le contact perd anormalement le contact. (Hérité de UIElement) |
| PointerCaptureLost |
Se produit lorsque la capture de pointeur précédemment détenue par cet élément se déplace vers un autre élément ou ailleurs. (Hérité de UIElement) |
| PointerEntered |
Se produit lorsqu’un pointeur entre dans la zone de test de positionnement de cet élément. (Hérité de UIElement) |
| PointerExited |
Se produit lorsqu’un pointeur quitte la zone de test de positionnement de cet élément. (Hérité de UIElement) |
| PointerMoved |
Se produit lorsqu’un pointeur se déplace pendant que le pointeur reste dans la zone de test de positionnement de cet élément. (Hérité de UIElement) |
| PointerPressed |
Se produit lorsque l’appareil pointeur lance une action Press dans cet élément. (Hérité de UIElement) |
| PointerReleased |
Se produit lorsque l’appareil pointeur qui a lancé précédemment une action Press est libéré, tandis qu’au sein de cet élément. Notez que la fin d’une action De presse n’est pas garantie de déclencher un |
| PointerWheelChanged |
Se produit lorsque la valeur delta d’une roue de pointeur change. (Hérité de UIElement) |
| PreviewKeyDown |
Se produit lorsqu’une touche clavier est enfoncée pendant que l’élément UIElement a le focus. (Hérité de UIElement) |
| PreviewKeyUp |
Se produit lorsqu’une touche de clavier est libérée pendant que l’uiElement a le focus. (Hérité de UIElement) |
| ProcessKeyboardAccelerators |
Se produit lorsqu’un raccourci clavier (ou accélérateur) est enfoncé. (Hérité de UIElement) |
| RightTapped |
Se produit lorsqu’un stimulus d’entrée de la touche droite se produit pendant que le pointeur se trouve sur l’élément. (Hérité de UIElement) |
| SizeChanged |
Se produit lorsque la propriété ActualHeight ou ActualWidth change de valeur sur un FrameworkElement. |
| Tapped |
Se produit lorsqu’une interaction tap non gérée n’est pas prise en charge sur la zone de test de positionnement de cet élément. (Hérité de UIElement) |
| Unloaded |
Se produit lorsque cet objet n’est plus connecté à l’arborescence d’objets principale. |