Image Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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, "Microsoft.UI.Xaml.WinUIContract")]
/// [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 Image final : FrameworkElement[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[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 sealed class Image : FrameworkElementPublic NotInheritable Class Image
Inherits FrameworkElement<Image .../>
- Héritage
- Attributs
Exemples
Conseil
Pour plus d’informations, des conseils de conception et des exemples de code, consultez Images et pinceaux d’images.
L’application WinUI 3 Gallery comprend des exemples interactifs de la plupart des contrôles et des fonctionnalités WinUI 3. 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)
À 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 avec 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 bien 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 de nommage à 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 d’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 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 d’échelle et de culture actuels, ou vous pouvez utiliser ResourceManager et ResourceMap avec des qualificateurs pour la culture et la mise à l’échelle pour obtenir directement les ressources. 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.
Ressources d’image
Les ressources peuvent utiliser un modèle de qualificateur de ressources pour charger différentes ressources en fonction de la mise à l’échelle propre à l’appareil. 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. Par conséquent, les événements ImageOpened ou ImageFailed peuvent se produire 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.
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 l’élément 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 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) |
| 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 quand un |
| DesiredSize |
Obtient la taille que cet UIElement a calculée pendant la passe de mesure du processus de disposition. (Hérité de UIElement) |
| Dispatcher |
Retourne |
| DispatcherQueue |
Obtient le |
| ExitDisplayModeOnAccessKeyInvoked |
Obtient ou définit une valeur qui spécifie si l’affichage de la clé d’accès est ignoré lorsqu’une clé d’accès est appelée. (Hérité de UIElement) |
| FlowDirection |
Obtient ou définit la direction dans laquelle le texte et d’autres éléments d’interface utilisateur circulent dans n’importe quel élément parent qui contrôle leur disposition. Cette propriété peut être définie sur |
| 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 |
| FocusVisualPrimaryThickness |
Obtient ou définit l’épaisseur de la bordure externe d’un |
| FocusVisualSecondaryBrush |
Obtient ou définit le pinceau utilisé pour dessiner la bordure interne d’un |
| FocusVisualSecondaryThickness |
Obtient ou définit l’épaisseur de la bordure interne d’un |
| 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 horizontal qui sont appliquées à un FrameworkElement lorsqu’il est composé dans un parent de disposition, tel qu’un contrôle de panneau ou d’éléments. (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) |
| 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 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.
|
| 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 de l’élément 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 Remarques. |
| 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) |
| 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 de l’interface utilisateur avec |
| Resources |
Obtient le dictionnaire de ressources défini localement. En XAML, vous pouvez établir des éléments de ressources en tant qu’éléments d’objet enfants d’un |
| 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) |
| 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 |
| Width |
Obtient ou définit la largeur d’un FrameworkElement. (Hérité de FrameworkElement) |
| XamlRoot |
Obtient ou définit le |
| 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 |
| 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 « Organiser » de la disposition. Les classes peuvent remplacer cette méthode pour définir leur propre comportement de passage « 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) |
| Focus(FocusState) |
Essaie d'affecter le focus sur cet élément. (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’applique dans les cas où une animation n’est pas active. (Hérité de DependencyObject) |
| GetAsCastingSource() |
Retourne l’image en tant que CastingSource. |
| GetBindingExpression(DependencyProperty) |
Retourne la 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 objet DependencyObject. (Hérité de DependencyObject) |
| GetVisualInternal() |
Récupère le |
| GoToElementStateCore(String, Boolean) |
En cas d’implémentation dans une classe dérivée, active la construction par état d’une arborescence visuelle pour un modèle de contrôle dans le code, 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 passage « Measure ». (Hérité de FrameworkElement) |
| OnApplyTemplate() |
Appelé chaque fois que le code d’application ou les processus internes (par exemple, une passe de disposition de reconstruction) appellent ApplyTemplate. En termes simples, cela signifie que la méthode est appelée juste avant qu’un élément d’interface utilisateur ne s’affiche dans votre application. Remplacez cette méthode pour influencer la logique post-modèle par défaut d’une classe. (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(ExpPointerPoint) |
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. (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. |
| 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 d’image. |
| ImageOpened |
Se produit lorsque la source d’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 frameworkElement commence à 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 |
| 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
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour