Partage via


Image Classe

Définition

Représente un contrôle qui affiche une image. La source d’image est spécifiée en faisant référence à un fichier image, à l’aide de plusieurs formats pris en charge. La source d’image peut également être définie avec un flux. Consultez Remarques pour obtenir la liste des formats de source d’images pris en charge.

public ref class Image sealed : FrameworkElement
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Image final : FrameworkElement
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class Image final : FrameworkElement
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class Image : FrameworkElement
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class Image : FrameworkElement
Public NotInheritable Class Image
Inherits FrameworkElement
<Image .../>
Héritage
Object Platform::Object IInspectable DependencyObject UIElement FrameworkElement Image
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Conseil

Pour plus d’informations, des conseils de conception et des exemples de code, consultez Image.

L’application WinUI 2 Gallery comprend des exemples interactifs de la plupart des contrôles et fonctionnalités WinUI 2. Procurez-vous l’application sur le Microsoft Store ou le code source sur GitHub.

Remarques

Formats de fichier d’image

Une image peut afficher les formats de fichier image suivants :

  • Joint Photographic Experts Group (JPEG)
  • format PNG (Portable Network Graphics)
  • image bitmap (BMP)
  • format GIF (Graphics Interchange Format)
  • format TIFF (Tagged Image File Format)
  • JPEG XR
  • icônes (ICO)
  • SVG (Scalable Vector Graphics)

Notes

Fichiers d’icônes pris en charge sur Windows uniquement. Non pris en charge sur Windows Phone 8.1

À compter de Windows 10 version 1607, l’élément Image prend en charge les images GIF (Graphics Interchange Format) animées. Lorsque vous utilisez une image BitmapImage comme source d’image, vous pouvez accéder à l’API BitmapImage pour contrôler la lecture de l’image gif (Graphics Interchange Format) animée. Pour plus d’informations, voir les remarques dans la page de la classe BitmapImage.

Notes

La prise en charge du format GIF (Animated Graphics Interchange Format) est disponible lorsque votre application est compilée pour Windows 10, version 1607 et exécutée sur la version 1607 (ou ultérieure). Lorsque votre application est compilée pour ou s’exécute sur les versions précédentes, la première image du format GIF (Graphics Interchange Format) s’affiche, mais elle n’est pas animée.

À compter de Windows 10 version 1703, l’élément Image prend en charge les images SVG (Scalable Vector Graphics) statiques via SvgImageSource. SvgImageSource prend en charge le mode statique sécurisé à partir de la spécification SVG et ne prend pas en charge les animations ou les interactions. Direct2D fournit la prise en charge du rendu SVG sous-jacent. Pour plus d’informations sur la prise en charge d’attributs et d’éléments SVG spécifiques, consultez Prise en charge de SVG. Pour en savoir plus sur l’insertion d’un SVG dans votre application, consultez la page de classe SvgImageSource .

Notes

La prise en charge svg (Scalable Vector Graphics) est disponible lorsque votre application est compilée pour Windows 10, version 1703 et exécutée sur la version 1703 (ou ultérieure). Lorsque votre application est compilée pour ou s’exécute sur les versions précédentes, l’image SVG ne s’affiche pas.

Définition d’Image.Source

Pour définir le fichier source d’image qu’une image affiche, vous définissez sa propriété Source , soit en XAML, soit dans le code. Voici un exemple simple de définition de source en XAML :

<Image Width="200" Source="Images/myimage.png"/>

Cette utilisation définit source par URI (Uniform Resource Identifier), qui est un raccourci activé par XAML. Notez que l’URI (Uniform Resource Identifier) semble être un URI relatif ; La prise en charge partielle de l’URI (Uniform Resource Identifier) est un autre raccourci XAML. La racine de cet URI (Uniform Resource Identifier) est le dossier de base d’un projet d’application. Il s’agit généralement du même emplacement que celui à partir duquel le fichier XAML contenant la balise Image est chargé. Dans cet exemple, le fichier source d’image se trouve dans un sous-dossier Images de la structure de fichiers de l’application.

La définition de la propriété Source est par nature une action asynchrone. Étant donné qu’il s’agit d’une propriété, il n’existe pas de syntaxe attendable, mais pour la plupart des scénarios, vous n’avez pas besoin d’interagir avec les aspects asynchrones du chargement d’images. L’infrastructure attend que la source de l’image soit retournée et démarre un cycle de disposition lorsque le fichier source de l’image est disponible et décodé.

Le fait de définir la source sur une valeur URI (Uniform Resource Identifier) qui ne peut pas être résolue en un fichier source d’image valide ne lève pas d’exception. Au lieu de cela, il déclenche un événement ImageFailed . Vous pouvez écrire un gestionnaire ImageFailed et l’attacher à l’objet Image, et éventuellement utiliser ErrorMessage dans les données d’événement pour déterminer la nature de l’échec. Une erreur de décodage peut également déclencher ImageFailed. Si vous souhaitez vérifier qu’un fichier source d’image a été chargé correctement, vous pouvez gérer l’événement ImageOpened sur l’élément Image.

Vous utilisez généralement des fichiers sources d’image que vous avez inclus dans le cadre de votre package de téléchargement d’application. Pour les fichiers volumineux, il peut y avoir un très petit délai pendant le décodage du fichier source d’image, s’il s’agit de la première fois que la source est utilisée. Pour plus d’informations sur les ressources d’application et sur la façon d’empaqueter des fichiers sources d’image dans un package d’application, consultez Définition des ressources d’application.

Vous pouvez également utiliser des fichiers sources d’image qui ne font pas partie de l’application, par exemple des images provenant de serveurs externes. Ces images sont téléchargées par une requête HTTP interne, puis décodées. Si le fichier source d’image est un fichier volumineux, ou s’il existe des problèmes de connexion, il peut y avoir un délai avant qu’une image externe puisse être affichée dans un élément Image.

Définition de Image.Source à l’aide de code

Si vous créez un objet Image à l’aide de code, appelez le constructeur par défaut, puis définissez la propriété Image.Source . La définition de la propriété Image.Source nécessite une instance de la classe BitmapImage, que vous devez également construire. Si la source de votre image est un fichier référencé par l’URI (Uniform Resource Identifier), utilisez le constructeur BitmapImage qui prend un paramètre URI (Uniform Resource Identifier). Lorsque vous référencez du contenu local, vous devez inclure le schéma ms-appx: dans l’URI (Uniform Resource Identifier) absolu que vous utilisez comme paramètre de constructeur BitmapImage . Dans le code, vous n’obtenez pas les raccourcis de traitement permettant de combiner des parties URI (Uniform Resource Identifier) relatives et le schéma ms-appx: qui se produit automatiquement si vous spécifiez Source comme attribut XAML. Au lieu de cela, vous devez construire explicitement un URI (Uniform Resource Identifier) absolu avec le schéma approprié. Vous utilisez généralement le schéma ms-appx: pour un fichier image empaqueté dans le cadre de votre application.

Conseil

Si vous utilisez C# ou Microsoft Visual Basic, vous pouvez obtenir la propriété BaseUri de l’image et la transmettre en tant que paramètre baseUri pour les constructeurs System.Uri qui combinent un emplacement de base URI (Uniform Resource Identifier) et un chemin relatif à cet emplacement.

Voici un exemple de définition de Image.Source en C#. Dans cet exemple, l’objet Image a été créé en XAML, mais n’a pas de source ou d’autres valeurs de propriété ; au lieu de cela, ces valeurs sont fournies au moment de l’exécution lorsque l’image est chargée à partir de XAML.

void Image_Loaded(object sender, RoutedEventArgs e)
{
    Image img = sender as Image; 
    BitmapImage bitmapImage = new BitmapImage();
    img.Width = bitmapImage.DecodePixelWidth = 80; //natural px width of image source
    // don't need to set Height, system maintains aspect ratio, and calculates the other
    // dimension, so long as one dimension measurement is provided
    bitmapImage.UriSource = new Uri(img.BaseUri,"Assets/StoreLogo.png");
    img.Source = bitmapImage;
}

Utilisation d’une source de flux pour une source d’image

Si la source de votre image est un flux, vous devez écrire du code qui définit votre instance d’image pour utiliser le flux. Cette opération ne peut pas être effectuée en XAML seul. Construisez l’image à utiliser ou référencez une instance d’image existante (qui a peut-être été définie dans le balisage XAML, mais sans source). Utilisez ensuite la méthode setSourceAsync asynchrone de BitmapImage pour définir les informations d’image à partir d’un flux, en passant le flux à utiliser comme paramètre streamSource . L’utilisation d’un flux pour une source d’image est assez courante. Par exemple, si votre application permet à un utilisateur de choisir un fichier image à l’aide d’un contrôle FileOpenPicker , l’objet que vous obtenez qui représente le fichier choisi par l’utilisateur peut être ouvert en tant que flux, mais ne fournit pas de référence URI (Uniform Resource Identifier) au fichier.

Dans cet exemple, le code est déjà attendu, car il attend que l’utilisateur choisisse un fichier et ne s’exécute qu’après cela. Le flux à utiliser provient de StorageFile.OpenAsync après qu’un instance StorageFile est retourné à partir des actions du sélecteur asynchrone.

FileOpenPicker open = new FileOpenPicker(); 
// Open a stream for the selected file 
StorageFile file = await open.PickSingleFileAsync(); 
// Ensure a file was selected 
if (file != null) 
{ 
    using (IRandomAccessStream fileStream = await file.OpenAsync(Windows.Storage.FileAccessMode.Read)) 
    { 
        // Set the image source to the selected bitmap 
         BitmapImage bitmapImage = new BitmapImage(); 
         bitmapImage.DecodePixelWidth = 600; //match the target Image.Width, not shown
         await bitmapImage.SetSourceAsync(fileStream); 
         Scenario2Image.Source = bitmapImage; 
    } 
}

Conseil

Si vous utilisez C# ou Microsoft Visual Basic, les flux peuvent utiliser le type System.IO.Stream que vous connaissez peut-être à partir de l’expérience de programmation Microsoft .NET précédente. Vous pouvez appeler la méthode d’extension AsStream en tant que méthode instance sur n’importe quel objet de type IRandomAccessStream que vous avez obtenu à partir d’une API Windows Runtime. L’exemple précédent utilisait IRandomAccessStream pour le passage de paramètres et n’avait pas besoin d’utiliser AsStream. Mais si vous avez besoin de manipuler le flux, AsStream est là en tant qu’utilitaire à convertir en system.IO.Stream si vous en avez besoin.

Pour plus d’exemples de code, consultez Exemple d’images XAML .

Fichiers image et performances

Les fichiers image volumineux peuvent avoir un impact sur les performances, car ils se chargent en mémoire. Si vous référencez un fichier image dans lequel vous savez que le fichier source est une image grande et haute résolution, mais que votre application l’affiche dans une région d’interface utilisateur inférieure à la taille naturelle de l’image, vous devez définir la propriété DecodePixelWidth ou DecodePixelHeight. Les propriétés DecodePixel* vous permettent de transmettre des informations directement au codec spécifique au format, et le codec peut utiliser ces informations pour décoder plus efficacement et réduire l’encombrement mémoire. Définissez DecodePixelWidth sur la même largeur de pixels que la zone que vous souhaitez que votre application affiche réellement. En d’autres termes, DecodePixelWidth pour la source BitmapImage doit avoir la même valeur que la Largeur ou ActualWidth du contrôle Image qui affiche cette source.

Vous pouvez définir DecodePixelWidth ou DecodePixelHeight. Si vous définissez l’une de ces deux propriétés, le système calcule la propriété correspondante pour conserver les proportions correctes. Vous pouvez également définir les deux propriétés, mais vous devez généralement utiliser des valeurs qui conservent ces proportions. Si vous souhaitez modifier les proportions, il existe de meilleures façons de le faire, par exemple en utilisant un TranslateTransform en tant que RenderTransform.

Pour définir DecodePixelWidth (ou DecodePixelHeight) en XAML, vous devez utiliser une syntaxe XAML légèrement plus détaillée qui inclut un élément BitmapImage explicite en tant que valeur d’élément de propriété, comme suit :

<Image>
  <Image.Source>
    <BitmapImage DecodePixelWidth="200" UriSource="images/myimage.png"/>
  </Image.Source>
</Image>

DecodePixelWidth (ou DecodePixelHeight) étant des propriétés de BitmapImage, vous avez besoin d’un élément objet XAML BitmapImage explicite pour définir les propriétés DecodePixel* en tant qu’attributs en XAML.

Si vous créez une image instance dans le code, vous créez probablement déjà un instance BitmapImage en tant que valeur à fournir pour la propriété Source. Il vous suffit donc de définir DecodePixelWidth (ou DecodePixelHeight) sur le instance BitmapImage avant de définir la propriété UriSource. La propriété DecodePixelType affecte également la façon dont les valeurs de pixel sont interprétées par les opérations de décodage.

Pour empêcher le décodage d’images plusieurs fois, affectez la propriété source de l’image à partir de l’URI (Uniform Resource Identifier) au lieu d’utiliser des flux mémoire chaque fois que vous le pouvez. L’infrastructure XAML peut associer le même URI (Uniform Resource Identifier) à plusieurs emplacements à une image décodée, mais elle ne peut pas faire de même pour plusieurs flux de mémoire même s’ils contiennent les mêmes données.

Vous pouvez supprimer des fichiers image du cache d’images en définissant toutes les valeurs Image.Source associées sur Null.

Pour plus d’informations sur la classe Image et les performances, consultez Optimiser les animations et les médias.

Encodage et décodage de fichier image

La prise en charge des codecs sous-jacents pour les fichiers image est fournie par l’API WIC (Windows Imaging Component). Pour plus d’informations sur des formats d’image spécifiques, tels que documentés pour les codecs, consultez Codecs WIC natifs.

L’API pour Image, BitmapImage et BitmapSource n’inclut aucune méthode dédiée pour l’encodage et le décodage des formats multimédias. Toutes les opérations de décodage sont intégrées en tant qu’actions qui se produisent lorsque la source est définie ou réinitialisée. Cela facilite l’utilisation des classes pour la construction de l’interface utilisateur, car elles ont un ensemble par défaut de formats de fichiers sources et de comportement de décodage pris en charge. Les classes telles que BitmapImage exposent certaines des options de décodage et de la logique dans le cadre des données d’événement pour les événements ImageOpened ou ImageFailed . Si vous avez besoin d’un décodage avancé du fichier image ou d’un encodage d’image, vous devez utiliser l’API de l’espace de noms Windows.Graphics.Imaging . Vous pouvez avoir besoin de ces API si votre scénario d’application implique des conversions de format de fichier image ou une manipulation d’une image dans laquelle l’utilisateur peut enregistrer le résultat sous forme de fichier. L’API d’encodage est également prise en charge par le composant WiC (Windows Imaging Component) de Windows.

Largeur et hauteur de l’image

La classe Image hérite des propriétés Width et Height de FrameworkElement, et ces propriétés contrôlent potentiellement la taille que votre contrôle Image affiche lorsqu’il s’affiche dans l’interface utilisateur. Si vous ne définissez pas une largeur ou une hauteur, la largeur et la hauteur sont déterminées par la taille naturelle de la source d’image. Par exemple, si vous chargez une image bitmap de 300 pixels de haut et de 400 pixels de large, comme enregistré dans son format de fichier source, ces mesures sont utilisées pour la largeur et la hauteur lorsque le contrôle Image calcule sa taille naturelle. Vous pouvez case activée ActualHeight et ActualWidth au moment de l’exécution après le rendu de l’image pour obtenir les informations de mesure. Vous pouvez également gérer ImageOpened et case activée propriétés de fichier image telles que PixelHeight et PixelWidth immédiatement avant le rendu de l’image.

Si vous définissez une seule des propriétés Width ou Height , mais pas les deux, le système peut utiliser cette dimension comme guide et calculer l’autre, en conservant les proportions. Si vous n’êtes pas sûr des dimensions du fichier source, choisissez la dimension la plus importante à contrôler dans votre scénario de disposition et laissez le système calculer l’autre dimension, puis le comportement de disposition du conteneur adaptera généralement la disposition pour qu’elle s’adapte.

Si vous ne définissez pas Width et/ou Height et que vous laissez l’image comme taille naturelle, la propriété Stretch de l’image peut contrôler la façon dont le fichier source de l’image remplira l’espace que vous spécifiez comme Width et Height. La valeur Stretch par défaut est Uniform, qui conserve les proportions lorsqu’elle correspond à l’image dans un conteneur de disposition. Si les dimensions du conteneur n’ont pas les mêmes proportions, il y aura un espace vide qui fait toujours partie de l’image, mais qui n’affiche pas de pixels d’image, du moins lors de l’utilisation de la valeur Uniform pour Stretch. UniformToFill pour Stretch ne laisse pas d’espace vide, mais peut couper l’image si les dimensions sont différentes. Le remplissage pour Stretch ne laisse pas d’espace vide, mais peut modifier les proportions. Vous pouvez tester ces valeurs pour voir ce qui est le mieux adapté à l’affichage d’images dans votre scénario de disposition. En outre, n’oubliez pas que certains conteneurs de disposition peuvent dimensionner une image qui n’a pas de largeur et de hauteur spécifiques pour remplir l’espace de disposition entier. Dans ce cas, vous pouvez choisir de définir des tailles spécifiques sur l’image ou le conteneur correspondant.

NineGrid

L’utilisation de la technique NineGrid est une autre option pour dimensionner des images dont la taille naturelle est différente de celle de votre zone d’affichage, si l’image comporte des régions qui ne doivent pas être mises à l’échelle uniformément. Par exemple, vous pouvez utiliser une image d’arrière-plan qui a une bordure inhérente qui ne doit s’étendre que dans une dimension et des coins qui ne doivent pas s’étirer du tout, mais le centre de l’image peut s’étirer pour répondre aux exigences de disposition dans les deux dimensions. Pour plus d’informations, consultez NineGrid.

Qualification et localisation des ressources pour Image

Fichiers sources d’image et mise à l’échelle

Vous devez créer vos sources d’images à plusieurs tailles recommandées pour vous assurer que votre application est très belle lorsque Windows 8 la met à l’échelle. Lorsque vous spécifiez une source pour une image, vous pouvez utiliser une convention d’affectation de noms pour les ressources qui utilisent la ressource appropriée pour les facteurs de mise à l’échelle spécifiques à l’appareil. Cela est déterminé automatiquement par l’application au moment de l’exécution. Pour plus d’informations sur les conventions d’affectation de noms à utiliser et plus d’informations, consultez Démarrage rapide : Utilisation de ressources de fichiers ou d’images.

Pour plus d’informations sur la façon de concevoir correctement les images pour la mise à l’échelle, consultez Instructions relatives à l’expérience utilisateur pour la disposition et la mise à l’échelle.

Utilisation de ressources non qualifiées

Les ressources non qualifiées sont une technique que vous pouvez utiliser où la référence de ressource de base fait référence à une ressource par défaut, et où le processus de gestion des ressources peut trouver automatiquement la ressource localisée équivalente. Vous pouvez utiliser la gestion automatique pour accéder aux ressources non qualifiées avec des qualificateurs de culture et d’échelle actuels, ou vous pouvez utiliser ResourceManager et ResourceMap avec des qualificateurs pour la culture et la mise à l’échelle pour obtenir les ressources directement. Pour plus d’informations, voir Système de gestion des ressources.

FlowDirection pour Image

Si vous définissez FlowDirection sur RightToLeft pour une image, le contenu visuel d’une image est retourné horizontalement. Toutefois, un élément Image n’hérite pas de la valeur FlowDirection d’un élément parent. En règle générale, vous souhaitez uniquement que le comportement de retournement d’image dans les images qui sont pertinentes pour la disposition, mais pas nécessairement pour les éléments qui ont du texte incorporé ou d’autres composants qui n’auraient pas de sens inversé pour un public de droite à gauche. Pour obtenir le comportement de retournement d’image, vous devez définir l’élément FlowDirection sur l’élément Image spécifiquement sur RightToLeft, ou définir la propriété FlowDirection dans code-behind. Envisagez d’identifier l’élément Image par la directive x:Uid et de spécifier des valeurs FlowDirection en tant que ressource Windows Runtime, afin que vos experts en localisation puissent modifier cette valeur ultérieurement sans modifier le code XAML ou le code.

La classe Image et l’accessibilité

La classe Image n’est pas une classe de contrôle true, car elle n’est pas une classe descendante de Control. Vous ne pouvez pas appeler le focus sur un élément Image ou placer un élément Image dans une séquence d’onglets. Pour plus d’informations sur les aspects d’accessibilité de l’utilisation d’images et sur l’élément Image dans votre interface utilisateur, consultez Informations d’accessibilité de base.

Comportement de Windows 8

Pour Windows 8, les ressources peuvent utiliser un modèle de qualificateur de ressources pour charger différentes ressources en fonction de la mise à l’échelle de l’appareil. Toutefois, les ressources ne sont pas rechargées automatiquement si le facteur de mise à l’échelle change pendant l’exécution de l’application. Dans ce cas, les applications doivent s’occuper du rechargement des ressources, en gérant l’événement DpiChanged (ou l’événement LogicalDpiChanged déconseillé) et en utilisant l’API ResourceManager pour recharger manuellement la ressource appropriée pour le nouveau facteur de mise à l’échelle. À compter de Windows 8.1, toute ressource qui a été récupérée à l’origine pour votre application est automatiquement réévaluée si le facteur de mise à l’échelle change pendant l’exécution de l’application. En outre, lorsque cette ressource est la source d’image d’un objet Image, l’un des événements de chargement source (ImageOpened ou ImageFailed) est déclenché à la suite de l’action du système qui consiste à demander la nouvelle ressource, puis à l’appliquer à l’Image. Le scénario où une modification de l’échelle au moment de l’exécution peut se produire si l’utilisateur déplace votre application vers un autre moniteur lorsque plusieurs sont disponibles.

Si vous migrez le code de votre application de Windows 8 vers Windows 8.1 vous pouvez tenir compte de ce changement de comportement, car cela entraîne des événements ImageOpened ou ImageFailed qui se produisent au moment de l’exécution lorsque le changement d’échelle est géré, même dans les cas où la source est définie en XAML. En outre, si vous avez du code qui gérait DpiChanged/LogicalDpiChanged et réinitialise les ressources, vous devez déterminer si ce code est toujours nécessaire compte tenu du nouveau comportement de rechargement automatique Windows 8.1.

Les applications qui ont été compilées pour Windows 8, mais qui sont exécutées dans Windows 8.1, continuent d’appliquer le comportement Windows 8.

Historique des versions

Version de Windows Version du SDK Valeur ajoutée
1607 14393 GetAlphaMask

Constructeurs

Image()

Initialise une nouvelle instance de la classe Image.

Propriétés

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 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 ÉLÉMENT 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 que cet ÉLÉMENT UIElement a calculée 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)
BaseUri

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

(Hérité de FrameworkElement)
CacheMode

Obtient ou définit une valeur qui indique que le contenu rendu doit être mis en cache sous la forme d’une bitmap composite dans la mesure du possible.

(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 par 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 élément 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 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 FrameworkElement utilise l’extension de balisage {Binding} et participe à la liaison de données.

(Hérité de FrameworkElement)
DesiredSize

Obtient la taille que cet UIElement a calculée pendant la passe de mesure du processus de disposition.

(Hérité de UIElement)
Dispatcher

Obtient le CoreDispatcher auquel cet objet est associé. CoreDispatcher représente une fonctionnalité qui peut accéder à DependencyObject sur le thread d’interface utilisateur, même si le code est initié par un thread autre que l’interface utilisateur.

(Hérité de DependencyObject)
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. Le fait de définir FlowDirection sur RightToLeft sur n’importe quel élément définit l’alignement à droite, l’ordre de lecture de droite à gauche et la disposition du contrôle à passer de droite à gauche.

(Hérité de FrameworkElement)
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 contenue de cet élément UIElement peut retourner des valeurs vraies pour le test 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.

(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)
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 raccourci 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 raccourcis clavier pour différents éléments de menu
Exemple de menu montrant les raccourcis 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’info-bulle 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 la touche 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.

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

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

Obtient ou définit une valeur pour une métaphore à neuf grilles qui contrôle la façon dont l’image peut être redimensionnée. La métaphore à neuf grilles vous permet d’étirer les bords et les coins d’une image différemment de son centre. Pour plus d’informations et une illustration, consultez Notes.

NineGridProperty

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

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

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

(Hérité de FrameworkElement)
PlayToSource

Obtient les informations transmises si l’image est utilisée pour un scénario de lecture.

PlayToSourceProperty

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

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)
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 thème 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)
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)
Source

Obtient ou définit la source de l’image.

SourceProperty

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

Stretch

Obtient ou définit une valeur qui décrit comment une image doit être étirée pour remplir le rectangle de destination.

StretchProperty

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

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

Obtient l’identificateur de contexte pour l’élément .

(Hérité de UIElement)
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)
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 panneau ou un contrôle d’éléments.

(Hérité de FrameworkElement)
Visibility

Obtient ou définit la visibilité d’un élément UIElement. Un élément 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)
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)
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)
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)
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 sur true pour que le gestionnaire fourni soit appelé même si l’événement est géré ailleurs.

(Hérité de UIElement)
Arrange(Rect)

Positionne les objets enfants et détermine la taille d’un élément UIElement. Les objets parents qui implémentent une disposition personnalisée pour leurs éléments enfants doivent appeler cette méthode à partir de leurs implémentations de remplacement de disposition pour former une mise à jour de disposition récursive.

(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 élément UIElement. Une fois capturé, seul l’élément qui a la capture déclenche les é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)
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)
GetAlphaMask()

Renvoie un masque qui représente le canal alpha d’une image en tant que CompositionBrush.

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

Retourne l’image en tant que CastingSource.

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 prennent part 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)
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 élément UIElement. Après l’invalidation, la disposition de l’élément UIElement est mise à jour, ce qui se produit de manière asynchrone.

(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 desiredSize d’un ÉLÉMENT UIElement. En règle générale, les objets qui implémentent une disposition personnalisée pour leurs enfants de disposition appellent cette méthode à partir de leurs propres implémentations MeasureOverride pour former une mise à jour de disposition récursive.

(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 que l’événement BringIntoViewRequested ne se produise.

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

Démarre une opération de glisser-déplacer.

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

Se produit lorsqu’un mouvement d’entrée de contexte se poursuit en un mouvement de manipulation, pour avertir l’élément que le menu volant de contexte ne doit pas être ouvert.

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

(Hérité de FrameworkElement)
DoubleTapped

Se produit lorsqu’une interaction DoubleTap non gérée se produit 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 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 glissement 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 bulle.

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

(Hérité de UIElement)
Holding

Se produit lorsqu’une interaction de conservation non gérée se produit au-dessus de la zone de test d’accès de cet élément.

(Hérité de UIElement)
ImageFailed

Se produit lorsqu’une erreur est associée à la récupération ou au format de l’image.

ImageOpened

Se produit lorsque la source de l’image est téléchargée et décodée sans échec. Vous pouvez utiliser cet événement pour déterminer la taille naturelle de la source d’image.

KeyDown

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

(Hérité de UIElement)
KeyUp

Se produit lorsqu’une touche clavier est relâché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 perde le focus. Cet événement est déclenché de manière synchrone pour garantir que le focus n’est pas déplacé pendant que l’événement est en cours de bulle.

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

(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 tabulations ou des flèches directionnelles), mais que le focus ne se déplace pas, car aucun candidat au focus n’est trouvé dans la direction du mouvement.

(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 événement PointerReleased ; 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 à

Voir aussi