TextBox Classe

Définition

Représente un contrôle qui peut être utilisé pour afficher et modifier du texte brut (simple ou multiligne).

/// [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 TextBox : Control
[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 class TextBox : Control
Public Class TextBox
Inherits Control
<TextBox .../>
Héritage
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 Zone de texte.

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.

Cet exemple montre une zone de texte avec un en-tête et un texte d’espace réservé. Le texte de la Zone de texte est utilisé pour afficher un message d’accueil à l’utilisateur.

<StackPanel>
    <TextBlock Text="What's your name?"/>
        <StackPanel Orientation="Horizontal" Margin="0,20,0,20">

            <TextBox x:Name="nameInput"
                     Header="Enter your name:" PlaceholderText="Name"
                     Width="300" HorizontalAlignment="Left"/>

            <Button Content="Hello button" Click="Button_Click"/>
        </StackPanel>
    <TextBlock x:Name="greetingOutput"/>
</StackPanel>
private void Button_Click(object sender, RoutedEventArgs e)
{
    greetingOutput.Text = "Hello, " + nameInput.Text + "!";
}

Remarques

Conseil

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

Contrôle de zone de texte

Le contrôle TextBox permet à un utilisateur d’entrer du texte dans une application. Il est généralement utilisé pour capturer une seule ligne de texte, mais peut être configuré pour la saisie de plusieurs lignes. Le texte s’affiche à l’écran dans un format en texte clair uniforme simple.

TextBox dispose d’un certain nombre de fonctionnalités qui peuvent simplifier la saisie de texte :

  • Il prend en charge l’entrée de texte à partir d’un clavier ou d’un stylet (à l’aide de l’entrée manuscrite et de la reconnaissance d’écriture manuscrite).
  • Il intègre un menu contextuel familier prenant en charge la copie et le collage de texte.
  • Un bouton « Effacer tout » permet à un utilisateur de supprimer rapidement tout le texte entré.
  • Le contrôle intègre également des fonctionnalités de vérification de l’orthographe qui sont activées par défaut.

Voici comment créer une zone de texte en XAML et en code.

<TextBox Width="500" Header="Notes" PlaceholderText="Type your notes here"/>
TextBox textBox = new TextBox();
textBox.Width = 500;
textBox.Header = "Notes";
textBox.PlaceholderText = "Type your notes here";
// Add the TextBox to the visual tree.
rootGrid.Children.Add(textBox);

La zone de texte résultante ressemble à ceci. La bordure bleue indique que la zone de texte a le focus.

Une zone de texte simple

TextBox est-il le bon contrôle à utiliser ?

Vous pouvez utiliser un contrôle TextBox pour afficher et modifier du texte non mis en forme. Si vous avez besoin d’une zone de texte modifiable qui accepte les mots de passe ou d’autres entrées sensibles, consultez PasswordBox. Si vous avez besoin d’une zone de texte pour entrer des termes de recherche, consultez AutoSuggestBox. Si vous avez besoin d’entrer ou de modifier du texte mis en forme, consultez RichEditBox.

Utiliser TextBox pour l’entrée de données dans un formulaire

Il est courant d’utiliser une zone de texte pour accepter l’entrée de données dans un formulaire et d’utiliser la propriété Text pour obtenir la chaîne de texte complète à partir de la zone de texte. Vous utilisez généralement un événement tel qu’un bouton Envoyer Cliquez pour accéder à la propriété Text , mais vous pouvez gérer l’événement TextChanged ou TextChanging si vous devez faire quelque chose lorsque le texte change. Vous pouvez ajouter un en-tête (ou une étiquette) et Un espace réservé ( ou un filigrane) à la zone de texte pour donner à l’utilisateur une indication de ce à quoi sert la zone de texte. Pour personnaliser l’apparence de l’en-tête, vous pouvez définir la propriété HeaderTemplate au lieu d’En-tête. Pour plus d’informations sur la conception, consultez Recommandations pour les étiquettes.

Vous pouvez restreindre le nombre de caractères que l’utilisateur peut taper en définissant la propriété MaxLength. Toutefois, MaxLength ne limite pas la longueur du texte collé. Si cet aspect a de l’importance pour votre application, utilisez l’événement Paste pour modifier le texte collé.

TextBox inclut un bouton effacer tout (x) qui s’affiche lorsque du texte est entré dans la zone. Lorsqu’un utilisateur clique sur « x », le texte de la zone de texte est effacé. Cette dernière se présente comme suit.

Une zone de texte avec un bouton Effacer tout

Le bouton Effacer tout s’affiche uniquement pour les zones de texte d’une seule ligne modifiables qui contiennent du texte et qui ont le focus. Le bouton Effacer tout ne s’affiche dans aucun des cas suivants :

Rendre une zone de texte en lecture seule

Vous pouvez rendre une zone de texte en lecture seule en définissant la propriété IsReadOnly sur true. Par exemple, vous pouvez avoir besoin de définir un contrôle TextBox permettant à un utilisateur d’entrer des commentaires seulement sous certaines conditions. Vous pouvez configurer le contrôle TextBox comme étant en lecture seule jusqu’à ce que ces conditions soient remplies. Si vous avez uniquement besoin d’afficher du texte, envisagez d’utiliser un TextBlock ou un RichTextBlock à la place.

Activer la saisie multiligne

Il existe deux propriétés qui contrôlent si la zone de texte affiche du texte sur plusieurs lignes.

  • Pour que la zone de texte autorise et affiche les caractères de saut de ligne ou de retour chariot, définissez la propriété AcceptsReturn sur true.
  • Pour activer la fonctionnalité de renvoi de texte à la ligne, définissez la propriété TextWrapping sur Wrap. (TextBox ne prend pas en charge la valeur d’énumération TextWrapping.WrapWholeWords .) Une zone de texte multiligne continue de croître verticalement à mesure que le texte est entré, sauf s’il est limité par sa propriété Height ou MaxHeight , ou par un conteneur parent. Vous devez vérifier qu’une zone de texte multiligne ne se développe pas au-delà de sa zone visible et qu’elle limite sa croissance si c’est le cas. Le défilement à l’aide d’une roulette de défilement ou d’une interaction tactile est automatiquement activé s’il y a lieu. Toutefois, les barres de défilement verticales ne sont pas affichées par défaut. Vous pouvez afficher les barres de défilement verticales en définissant ScrollViewer.VerticalScrollBarVisibility sur Auto sur le ScrollViewer incorporé, comme illustré ici.
<TextBox AcceptsReturn="True" TextWrapping="Wrap" 
         MaxHeight="172" Width="300" Header="Description"
         ScrollViewer.VerticalScrollBarVisibility="Auto"/>
TextBox textBox = new TextBox();
textBox.AcceptsReturn = true;
textBox.TextWrapping = TextWrapping.Wrap;
textBox.MaxHeight = 172;
textBox.Width = 300;
textBox.Header = "Description";
ScrollViewer.SetVerticalScrollBarVisibility(textBox, ScrollBarVisibility.Auto);

Voici à quoi ressemble la Zone de texte après l’ajout du texte.

Zone de texte d’une ligne mullti

Mettre en forme l’affichage du texte

Utilisez la propriété TextAlignment pour aligner le texte dans une zone de texte. Pour aligner la zone de texte dans la mise en page de la page, utilisez les propriétés HorizontalAlignment et VerticalAlignment .

Bien que textBox ne prenne en charge que le texte non mis en forme, vous pouvez personnaliser la façon dont le texte est affiché dans textBox pour qu’il corresponde à votre personnalisation. Vous pouvez définir les propriétés Control standard, comme FontFamily, FontSize, FontStyle, Background, Foreground et CharacterSpacing pour modifier l’apparence du texte. Ces propriétés affectent uniquement la façon dont la Zone de texte affiche le texte localement. Par conséquent, si vous deviez copier et coller le texte dans un contrôle de texte enrichi, par exemple, aucune mise en forme n’est appliquée.

Cet exemple montre une zone de texte en lecture seule avec plusieurs propriétés définies pour personnaliser l’apparence du texte.

<TextBox Text="Sample Text" IsReadOnly="True" 
         FontFamily="Verdana" FontSize="24"
         FontWeight="Bold" FontStyle="Italic" 
         CharacterSpacing="200" Width="300"
         Foreground="Blue" Background="Beige"/>
TextBox textBox = new TextBox();
textBox.Text = "Sample Text";
textBox.IsReadOnly = true;
textBox.FontFamily = new FontFamily("Verdana");
textBox.FontSize = 24;
textBox.FontWeight = Windows.UI.Text.FontWeights.Bold;
textBox.FontStyle = Windows.UI.Text.FontStyle.Italic;
textBox.CharacterSpacing = 200;
textBox.Width = 300;
textBox.Background = new SolidColorBrush(Windows.UI.Colors.Beige);
textBox.Foreground = new SolidColorBrush(Windows.UI.Colors.Blue);
// Add the TextBox to the visual tree.
rootGrid.Children.Add(textBox);

La zone de texte résultante ressemble à ceci.

Une zone de texte simple

Entrée du stylo

À partir de Windows 10, version 1803, les zones de saisie de texte XAML ont une prise en charge intégrée de la saisie effectuée à l’aide du stylet avec Windows Ink. Quand un utilisateur appuie sur une zone de texte avec un stylet Windows, la zone de texte se transforme pour permettre à l’utilisateur d’écrire dedans directement avec un stylet, au lieu d’ouvrir un panneau de saisie distinct.

Zone de texte avec entrée manuscrite et suggestions

Pour plus d’informations, consultez Entrée de texte avec la vue d’écriture manuscrite.

Modifier le menu contextuel

Par défaut, les commandes affichées dans le menu contextuel TextBox dépendent de l’état de la Zone de texte. Par exemple, les commandes suivantes peuvent être affichées lorsque textBox est modifiable.

CommandeCondition d’affichage
CopierL’utilisateur a sélectionné du texte.
CouperL’utilisateur a sélectionné du texte.
CollerLe Presse-papiers contient du texte.
Tout sélectionnerLe contrôle TextBox contient du texte.
AnnulerL’utilisateur a modifié du texte.

Pour modifier les commandes figurant dans le menu contextuel, gérez l’événement ContextMenuOpening. Pour obtenir un exemple de ceci, consultez l’exemple Personnalisation de RichEditBox’s CommandBarFlyout - ajout de 'Share' dans la galerie WinUI 2. Pour plus d’informations sur la conception, consultez Recommandations pour les menus contextuels.

Sélection, copie et collage

Vous pouvez obtenir ou définir le texte sélectionné dans une zone de texte à l’aide de la propriété SelectedText . Utilisez les propriétés SelectionStart et SelectionLength, et les méthodes Select et SelectAll, pour manipuler la sélection de texte. Pour exécuter une action spécifique quand l’utilisateur sélectionne ou désélectionne du texte, gérez l’événement SelectionChanged. Vous pouvez modifier la couleur de mise en surbrillance du texte sélectionné en définissant la propriété SelectionHighlightColor.

Par défaut, le contrôle TextBox prend en charge les opérations de copie et de collage. Vous pouvez appliquer une gestion personnalisée de l’événement Paste aux contrôles de texte modifiables de votre application. Par exemple, vous pouvez supprimer les sauts de ligne d’une adresse multiligne quand vous collez cette dernière dans une zone de recherche d’une seule ligne. Vous pouvez également vérifier la longueur du texte collé et avertir l’utilisateur si elle dépasse la longueur maximale pouvant être enregistrée dans une base de données. Pour plus d’informations et d’exemples, consultez l’événement Paste.

Utiliser une zone de texte avec le clavier tactile

Le clavier tactile permet d’entrer du texte quand l’application est exécutée sur un appareil disposant d’un écran tactile. TextBox fournit des propriétés que vous pouvez définir pour rendre la saisie de données beaucoup plus rapide et plus facile pour les utilisateurs dans votre application à l’aide du clavier tactile. Définissez la propriété InputScope pour qu’elle corresponde au type de données que l’utilisateur est censé entrer. Par exemple, si une zone de texte est utilisée uniquement pour entrer un code confidentiel à 4 chiffres, définissez la propriété InputScope sur Number. Ceci indique au système qu’il doit afficher la disposition du pavé numérique, ce qui permet à l’utilisateur d’entrer plus facilement le code PIN.

Les autres propriétés qui affectent le clavier tactile sont IsSpellCheckEnabled, IsTextPredictionEnabled et PreventKeyboardDisplayOnProgrammaticFocus. (IsSpellCheckEnabled affecte également textBox lorsqu’un clavier matériel est utilisé.) Pour plus d’informations et d’exemples, consultez Utiliser l’étendue d’entrée pour modifier le clavier tactile et la documentation sur les propriétés.

Modèle et style de contrôle

Vous pouvez modifier le Style par défaut et ControlTemplate pour donner au contrôle une apparence unique. Pour plus d’informations sur la modification du style et du modèle d’un contrôle, consultez Contrôles de style. Le style, le modèle et les ressources par défaut qui définissent l’apparence du contrôle sont inclus dans le generic.xaml fichier. À des fins de conception, generic.xaml est disponible localement avec l’installation du Kit de développement logiciel (SDK) ou du package NuGet.

  • Styles WinUI (recommandé) : Pour connaître les styles mis à jour à partir de WinUI, consultez \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml.
  • Styles non WinUI : Pour connaître les styles intégrés, consultez %ProgramFiles(x86)%\Windows Kits\10\DesignTime\CommonConfiguration\Neutral\UAP\<SDK version>\Generic\generic.xaml.

Les emplacements peuvent être différents si vous avez personnalisé l’installation. Les styles et les ressources de différentes versions du Kit de développement logiciel (SDK) peuvent avoir des valeurs différentes.

XAML inclut également des ressources que vous pouvez utiliser pour modifier les couleurs d’un contrôle dans différents états visuels sans modifier le modèle de contrôle. La modification de ces ressources est préférable à la définition de propriétés telles que l’arrière-plan et le premier plan. Pour plus d’informations, consultez la section Style léger de l’article Styles XAML . Les ressources de style léger sont disponibles à partir de Windows 10, version 1607 (SDK 14393).

Les ressources qui commencent TextControl par sont partagées par TextBox, PasswordBox, RichEditBox et AutoSuggestBox. Les modifications apportées à ces ressources affecteront les quatre contrôles.

Historique des versions

Version de Windows Version du SDK Valeur ajoutée
1511 10586 GetLinguisticAlternativesAsync
1703 15063 SelectionHighlightColorWhenNotFocused
1709 16299 BeforeTextChanging
1709 16299 CharacterCassing
1709 16299 CopyingToClipboard
1709 16299 CuttingToClipboard
1709 16299 HorizontalTextAlignment
1709 16299 Espace réservéForeground
1803 17134 HandwritingView
1803 17134 IsHandwritingViewEnabled
1809 17763 CanPasteClipboardContent
1809 17763 CanRedo
1809 17763 CanUndo
1809 17763 ClearUndoRedoHistory
1809 17763 CopySelectionToClipboard
1809 17763 CutSelectionToClipboard
1809 17763 Description
1809 17763 PasteFromClipboard
1809 17763 Vérification des preuvesMenuFlyout
1809 17763 Rétablir
1809 17763 SelectionChanging
1809 17763 SelectionFlyout
1809 17763 Annuler

Constructeurs

TextBox()

Initialise une nouvelle instance de la classe TextBox.

Propriétés

AcceptsReturn

Obtient ou définit la valeur qui détermine si la zone de texte autorise et affiche les caractères de nouvelle ligne ou de retour.

AcceptsReturnProperty

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

AccessKey

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

(Hérité de UIElement)
AccessKeyScopeOwner

Obtient ou définit un élément source qui fournit l’étendue de la clé d’accès pour cet élément, même s’il ne se trouve pas dans l’arborescence visuelle de l’élément source.

(Hérité de UIElement)
ActualHeight

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

(Hérité de FrameworkElement)
ActualOffset

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

(Hérité de UIElement)
ActualSize

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

(Hérité de UIElement)
ActualTheme

Obtient le thème d’interface utilisateur actuellement utilisé par l’élément, qui peut être différent de 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)
Background

Obtient ou définit un pinceau qui fournit l’arrière-plan du contrôle.

(Hérité de Control)
BackgroundSizing

Obtient ou définit une valeur qui indique jusqu’où l’arrière-plan s’étend par rapport à la bordure de cet élément.

(Hérité de Control)
BaseUri

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

(Hérité de FrameworkElement)
BorderBrush

Obtient ou définit un pinceau qui décrit le remplissage de bordure d’un contrôle.

(Hérité de Control)
BorderThickness

Obtient ou définit l'épaisseur de la bordure d'un contrôle.

(Hérité de Control)
CacheMode

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

(Hérité de UIElement)
CanBeScrollAnchor

Obtient ou définit une valeur qui indique si l’élément UIElement peut être un candidat pour l’ancrage de défilement.

(Hérité de UIElement)
CanDrag

Obtient ou définit une valeur qui indique si l’élément peut être déplacé en tant que données dans une opération de glisser-déplacer.

(Hérité de UIElement)
CanPasteClipboardContent

Obtient une valeur qui indique si le contenu du Presse-papiers peut être collé dans le contrôle.

CanPasteClipboardContentProperty

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

CanRedo

Obtient une valeur qui indique si la mémoire tampon de restauration par progression contient une action qui peut être refaite.

CanRedoProperty

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

CanUndo

Obtient une valeur qui indique si la mémoire tampon d’annulation contient une action qui peut être annulée.

CanUndoProperty

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

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

Obtient ou définit une valeur qui indique comment le contrôle modifie la casse des caractères à mesure qu’ils sont tapés.

CharacterCasingProperty

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

CharacterSpacing

Obtient ou définit l’espacement uniforme entre les caractères, en unités de 1/1000 d’un em.

(Hérité de Control)
Clip

Obtient ou définit le RectangleGeometry utilisé pour définir le contour du contenu d’un UIElement.

(Hérité de UIElement)
CompositeMode

Obtient ou définit une propriété qui déclare d’autres modes de composition et de fusion pour l’élément dans sa disposition et sa fenêtre parentes. Cela s’applique aux éléments impliqués dans une interface utilisateur MIXTE XAML/Microsoft DirectX.

(Hérité de UIElement)
ContextFlyout

Obtient ou définit le menu volant associé à cet élément.

(Hérité de UIElement)
CornerRadius

Obtient ou définit le rayon des coins de la bordure du contrôle.

(Hérité de Control)
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)
DefaultStyleKey

Obtient ou définit la clé qui référence le style par défaut du contrôle. Les auteurs de contrôles personnalisés utilisent cette propriété pour modifier la valeur par défaut du style utilisé par leur contrôle.

(Hérité de Control)
DefaultStyleResourceUri

Obtient ou définit le chemin d’accès au fichier de ressources qui contient le style par défaut du contrôle.

(Hérité de Control)
Description

Obtient ou définit le contenu affiché sous le contrôle. Le contenu doit fournir des conseils sur l’entrée attendue par le contrôle.

DescriptionProperty

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

DesiredCandidateWindowAlignment

Obtient ou définit une valeur qui indique l’alignement préféré de l’éditeur de méthode d’entrée (IME).

DesiredCandidateWindowAlignmentProperty

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

DesiredSize

Obtient la taille calculée par ce UIElement 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 installation 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)
ElementSoundMode

Obtient ou définit une valeur qui spécifie la préférence d’un contrôle pour savoir si les sons sont lus.

(Hérité de Control)
ExitDisplayModeOnAccessKeyInvoked

Obtient ou définit une valeur qui spécifie si l’affichage de la clé d’accès est ignoré lorsqu’une clé d’accès est appelée.

(Hérité de UIElement)
FlowDirection

Obtient ou définit la direction dans laquelle le texte et d’autres éléments d’interface utilisateur circulent dans n’importe quel élément parent qui contrôle leur disposition. Cette propriété peut être définie sur LeftToRight ou RightToLeft. La définition de 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 pour qu’il circule de droite à gauche.

(Hérité de FrameworkElement)
FocusState

Obtient une valeur qui spécifie si ce contrôle a le focus et le mode par lequel le focus a été obtenu.

(Hérité de Control)
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 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)
FontFamily

Obtient ou définit la police utilisée pour afficher du texte dans le contrôle.

(Hérité de Control)
FontSize

Obtient ou définit la taille du texte dans ce contrôle.

(Hérité de Control)
FontStretch

Obtient ou définit le degré auquel une police est condensée ou étendue à l’écran.

(Hérité de Control)
FontStyle

Obtient ou définit le style dans lequel le texte est affiché.

(Hérité de Control)
FontWeight

Obtient ou définit l’épaisseur de la police spécifiée.

(Hérité de Control)
Foreground

Obtient ou définit un pinceau qui décrit la couleur du premier plan.

(Hérité de Control)
HandwritingView

Obtient ou définit l’objet HandwritingView associé à ce contrôle de texte.

HandwritingViewProperty

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

Header

Obtient ou définit le contenu de l’en-tête du contrôle.

HeaderProperty

Identifie la propriété de dépendance En-tête .

HeaderTemplate

Obtient ou définit le DataTemplate utilisé pour afficher le contenu de l’en-tête du contrôle.

HeaderTemplateProperty

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

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

Obtient ou définit l'alignement horizontal du contenu du contrôle.

(Hérité de Control)
HorizontalTextAlignment

Obtient ou définit une valeur qui indique comment le texte est aligné dans textBox.

HorizontalTextAlignmentProperty

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

InputScope

Obtient ou définit le contexte de l’entrée utilisée par cette Zone de texte.

InputScopeProperty

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

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

Obtient ou définit une valeur qui détermine si les glyphes de police qui contiennent des calques de couleurs, tels que Segoe UI Emoji, sont rendus en couleur.

IsColorFontEnabledProperty

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

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

Obtient ou définit une valeur indiquant si l’utilisateur peut interagir avec le contrôle.

(Hérité de Control)
IsFocusEngaged

Obtient ou définit une valeur qui indique si le focus est limité à l’intérieur des limites de contrôle (pour l’interaction à distance/pavé de jeu).

(Hérité de Control)
IsFocusEngagementEnabled

Obtient ou définit une valeur qui indique si le focus peut être limité à l’intérieur des limites de contrôle (pour l’interaction entre la manette de jeu et l’interaction à distance).

(Hérité de Control)
IsHandwritingViewEnabled

Obtient ou définit une valeur qui indique si un utilisateur peut entrer du texte dans la vue d’écriture manuscrite.

IsHandwritingViewEnabledProperty

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

IsHitTestVisible

Obtient ou définit si la zone autonome de cet élément UIElement peut retourner des valeurs vraies pour le test d’accès.

(Hérité de UIElement)
IsHoldingEnabled

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

(Hérité de UIElement)
IsLoaded

Obtient une valeur qui indique si l’élément a été ajouté à l’arborescence d’éléments et est prêt pour l’interaction.

(Hérité de FrameworkElement)
IsReadOnly

Obtient ou définit la valeur qui détermine si l’utilisateur peut modifier le texte dans la zone de texte.

IsReadOnlyProperty

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

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

Obtient ou définit une valeur qui spécifie si l’entrée TextBox interagit avec un moteur orthographique case activée.

IsSpellCheckEnabledProperty

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

IsTabStop

Obtient ou définit l'inclusion ou non d'un contrôle dans la navigation par onglets.

(Hérité de Control)
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)
IsTextPredictionEnabled

Obtient ou définit une valeur qui détermine si les fonctionnalités de prédiction de texte (« saisie semi-automatique ») doivent être activées pour cette zone de texte.

IsTextPredictionEnabledProperty

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

IsTextScaleFactorEnabled

Obtient ou définit si l’agrandissement automatique du texte, pour refléter le paramètre de taille de texte système, est activé.

(Hérité de Control)
KeyboardAcceleratorPlacementMode

Obtient ou définit une valeur qui indique si l’info-bulle de contrôle affiche la combinaison de touches pour son accélérateur de clavier associé.

(Hérité de UIElement)
KeyboardAcceleratorPlacementTarget

Obtient ou définit une valeur qui indique l’info-bulle de contrôle qui affiche la combinaison de touches d’accélérateur.

(Hérité de UIElement)
KeyboardAccelerators

Obtient la collection de combinaisons de touches qui appellent une action à l’aide du clavier.

Les accélérateurs sont généralement affectés aux boutons ou aux éléments de menu.

Exemple de menu montrant les accélérateurs de clavier pour différents éléments de menu
Exemple de menu montrant les accélérateurs de clavier pour différents éléments de menu

(Hérité de UIElement)
KeyTipHorizontalOffset

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

(Hérité de UIElement)
KeyTipPlacementMode

Obtient ou définit une valeur qui indique où la touche d’accès Est placée par rapport à la limite de l’élément UIElement.

(Hérité de UIElement)
KeyTipTarget

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

(Hérité de UIElement)
KeyTipVerticalOffset

Obtient ou définit une valeur qui indique jusqu’à quel point le key tip est placé par rapport à l’élément d’interface utilisateur.

(Hérité de UIElement)
Language

Obtient ou définit les informations de langage de localisation/globalisation qui s’appliquent à un FrameworkElement, ainsi qu’à tous les éléments enfants de l’élément FrameworkElement actuel dans la représentation d’objet et dans l’interface utilisateur.

(Hérité de FrameworkElement)
Lights

Obtient la collection d’objets XamlLight attachés à cet élément.

(Hérité de UIElement)
ManipulationMode

Obtient ou définit la valeur ManipulationModes utilisée pour le comportement et l’interaction uiElement avec les mouvements. La définition de cette valeur permet de gérer les événements de manipulation de cet élément dans le code d’application.

(Hérité de UIElement)
Margin

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

(Hérité de FrameworkElement)
MaxHeight

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

(Hérité de FrameworkElement)
MaxLength

Obtient ou définit la valeur qui spécifie le nombre maximal de caractères autorisés pour l’entrée utilisateur.

MaxLengthProperty

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

MaxWidth

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

(Hérité de FrameworkElement)
MinHeight

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

(Hérité de FrameworkElement)
MinWidth

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

(Hérité de FrameworkElement)
Name

Obtient ou définit le nom d’identification de l’objet. Lorsqu’un processeur XAML crée l’arborescence d’objets à partir du balisage XAML, le code d’exécution peut faire référence à l’objet déclaré XAML par ce nom.

(Hérité de FrameworkElement)
Opacity

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

(Hérité de UIElement)
OpacityTransition

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

(Hérité de UIElement)
Padding

Obtient ou définit la marge intérieure d’un contrôle.

(Hérité de Control)
Parent

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

(Hérité de FrameworkElement)
PlaceholderForeground

Obtient ou définit un pinceau qui décrit la couleur du texte d’espace réservé.

PlaceholderForegroundProperty

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

PlaceholderText

Obtient ou définit le texte affiché dans le contrôle jusqu’à ce que la valeur soit modifiée par une action utilisateur ou une autre opération.

PlaceholderTextProperty

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

PointerCaptures

Obtient l’ensemble de tous les pointeurs capturés, représentés en tant que valeurs de pointeur .

(Hérité de UIElement)
PreventKeyboardDisplayOnProgrammaticFocus

Obtient ou définit une valeur qui indique si le clavier à l’écran s’affiche lorsque le contrôle reçoit le focus par programmation.

PreventKeyboardDisplayOnProgrammaticFocusProperty

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

Projection

Obtient ou définit la projection de perspective (effet 3D) à appliquer lors du rendu de cet élément.

(Hérité de UIElement)
ProofingMenuFlyout

Obtient le menu volant qui affiche les commandes de vérification linguistique.

ProofingMenuFlyoutProperty

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

RenderSize

Obtient la taille de rendu finale d’un UIElement. L’utilisation n’est pas recommandée, consultez Remarques.

(Hérité de UIElement)
RenderTransform

Obtient ou définit les informations de transformation qui affectent la position de rendu d’un UIElement.

(Hérité de UIElement)
RenderTransformOrigin

Obtient ou définit le point d’origine de toute transformation de rendu possible déclarée par RenderTransform, par rapport aux limites de l’élément UIElement.

(Hérité de UIElement)
RequestedTheme

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

(Hérité de FrameworkElement)
RequiresPointer

Obtient ou définit si un élément d’interface utilisateur prend en charge le mode souris, qui émule les expériences d’interaction de pointeur avec des périphériques d’entrée sans pointeur tels qu’un pavé de jeu ou un contrôle à distance.

(Hérité de Control)
Resources

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

(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 au CenterPoint. Affecte la position de rendu de l’élément.

(Hérité de UIElement)
RotationAxis

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

(Hérité de UIElement)
RotationTransition

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

(Hérité de UIElement)
Scale

Obtient ou définit l’échelle de l’élément. Met à l’échelle par rapport au CenterPoint de l’élément. Affecte la position de rendu de l’élément.

(Hérité de UIElement)
ScaleTransition

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

(Hérité de UIElement)
SelectedText

Obtient ou définit le contenu de la sélection actuelle dans la zone de texte.

SelectionFlyout

Obtient ou définit le menu volant affiché lorsque le texte est sélectionné avec une entrée tactile ou stylet.

SelectionFlyoutProperty

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

SelectionHighlightColor

Obtient ou définit le pinceau utilisé pour mettre en surbrillance le texte sélectionné.

SelectionHighlightColorProperty

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

SelectionHighlightColorWhenNotFocused

Obtient ou définit le pinceau utilisé pour mettre en surbrillance le texte sélectionné lorsque textBox n’a pas le focus.

SelectionHighlightColorWhenNotFocusedProperty

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

SelectionLength

Obtient ou définit le nombre de caractères dans la sélection actuelle dans la zone de texte.

SelectionStart

Obtient ou définit la position de départ du texte sélectionné dans la zone de texte. Lorsque selectionLength a la valeur 0 (il n’y a pas de texte sélectionné), la propriété SelectionStart correspond à la position du curseur.

Shadow

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

(Hérité de UIElement)
Style

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

(Hérité de FrameworkElement)
TabFocusNavigation

Obtient ou définit une valeur qui modifie le fonctionnement de la tabulation et de TabIndex pour ce contrôle.

(Hérité de UIElement)
TabIndex

Obtient ou définit une valeur qui indique l’ordre dans lequel les éléments reçoivent le focus lorsque l’utilisateur navigue dans l’interface utilisateur de l’application à l’aide de la touche Tab.

(Hérité de Control)
TabNavigation

Obtient ou définit une valeur qui modifie le fonctionnement de tabulation et TabIndex pour ce contrôle.

Notes

Pour Windows 10 Creators Update (build 10.0.15063) et versions ultérieures, la propriété TabFocusNavigation est disponible dans la classe de base UIElement pour inclure des objets dans la séquence de tabulation qui n’utilisent pas de ControlTemplate.

(Hérité de Control)
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)
Template

Obtient ou définit un modèle de contrôle. Le modèle de contrôle définit l’apparence visuelle d’un contrôle dans l’interface utilisateur et est défini dans le balisage XAML.

(Hérité de Control)
Text

Obtient ou définit le contenu textuel de la zone de texte.

TextAlignment

Obtient ou définit la façon dont le texte doit être aligné horizontalement dans la zone de texte.

TextAlignmentProperty

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

TextProperty

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

TextReadingOrder

Obtient ou définit une valeur qui indique comment l’ordre de lecture est déterminé pour textBox.

TextReadingOrderProperty

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

TextWrapping

Obtient ou définit la façon dont le saut de ligne se produit si une ligne de texte s’étend au-delà de la largeur disponible de la zone de texte.

TextWrappingProperty

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

Transform3D

Obtient ou définit l’effet de transformation 3D à appliquer lors du rendu de cet élément.

(Hérité de UIElement)
TransformMatrix

Obtient ou définit la matrice de transformation à appliquer à l’élément.

(Hérité de UIElement)
Transitions

Obtient ou définit la collection d’éléments de style Transition qui s’appliquent à un UIElement.

(Hérité de UIElement)
Translation

Obtient ou définit la position de rendu x, y et z de l’élément.

(Hérité de UIElement)
TranslationTransition

Obtient ou définit la propriété Vector3Transition qui anime les modifications apportées à la propriété Translation.

(Hérité de UIElement)
Triggers

Obtient la collection de déclencheurs pour les animations définies pour un FrameworkElement. Ce n’est pas couramment utilisé. Consultez la section Notes.

(Hérité de FrameworkElement)
UIContext

Obtient l’identificateur de contexte de 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)
UseSystemFocusVisuals

Obtient ou définit une valeur qui indique si le contrôle utilise des visuels de focus qui sont dessinés par le système ou ceux définis dans le modèle de contrôle.

(Hérité de Control)
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)
VerticalContentAlignment

Obtient ou définit l'alignement vertical du contenu du contrôle.

(Hérité de Control)
Visibility

Obtient ou définit la visibilité d’un 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 en cours d’affichage.

(Hérité de UIElement)
XYFocusDown

Obtient ou définit l’objet qui obtient le focus lorsqu’un utilisateur appuie sur le pavé directionnel (D-pad) vers le bas.

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

(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 le pavé directionnel (D-pad) à gauche.

(Hérité de Control)
XYFocusLeftNavigationStrategy

Obtient ou définit une valeur qui spécifie la stratégie utilisée pour déterminer l’élément cible d’une navigation à gauche.

(Hérité de UIElement)
XYFocusRight

Obtient ou définit l’objet qui obtient le focus lorsqu’un utilisateur appuie sur le pavé directionnel (D-pad) vers la droite.

(Hérité de Control)
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) vers le haut.

(Hérité de Control)
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 comme true pour que le gestionnaire fourni soit appelé même si l’événement est géré ailleurs.

(Hérité de UIElement)
ApplyTemplate()

Charge le modèle de contrôle approprié afin que ses parties puissent être référencées.

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

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

(Hérité de UIElement)
ArrangeOverride(Size)

Fournit le comportement de la passe « Organiser » de la disposition. Les classes peuvent remplacer cette méthode pour définir leur propre comportement de passage « Arrange ».

(Hérité de FrameworkElement)
CancelDirectManipulations()

Annule le traitement de manipulation directe en cours (panoramique/zoom défini par le système) sur n’importe quel parent ScrollViewer qui contient l’élément UIElement actuel.

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

Définit la capture de pointeur sur un UIElement. Une fois capturé, seul l’élément qui a la capture déclenche des événements liés au pointeur.

(Hérité de UIElement)
ClearUndoRedoHistory()

Vide les mémoires tampons d’annulation et de rétablissement.

ClearValue(DependencyProperty)

Efface la valeur locale d’une propriété de dépendance.

(Hérité de DependencyObject)
CopySelectionToClipboard()

Copie le contenu sélectionné dans le Presse-papiers Windows.

CutSelectionToClipboard()

Déplace le contenu sélectionné dans le Presse-papiers Windows et le supprime du contrôle de texte.

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)

Tente de définir le focus sur le contrôle.

(Hérité de Control)
GetAnimationBaseValue(DependencyProperty)

Retourne toute valeur de base établie pour une propriété de dépendance, qui s’applique dans les cas où une animation n’est pas active.

(Hérité de DependencyObject)
GetBindingExpression(DependencyProperty)

Retourne la bindingExpression qui représente la liaison sur la propriété spécifiée.

(Hérité de FrameworkElement)
GetChildrenInTabFocusOrder()

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

(Hérité de UIElement)
GetLinguisticAlternativesAsync()

Obtient de manière asynchrone une liste de mots candidats en fonction des caractères phonétiques fournis dans un éditeur de méthode d’entrée (IME).

GetRectFromCharacterIndex(Int32, Boolean)

Renvoie une région rectangulaire pour le bord de début ou de fin d’un caractère à un index de caractères spécifique.

GetTemplateChild(String)

Récupère l’élément nommé dans l’arborescence visuelle ControlTemplate instanciée.

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

Retourne la valeur effective actuelle d’une propriété de dépendance à partir d’un objet 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 UIElement. Après l’invalidation, la disposition de l’élément UIElement est mise à jour, ce qui se produit de manière asynchrone.

(Hérité de UIElement)
InvalidateMeasure()

Invalide l’état de mesure (disposition) d’un UIElement.

(Hérité de UIElement)
InvalidateViewport()

Invalide l’état de la fenêtre d’affichage d’un élément UIElement utilisé pour calculer la fenêtre d’affichage effective.

(Hérité de FrameworkElement)
Measure(Size)

Mises à jour le DesiredSize d’un UIElement. En règle générale, les objets qui implémentent une disposition personnalisée pour leurs enfants de disposition appellent cette méthode à partir de leurs propres implémentations MeasureOverride pour former une mise à jour de disposition récursive.

(Hérité de UIElement)
MeasureOverride(Size)

Fournit le comportement de la passe « Mesure » du cycle de disposition. Les classes peuvent remplacer cette méthode pour définir leur propre comportement de 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 l’événement BringIntoViewRequested .

(Hérité de UIElement)
OnCharacterReceived(CharacterReceivedRoutedEventArgs)

Appelée avant que l’événement CharacterReceived ne se produise.

(Hérité de Control)
OnCreateAutomationPeer()

En cas d’implémentation dans une classe dérivée, retourne des implémentations AutomationPeer spécifiques à la classe pour l’infrastructure Microsoft UI Automation.

(Hérité de UIElement)
OnDisconnectVisualChildren()

Remplacez cette méthode pour implémenter le comportement de la disposition et de la logique lorsque des éléments sont supprimés d’une propriété enfant ou de contenu spécifique à une classe.

(Hérité de UIElement)
OnDoubleTapped(DoubleTappedRoutedEventArgs)

Appelé avant que l’événement DoubleTapped ne se produise.

(Hérité de Control)
OnDragEnter(DragEventArgs)

Appelé avant que l’événement DragEnter ne se produise.

(Hérité de Control)
OnDragLeave(DragEventArgs)

Appelé avant que l’événement DragLeave ne se produise.

(Hérité de Control)
OnDragOver(DragEventArgs)

Appelé avant que l’événement DragOver se produise.

(Hérité de Control)
OnDrop(DragEventArgs)

Appelé avant que l’événement Drop ne se produise.

(Hérité de Control)
OnGotFocus(RoutedEventArgs)

Appelé avant que l’événement GotFocus ne se produise.

(Hérité de Control)
OnHolding(HoldingRoutedEventArgs)

Appelé avant que l’événement Holding ne se produise.

(Hérité de Control)
OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs)

Appelé lorsqu’un raccourci clavier (ou accélérateur) est traité dans votre application. Remplacez cette méthode pour gérer la façon dont votre application répond lorsqu’un accélérateur de clavier est appelé.

(Hérité de UIElement)
OnKeyDown(KeyRoutedEventArgs)

Appelée avant que l’événement KeyDown ne se produise.

(Hérité de Control)
OnKeyUp(KeyRoutedEventArgs)

Appelé avant que l’événement KeyUp se produise.

(Hérité de Control)
OnLostFocus(RoutedEventArgs)

Appelé avant que l’événement LostFocus se produise.

(Hérité de Control)
OnManipulationCompleted(ManipulationCompletedRoutedEventArgs)

Appelée avant que l’événement ManipulationCompleted ne se produise.

(Hérité de Control)
OnManipulationDelta(ManipulationDeltaRoutedEventArgs)

Appelé avant que l’événement ManipulationDelta ne se produise.

(Hérité de Control)
OnManipulationInertiaStarting(ManipulationInertiaStartingRoutedEventArgs)

Appelé avant que l’événement ManipulationInertiaStarting ne se produise.

(Hérité de Control)
OnManipulationStarted(ManipulationStartedRoutedEventArgs)

Appelé avant que l’événement ManipulationStarted ne se produise.

(Hérité de Control)
OnManipulationStarting(ManipulationStartingRoutedEventArgs)

Appelé avant que l’événement ManipulationStarting ne se produise.

(Hérité de Control)
OnPointerCanceled(PointerRoutedEventArgs)

Appelé avant que l’événement PointerCanceled ne se produise.

(Hérité de Control)
OnPointerCaptureLost(PointerRoutedEventArgs)

Appelé avant que l’événement PointerCaptureLost ne se produise.

(Hérité de Control)
OnPointerEntered(PointerRoutedEventArgs)

Appelée avant que l’événement PointerEntered ne se produise.

(Hérité de Control)
OnPointerExited(PointerRoutedEventArgs)

Appelé avant que l’événement PointerExited ne se produise.

(Hérité de Control)
OnPointerMoved(PointerRoutedEventArgs)

Appelé avant que l’événement PointerMoved ne se produise.

(Hérité de Control)
OnPointerPressed(PointerRoutedEventArgs)

Appelé avant que l’événement PointerPressed ne se produise.

(Hérité de Control)
OnPointerReleased(PointerRoutedEventArgs)

Appelé avant que l’événement PointerReleased se produise.

(Hérité de Control)
OnPointerWheelChanged(PointerRoutedEventArgs)

Appelé avant que l’événement PointerWheelChanged se produise.

(Hérité de Control)
OnPreviewKeyDown(KeyRoutedEventArgs)

Appelé avant que l’événement PreviewKeyDown se produise.

(Hérité de Control)
OnPreviewKeyUp(KeyRoutedEventArgs)

Appelé avant que l’événement PreviewKeyUp ne se produise.

(Hérité de Control)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)

Appelé juste avant qu’un raccourci clavier (ou accélérateur) ne soit traité dans votre application. Appelé chaque fois que le code d’application ou les processus internes appellent ProcessKeyboardAccelerators. Remplacez cette méthode pour influencer la gestion de l’accélérateur par défaut.

(Hérité de UIElement)
OnRightTapped(RightTappedRoutedEventArgs)

Appelé avant que l’événement RightTapped ne se produise.

(Hérité de Control)
OnTapped(TappedRoutedEventArgs)

Appelé avant que l’événement Tapped ne se produise.

(Hérité de Control)
PasteFromClipboard()

Copie le contenu du Presse-papiers Windows dans le contrôle de texte.

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

Réapplique la première action dans la mémoire tampon de rétablissement.

RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Inscrit une fonction de notification pour écouter les modifications apportées à un DependencyProperty spécifique sur ce instance DependencyObject.

(Hérité de DependencyObject)
ReleasePointerCapture(Pointer)

Libère les captures de pointeur pour la capture d’un pointeur spécifique par cet UIElement.

(Hérité de UIElement)
ReleasePointerCaptures()

Libère toutes les captures de pointeur détenues par cet élément.

(Hérité de UIElement)
RemoveFocusEngagement()

Libère le focus des limites de contrôle pour un contrôle qui a l’engagement du focus (pour l’interaction à distance/pavé de jeu).

(Hérité de Control)
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)
Select(Int32, Int32)

Sélectionne une plage de texte dans la zone de texte.

SelectAll()

Sélectionne l’intégralité du contenu de la zone de texte.

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

Lance une demande à l’infrastructure XAML pour afficher l’élément dans toutes les régions défilantes dans lesquelles il se trouve.

(Hérité de UIElement)
StartBringIntoView(BringIntoViewOptions)

Lance une demande à l’infrastructure XAML pour afficher l’élément à l’aide des options spécifiées.

(Hérité de UIElement)
StartDragAsync(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 en l’objet spécifié.

(Hérité de UIElement)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)

Tente d’appeler un raccourci clavier (ou accélérateur) en recherchant le raccourci dans toute l’arborescence visuelle de l’élément UIElement.

(Hérité de UIElement)
Undo()

Annule la première action dans la mémoire tampon d’annulation.

UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Annule une notification de modification précédemment inscrite en appelant RegisterPropertyChangedCallback.

(Hérité de DependencyObject)
UpdateLayout()

Garantit que toutes les positions des objets enfants d’un UIElement sont correctement mises à jour pour la disposition.

(Hérité de UIElement)

Événements

AccessKeyDisplayDismissed

Se produit lorsque les clés d’accès ne doivent plus être affichées.

(Hérité de UIElement)
AccessKeyDisplayRequested

Se produit lorsque l’utilisateur demande que les clés d’accès soient affichées.

(Hérité de UIElement)
AccessKeyInvoked

Se produit lorsqu’un utilisateur termine une séquence de clés d’accès.

(Hérité de UIElement)
ActualThemeChanged

Se produit lorsque la valeur de la propriété ActualTheme a changé.

(Hérité de FrameworkElement)
BeforeTextChanging

Se produit de façon synchrone lorsque le texte de la zone de texte commence à changer, mais avant la mise à jour de la propriété Text .

BringIntoViewRequested

Se produit lorsque StartBringIntoView est appelé sur cet élément ou l’un de ses descendants.

(Hérité de UIElement)
CandidateWindowBoundsChanged

Se produit lorsque la fenêtre Éditeur de méthode d’entrée (IME) s’ouvre, se met à jour ou se ferme.

CharacterReceived

Se produit lorsqu’un caractère composé unique est reçu par la file d’attente d’entrée.

(Hérité de UIElement)
ContextCanceled

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

(Hérité de UIElement)
ContextMenuOpening

Se produit lorsque le système traite une interaction qui affiche un menu contextuel.

ContextRequested

Se produit lorsque l’utilisateur a terminé un mouvement d’entrée de contexte, tel qu’un clic droit.

(Hérité de UIElement)
CopyingToClipboard

Se produit avant que le texte copié ne soit déplacé dans le Presse-papiers.

CuttingToClipboard

Se produit avant que le texte coupé ne soit déplacé dans le Presse-papiers.

DataContextChanged

Se produit lorsque la valeur de la propriété FrameworkElement.DataContext change.

(Hérité de FrameworkElement)
DoubleTapped

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

(Hérité de UIElement)
DragEnter

Se produit lorsque le système d’entrée signale un événement de glissement sous-jacent avec cet élément comme cible.

(Hérité de UIElement)
DragLeave

Se produit lorsque le système d’entrée signale un événement de glissement sous-jacent avec cet élément comme origine.

(Hérité de UIElement)
DragOver

Se produit quand le système d’entrée signale un événement de glissement sous-jacent avec pour cible de dépôt potentielle cet élément.

(Hérité de UIElement)
DragStarting

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

(Hérité de UIElement)
Drop

Se produit quand le système d’entrée signale un événement de déplacement sous-jacent avec cet élément comme cible de déplacement.

(Hérité de UIElement)
DropCompleted

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

(Hérité de UIElement)
EffectiveViewportChanged

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

(Hérité de FrameworkElement)
FocusDisengaged

Se produit lorsque le focus est libéré des limites de contrôle (pour l’interaction entre la manette de jeu et l’interaction à distance).

(Hérité de Control)
FocusEngaged

Se produit lorsque le focus est limité à l’intérieur des limites de contrôle (pour l’interaction entre la manette de jeu et l’interaction à distance).

(Hérité de Control)
GettingFocus

Se produit avant qu’un élément UIElement ne reçoive le focus. Cet événement est déclenché de manière synchrone pour garantir que le focus n’est pas déplacé pendant que l’événement est en cours de bulles.

(Hérité de UIElement)
GotFocus

Se produit lorsqu’un élément UIElement reçoit le focus. Cet événement est déclenché de manière asynchrone, de sorte que le focus peut se déplacer à nouveau avant que le bouillonnement ne soit terminé.

(Hérité de UIElement)
Holding

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

(Hérité de UIElement)
IsEnabledChanged

Se produit lorsque la propriété IsEnabled change .

(Hérité de Control)
KeyDown

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

(Hérité de UIElement)
KeyUp

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

(Hérité de UIElement)
LayoutUpdated

Se produit lorsque la disposition de l’arborescence visuelle change, en raison de la modification de la valeur des propriétés pertinentes pour la disposition ou d’une autre action qui actualise la disposition.

(Hérité de FrameworkElement)
Loaded

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

(Hérité de FrameworkElement)
Loading

Se produit lorsqu’un frameworkElement commence à charger.

(Hérité de FrameworkElement)
LosingFocus

Se produit avant qu’un élément UIElement ne perde le focus. Cet événement est déclenché de manière synchrone pour garantir que le focus n’est pas déplacé pendant que l’événement est en cours de bulles.

(Hérité de UIElement)
LostFocus

Se produit lorsqu’un élément UIElement perd le focus. Cet événement est déclenché de manière asynchrone, de sorte que le focus peut se déplacer à nouveau avant que le bouillonnement ne soit terminé.

(Hérité de UIElement)
ManipulationCompleted

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

(Hérité de UIElement)
ManipulationDelta

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

(Hérité de UIElement)
ManipulationInertiaStarting

Se produit lorsque le périphérique d’entrée perd le contact avec l’objet UIElement durant une manipulation et que cela entraîne un début d’inertie.

(Hérité de UIElement)
ManipulationStarted

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

(Hérité de UIElement)
ManipulationStarting

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

(Hérité de UIElement)
NoFocusCandidateFound

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

(Hérité de UIElement)
Paste

Se produit lorsque du texte est collé dans le contrôle.

PointerCanceled

Se produit lorsqu’un pointeur qui a effectué un contact anormalement perd le contact.

(Hérité de UIElement)
PointerCaptureLost

Se produit lorsque la capture de pointeur précédemment détenue par cet élément se déplace vers un autre élément ou ailleurs.

(Hérité de UIElement)
PointerEntered

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

(Hérité de UIElement)
PointerExited

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

(Hérité de UIElement)
PointerMoved

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

(Hérité de UIElement)
PointerPressed

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

(Hérité de UIElement)
PointerReleased

Se produit lorsque l’appareil pointeur qui a précédemment lancé une action Appuyer est libéré, au sein de cet élément. Notez que la fin d’une action Appuyer n’est pas garantie pour déclencher un é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 roue de pointeur change.

(Hérité de UIElement)
PreviewKeyDown

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

(Hérité de UIElement)
PreviewKeyUp

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

(Hérité de UIElement)
ProcessKeyboardAccelerators

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

(Hérité de UIElement)
RightTapped

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

(Hérité de UIElement)
SelectionChanged

Se produit lorsque la sélection de texte a été modifiée.

SelectionChanging

Se produit lorsque la sélection de texte commence à changer.

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 prise en charge se produit sur la zone de test d’accès de cet élément.

(Hérité de UIElement)
TextChanged

Se produit lorsque le contenu change dans la zone de texte.

TextChanging

Se produit de manière synchrone lorsque le texte de la zone de texte commence à changer, mais avant qu’il ne soit rendu.

TextCompositionChanged

Se produit lorsque du texte composé via un éditeur de méthode d’entrée (IME) change.

TextCompositionEnded

Se produit lorsqu’un utilisateur cesse de composer du texte via un éditeur de méthode d’entrée (IME).

TextCompositionStarted

Se produit lorsqu’un utilisateur commence à composer du texte via un éditeur de méthode d’entrée (IME).

Unloaded

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

(Hérité de FrameworkElement)

S’applique à

Voir aussi