SwapChainPanel Classe

Référence

Définition

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

Important

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

Modifier

Fournit une surface d’hébergement, où les chaînes d’échange Microsoft DirectX fournissent du contenu qui peut être rendu dans une interface utilisateur XAML. Un élément SwapChainPanel est un composant clé d’une application qui affiche les graphiques Microsoft DirectX, puis présente ces visuels dans une page XAML.

/// [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 SwapChainPanel : Grid

[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 SwapChainPanel : Grid

Public Class SwapChainPanel
Inherits Grid

<SwapChainPanel .../>

Héritage: Object IInspectable DependencyObject UIElement FrameworkElement Panel Grid SwapChainPanel

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Remarques

Un SwapChainPanel étant une sous-classe Grid , vous pouvez utiliser les propriétés ColumnDefinitions et RowDefinitions pour déclarer les caractéristiques du panneau, ainsi que les propriétés jointes de Grid telles que Grid.Row et Grid.Column sur les éléments enfants pour positionner ces éléments enfants dans la disposition.

SwapChainPanel hérite de la propriété Background de Panel, mais vous ne pouvez pas définir l’arrière-plan sur un SwapChainPanel. Une erreur se produit si vous tentez de la définir.

La classe SwapChainPanel n’hérite pas de la classe Control . Vous ne pouvez donc pas la concentrer par programmation directement pour capturer des événements clés. Envisagez de définir le focus sur un élément pouvant être mis au point à l’intérieur du panneau et de laisser l’événement clé bulle.

Pour conserver un rendu vectoriel précis, vous devez écouter l’événement CompositionScaleChanged et interroger les valeurs des propriétés CompositionScaleX et CompositionScaleY pour tenir compte de l’échelle actuelle de l’interface utilisateur et éventuellement effectuer un rendu à partir de DirectX. Sinon, la disposition XAML peut effectuer la mise à l’échelle et vos visuels peuvent être détériorés.

Dans WinUI 3, SwapChainPanel ne prend pas en charge la transparence et ne prend pas en charge l’application d’AcryliqueBrush et d’autres effets à l’aide d’un Objet CompositionBackdropBrush. AcryliqueBrush et ces autres effets basés sur CompositionBackdropBrush ne peuvent pas échantillonner à partir d’un SwapChainPanel.

Initialisation d’un élément SwapChainPanel

Pour obtenir des exemples de code qui utilisent SwapChainPanel, consultez Exemple d’interopérabilité Xaml SwapChainPanel DirectX.

Avant qu’un SwapChainPanel puisse afficher du contenu, vous devez l’initialiser du côté Microsoft DirectX.

Castez l’instance SwapChainPanel en IInspectable ou IUnknown, puis appelez QueryInterface pour obtenir une référence à l’interface ISwapChainPanelNative (il s’agit de l’implémentation d’interface native qui est le complément de SwapChainPanel et active le pont d’interopérabilité). Ensuite, appelez ISwapChainPanelNative.SetSwapChain sur cette référence pour associer votre chaîne d’échange implémentée à l’instance SwapChainPanel.

Il est courant de placer le code qui interroge l’interface et définit la chaîne d’échange dans le cadre d’une méthode Create*Resources . Les méthodes Create*Resources sont un modèle d’implémentation qui est visible dans les modèles/exemples de classe Du convertisseur Microsoft DirectX, et vous verrez également ce modèle d’implémentation dans les exemples sdk et dans le code que vous obtenez à partir du modèle de projet DirectX (XAML) dans Microsoft Visual Studio. Plus précisément, dans le modèle de projet DirectX (XAML), vous verrez l’appel QueryInterface et l’appel à ISwapChainPanelNative.SetSwapChain dans l’implémentation de la DeviceResources::CreateWindowSizeDependentResources méthode dans DeviceResources.cpp.

L’API qui vous permet d’ajouter un SwapChain à un SwapChainPanel existant n’est pas une API de classe runtime, mais une API Microsoft DirectX. Vous implémentez l’entrée de la chaîne d’échange en tant qu’interface Microsoft DirectX (IDXGISwapChain).

SwapChainPanel et SwapChainBackgroundPanel

SwapChainPanel a moins de restrictions sur ses interactions et son placement dans l’interface utilisateur que SwapChainBackgroundPanel.

SwapChainPanel peut être utilisé comme contrôle n’importe où dans une arborescence visuelle d’une page. SwapChainBackgroundPanel ne peut être que l’élément racine.
L’API d’interface utilisateur XAML classique héritée de la classe de base Grid peut être utilisée sur un SwapChainPanel. SwapChainBackgroundPanel ne vous permet pas de définir la plupart des API héritées grid .
Pour les nouvelles applications, vous devez généralement utiliser SwapChainPanel et considérer SwapChainBackgroundPanel comme une technique héritée pour Windows 8 applications qui n’ont pas été mises à jour pour Windows 8.1.

Chaînes de permutation

Les chaînes d’échange doivent s’exécuter sur le thread d’interface utilisateur main. Pour ce faire, appelez Généralement SetSwapChain sur une référence qui a été initialisée en tant qu’élément objet XAML.
Une seule chaîne d’échange peut être associée à plusieurs éléments SwapChainPanel. Ou bien, votre application peut avoir plusieurs chaînes d’échange, chacune fournissant la présentation d’un SwapChainPanel distinct.
Toutefois, les performances peuvent diminuer si de nombreuses chaînes d’échange sont mises à jour simultanément. Nous vous recommandons de ne pas utiliser plus de quatre chaînes d’échange.
Le contenu rendu via la chaîne d’échange n’est pas étiré lorsqu’il est redimensionné par l’utilisateur ; au lieu de cela, le comportement de redimensionnement est similaire à la définition Stretch="None" sur un élément Image .
Il existe d’autres techniques pour le rendu du contenu de la chaîne d’échange qui va directement à la fenêtre principale de l’application plutôt qu’à un élément composé en XAML. Consultez CreateSwapChainForCoreWindow.

Traitement des entrées sur les threads d’arrière-plan

À l’aide de la méthode , les CreateCoreIndependentInputSource applications peuvent traiter l’entrée et le rendu dans un SwapChainPanel entièrement sur un ou plusieurs threads d’arrière-plan. Cela permet une entrée et un rendu hautes performances indépendamment du thread d’interface utilisateur XAML.

Constructeurs

SwapChainPanel()

Initialise une nouvelle instance de la classe SwapChainPanel.

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. (Hérité de FrameworkElement)
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 RequestedTheme. (Hérité de FrameworkElement)
ActualWidth	Obtient la largeur rendue d’un FrameworkElement. Consultez la section Notes. (Hérité de FrameworkElement)
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. (Hérité de FrameworkElement)
AllowFocusWhenDisabled	Obtient ou définit si un contrôle désactivé peut recevoir le focus. (Hérité de FrameworkElement)
Background	Obtient ou définit un pinceau qui remplit la zone de contenu du panneau. (Hérité de Panel)
BackgroundSizing	Obtient ou définit une valeur qui indique jusqu’où l’arrière-plan s’étend par rapport à la bordure de cet élément. (Hérité de Grid)
BackgroundTransition	Obtient ou définit une instance de BrushTransition pour animer automatiquement les modifications apportées à la propriété Background. (Hérité de Panel)
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. (Hérité de FrameworkElement)
BorderBrush	Obtient ou définit un pinceau qui décrit le remplissage de bordure du panneau. (Hérité de Grid)
BorderThickness	Obtient ou définit l’épaisseur de bordure du panneau. (Hérité de Grid)
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)
Children	Obtient la collection d’éléments enfants du panneau. (Hérité de Panel)
ChildrenTransitions	Obtient ou définit la collection d’éléments de style Transition qui s’appliquent au contenu enfant d’une sous-classe Panel . (Hérité de Panel)
Clip	Obtient ou définit le RectangleGeometry utilisé pour définir le contour du contenu d’un UIElement. (Hérité de UIElement)
ColumnDefinitions	Obtient une liste d’objets ColumnDefinition définis sur cette instance de Grid. (Hérité de Grid)
ColumnSpacing	Obtient ou définit la distance uniforme (en pixels) entre les colonnes de grille. (Hérité de Grid)
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)
CompositionScaleX	Obtient le facteur d’échelle de l’axe X de SwapChainPanel.
CompositionScaleXProperty	Identifie la propriété de dépendance CompositionScaleX .
CompositionScaleY	Obtient le facteur d’échelle de l’axe y de SwapChainPanel.
CompositionScaleYProperty	Identifie la propriété de dépendance CompositionScaleY .
ContextFlyout	Obtient ou définit le menu volant associé à cet élément. (Hérité de UIElement)
CornerRadius	Obtient ou définit le rayon des coins de la bordure du panneau. (Hérité de Grid)
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 `FrameworkElement` utilise l’extension de balisage {Binding} et participe à la liaison de données. (Hérité de FrameworkElement)
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é. représente `DispatcherQueue` une fonctionnalité 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 tout élément parent qui contrôle leur disposition. Cette propriété peut être définie sur `LeftToRight` ou `RightToLeft`. La définition `FlowDirection` de la `RightToLeft` valeur sur n’importe quel élément définit l’alignement à droite, le sens de lecture de droite à gauche et la disposition du contrôle à passer de droite à gauche. (Hérité de FrameworkElement)
FocusState	Obtient une valeur qui spécifie si ce contrôle a le focus et le mode par lequel le focus a été obtenu. (Hérité de UIElement)
FocusVisualMargin	Obtient ou définit la marge externe du visuel focus pour un FrameworkElement. (Hérité de FrameworkElement)
FocusVisualPrimaryBrush	Obtient ou définit le pinceau utilisé pour dessiner la bordure externe d’un `HighVisibility` visuel ou `Reveal` de focus pour un FrameworkElement. (Hérité de FrameworkElement)
FocusVisualPrimaryThickness	Obtient ou définit l’épaisseur de la bordure externe d’un `HighVisibility` visuel ou `Reveal` de focus pour un FrameworkElement. (Hérité de FrameworkElement)
FocusVisualSecondaryBrush	Obtient ou définit le pinceau utilisé pour dessiner la bordure interne d’un `HighVisibility` visuel ou `Reveal` de focus pour un FrameworkElement. (Hérité de FrameworkElement)
FocusVisualSecondaryThickness	Obtient ou définit l’épaisseur de la bordure interne d’un `HighVisibility` visuel ou `Reveal` de focus pour un FrameworkElement. (Hérité de FrameworkElement)
Height	Obtient ou définit la hauteur suggérée d’un FrameworkElement. (Hérité de FrameworkElement)
HighContrastAdjustment	Obtient ou définit une valeur qui indique si l’infrastructure ajuste automatiquement les propriétés visuelles de l’élément lorsque les thèmes à contraste élevé sont activés. (Hérité de UIElement)
HorizontalAlignment	Obtient ou définit les caractéristiques d’alignement horizontales appliquées à un FrameworkElement lorsqu’il est composé dans un parent de disposition, tel qu’un panneau ou un contrôle d’éléments. (Hérité de FrameworkElement)
IsAccessKeyScope	Obtient ou définit une valeur qui indique si un élément définit sa propre étendue de clé d’accès. (Hérité de UIElement)
IsDoubleTapEnabled	Obtient ou définit une valeur qui détermine si l’événement DoubleTapped peut provenir de cet élément. (Hérité de UIElement)
IsHitTestVisible	Obtient ou définit si la zone 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)
IsItemsHost	Obtient une valeur qui indique si ce panneau est un conteneur pour les éléments d’interface utilisateur générés par un contrôle ItemsControl. (Hérité de Panel)
IsLoaded	Obtient une valeur qui indique si l’élément a été ajouté à l’arborescence d’éléments et est prêt pour l’interaction. (Hérité de FrameworkElement)
IsRightTapEnabled	Obtient ou définit une valeur qui détermine si l’événement RightTapped peut provenir de cet élément. (Hérité de UIElement)
IsTabStop	Obtient ou définit 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 (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 du FrameworkElement actuel dans la représentation d’objet et dans l’interface utilisateur. (Hérité de FrameworkElement)
Lights	Obtient la collection d’objets XamlLight attachés à cet élément. (Hérité de UIElement)
ManipulationMode	Obtient ou définit la valeur ManipulationModes utilisée pour 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. (Hérité de FrameworkElement)
MaxHeight	Obtient ou définit la contrainte de hauteur maximale d’un FrameworkElement. (Hérité de FrameworkElement)
MaxWidth	Obtient ou définit la contrainte de largeur maximale d’un FrameworkElement. (Hérité de FrameworkElement)
MinHeight	Obtient ou définit la contrainte de hauteur minimale d’un FrameworkElement. (Hérité de FrameworkElement)
MinWidth	Obtient ou définit la contrainte de largeur minimale d’un FrameworkElement. (Hérité de FrameworkElement)
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. (Hérité de FrameworkElement)
Opacity	Obtient ou définit le degré d’opacité de l’objet. (Hérité de UIElement)
OpacityTransition	Obtient ou définit la propriété ScalarTransition qui anime les modifications apportées à la propriété Opacity. (Hérité de UIElement)
Padding	Obtient ou définit la distance entre la bordure et son objet enfant. (Hérité de Grid)
Parent	Obtient l’objet parent de ce FrameworkElement dans l’arborescence d’objets. (Hérité de FrameworkElement)
PointerCaptures	Obtient l’ensemble de tous les pointeurs capturés, représentés sous forme de 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 élément UIElement. L’utilisation n’est pas recommandée, voir 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 d’interface utilisateur que vous spécifiez avec `RequestedTheme` peut remplacer le RequestedTheme au niveau de l’application. (Hérité de FrameworkElement)
Resources	Obtient le dictionnaire de ressources défini localement. En XAML, vous pouvez établir des éléments de ressource en tant qu’éléments objet enfants d’un `frameworkElement.Resources` élément de propriété, via la syntaxe de collection implicite XAML. (Hérité de FrameworkElement)
Rotation	Obtient ou définit l’angle de rotation dans le sens des aiguilles d’une montre, en degrés. Effectue une rotation par rapport à RotationAxis et 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 la propriété ScalarTransition qui anime les modifications apportées à la propriété Rotation. (Hérité de UIElement)
RowDefinitions	Obtient une liste d’objets RowDefinition définis sur cette instance de Grid. (Hérité de Grid)
RowSpacing	Obtient ou définit la distance uniforme (en pixels) entre les lignes de grille. (Hérité de Grid)
Scale	Obtient ou définit l’échelle de l’élément . Mise à 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 la propriété 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. (Hérité de FrameworkElement)
TabFocusNavigation	Obtient ou définit une valeur qui modifie le fonctionnement de tabulation 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. (Hérité de FrameworkElement)
Transform3D	Obtient ou définit l’effet de transformation 3D à appliquer lors du rendu de cet élément. (Hérité de UIElement)
TransformMatrix	Obtient ou définit la matrice de transformation à appliquer à l’élément . (Hérité de UIElement)
Transitions	Obtient ou définit la collection d’éléments de style Transition qui s’appliquent à un élément 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. (Hérité de FrameworkElement)
UseLayoutRounding	Obtient ou définit une valeur qui détermine si le rendu de l’objet et de sa sous-arborescence visuelle doit utiliser 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. (Hérité de FrameworkElement)
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. (Hérité de FrameworkElement)
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 « Arranger » de la disposition. Les classes peuvent remplacer cette méthode pour définir leur propre comportement de passe « Arrange ». (Hérité de FrameworkElement)
CancelDirectManipulations()	Annule le traitement 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)
CreateCoreIndependentInputSource(CoreInputDeviceTypes)	Crée un objet d’entrée principal qui gère les types d’entrée comme spécifié par le paramètre deviceTypes . Cet objet d’entrée de base peut traiter les événements d’entrée sur un thread d’arrière-plan.
CreateCoreIndependentInputSource(InputPointerSourceDeviceKinds)	Crée un objet d’entrée principal qui gère les types d’entrée comme spécifié par le paramètre deviceKinds . Cet objet d’entrée de base peut traiter les événements d’entrée sur un thread d’arrière-plan.
FindName(String)	Récupère un objet qui a le nom d’identificateur spécifié. (Hérité de FrameworkElement)
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’appliquerait dans les cas où une animation n’est pas active. (Hérité de DependencyObject)
GetBindingExpression(DependencyProperty)	Renvoie la propriété BindingExpression qui représente la liaison sur la propriété spécifiée. (Hérité de FrameworkElement)
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 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. (Hérité de FrameworkElement)
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. (Hérité de FrameworkElement)
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 passe « Mesure ». (Hérité de FrameworkElement)
OnApplyTemplate()	Appelé chaque fois que du code d’application ou des processus internes (tels qu’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. (Hérité de FrameworkElement)
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 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 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. (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 élément 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. (Hérité de FrameworkElement)
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()	Initie une demande à l’infrastructure XAML pour afficher l’élément dans toutes les régions de défilement dans lesquelles il est contenu. (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 surface d’hébergement, où les chaînes d’échange Microsoft DirectX fournissent du contenu qui peut être rendu dans une interface utilisateur XAML. Un élément SwapChainPanel est un composant clé d’une application qui affiche les graphiques Microsoft DirectX, puis présente ces visuels dans une page XAML. (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 vers l’objet spécifié. (Hérité de UIElement)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)	Tente d’appeler un raccourci clavier (ou un 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 élément UIElement sont correctement mises à jour pour la disposition. (Hérité de UIElement)

Événements

AccessKeyDisplayDismissed	Se produit lorsque les clés d’accès ne doivent plus être affichées. (Hérité de UIElement)
AccessKeyDisplayRequested	Se produit lorsque l’utilisateur demande que les clés d’accès soient affichées. (Hérité de UIElement)
AccessKeyInvoked	Se produit lorsqu’un utilisateur termine une séquence de clés d’accès. (Hérité de UIElement)
ActualThemeChanged	Se produit lorsque la valeur de la propriété ActualTheme a changé. (Hérité de FrameworkElement)
BringIntoViewRequested	Se produit lorsque StartBringIntoView est appelé sur cet élément ou l’un de ses descendants. (Hérité de UIElement)
CharacterReceived	Se produit lorsqu’un caractère composé unique est reçu par la file d’attente d’entrée. (Hérité de UIElement)
CompositionScaleChanged	Se produit lorsque le facteur d’échelle de composition de SwapChainPanel a changé.
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. (Hérité de FrameworkElement)
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. (Hérité de FrameworkElement)
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. (Hérité de FrameworkElement)
Loaded	Se produit lorsqu’un FrameworkElement a été construit et ajouté à l’arborescence d’objets et qu’il est prêt pour l’interaction. (Hérité de FrameworkElement)
Loading	Se produit lorsqu’un élément FrameworkElement commence à se charger. (Hérité de FrameworkElement)
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 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 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 de positionnement 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é, dans cet élément. Notez que la fin d’une action Press 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 roulette de pointeur change. (Hérité de UIElement)
PreviewKeyDown	Se produit lorsqu’une touche clavier est enfoncée alors que l’élément UIElement a le focus. (Hérité de UIElement)
PreviewKeyUp	Se produit lorsqu’une touche clavier est relâché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 appuyé. (Hérité de UIElement)
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. (Hérité de UIElement)
SizeChanged	Se produit lorsque la propriété ActualHeight ou ActualWidth modifie la valeur d’un FrameworkElement. (Hérité de FrameworkElement)
Tapped	Se produit lorsqu’une interaction tap non gérée 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. (Hérité de FrameworkElement)

S’applique à

Partager via