SearchBox 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 peut être utilisé pour entrer le texte de requête de recherche. (Non recommandé pour les applications plateforme Windows universelle (UWP). Consultez AutoSuggestBox.)
/// [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 SearchBox : 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 SearchBox : Control
Public Class SearchBox
Inherits Control
<SearchBox .../>
- 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
Voici une définition XAML de base pour un SearchBox et une implémentation du gestionnaire QuerySubmitted . Il appelle Frame.Navigate pour charger une page de résultats de requête de recherche (non affichée) nommée SearchResultsPage1
.
/
Cette référenceMe dans les gestionnaires est la page contenant l’instance, comme c’est généralement le cas pour le code de gestion des événements d’entrée sur page. Vous pouvez voir du code similaire dans le cadre de Démarrage rapide : Ajout d’une recherche à une application.
<SearchBox x:Name="mySearchBox"
FocusOnKeyboardInput="True"
QuerySubmitted="mySearchBox_QuerySubmitted"
Height="35"/>
private void mySearchBox_QuerySubmitted(SearchBox sender, SearchBoxQuerySubmittedEventArgs args)
{
this.Frame.Navigate(typeof(SearchResultsPage1), args.QueryText);
}
Private Sub mySearchBox_QuerySubmitted(sender As SearchBox, args As SearchBoxQuerySubmittedEventArgs)
Me.Frame.Navigate(GetType(SearchResultsPage1), args.QueryText)
End Sub
Remarques
Utilisez AutoSuggestBox pour la recherche.
Remarques pour les versions précédentes
Windows 10 ou version ultérieure
Important
Bien que la méthode SearchBox soit implémentée dans la famille d’appareils universelle, elle n’est pas entièrement fonctionnelle sur des appareils mobiles. Utilisez AutoSuggestBox pour votre expérience de recherche universelle. Voir Remplacement de SearchBox par AutoSuggestBox.
Windows 8.x
Pour prendre en charge l’interaction au clavier et rendre l’expérience de recherche de votre application cohérente avec l’écran d’accueil, définissez la propriété FocusOnKeyboardInput sur true. Pour plus d’informations, consultez Recommandations et liste de contrôle pour la recherche.
Au minimum, chaque contrôle SearchBox doit toujours avoir un gestionnaire QuerySubmitted . Ce gestionnaire transmet le texte de la requête de l’utilisateur à une page de résultats de recherche que le gestionnaire ouvre. Ouvrez cette page en appelant Frame.Navigate. Pour plus d’informations sur l’écriture d’un gestionnaire QuerySubmitted de base et la création d’une page de résultats de recherche dans le cadre de votre application, consultez Autoriser les utilisateurs à rechercher des informations dans votre .
En plus des résultats de base et de l’expérience de recherche, searchBox prend également en charge les suggestions de recherche, la définition par programme du texte de recherche de départ et l’historique de recherche. La fonctionnalité de suggestion de recherche est prise en charge par l’API dans l’espace de noms Windows.ApplicationModel.Search . Pour obtenir un exemple de code qui montre comment utiliser ces fonctionnalités, consultez Exemple de contrôle SearchBox.
Notes
Une application ne peut pas utiliser à la fois la zone de recherche et l’objet SearchPane. L’utilisation de la zone de recherche et du volet de recherche dans la même application entraîne la levée d’une exception avec ce message : « Impossible de créer instance de type 'Windows.UI.Xaml.Controls.SearchBox' »
Constructeurs
SearchBox() |
Initialise une nouvelle instance de la classe SearchBox. |
Propriétés
AccessKey |
Obtient ou définit la clé d’accès (mnémonique) pour cet élément. (Hérité de UIElement) |
AccessKeyScopeOwner |
Obtient ou définit un élément source qui fournit l’étendue de la clé d’accès pour cet élément, même s’il ne se trouve pas dans l’arborescence visuelle de l’élément source. (Hérité de UIElement) |
ActualHeight |
Obtient la hauteur rendue d’un FrameworkElement. Consultez la section Notes. (Hérité de FrameworkElement) |
ActualOffset |
Obtient la position de cet ÉLÉMENT UIElement, par rapport à son parent, calculée lors de la passe d’organisation du processus de disposition. (Hérité de UIElement) |
ActualSize |
Obtient la taille que cet ÉLÉMENT UIElement a calculée pendant la passe d’organisation du processus de disposition. (Hérité de UIElement) |
ActualTheme |
Obtient le thème d’interface utilisateur actuellement utilisé par l’élément, qui peut être différent de RequestedTheme. (Hérité de FrameworkElement) |
ActualWidth |
Obtient la largeur rendue d’un FrameworkElement. Consultez la section Notes. (Hérité de FrameworkElement) |
AllowDrop |
Obtient ou définit une valeur qui détermine si cet élément UIElement peut être une cible de déplacement à des fins d’opérations de glisser-déplacer. (Hérité de UIElement) |
AllowFocusOnInteraction |
Obtient ou définit une valeur qui indique si l’élément obtient automatiquement le focus lorsque l’utilisateur interagit avec lui. (Hérité de FrameworkElement) |
AllowFocusWhenDisabled |
Obtient ou définit si un contrôle désactivé peut recevoir le focus. (Hérité de FrameworkElement) |
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 construit en XAML au moment du chargement XAML. Cette propriété est utile pour la résolution d’URI (Uniform Resource Identifier) au moment de l’exécution. (Hérité de FrameworkElement) |
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 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) |
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) |
ChooseSuggestionOnEnter |
Obtient ou définit une valeur qui détermine si la requête de recherche suggérée est activée lorsque l’utilisateur appuie sur Entrée. |
ChooseSuggestionOnEnterProperty |
Identifie la propriété de dépendance ChooseSuggestionOnEnter . |
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) |
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 fonctionnalité qui peut accéder à DependencyObject sur le thread d’interface utilisateur, même si le code est initié par un thread autre que l’interface utilisateur. (Hérité de DependencyObject) |
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 tout élément parent qui contrôle leur disposition. Cette propriété peut être définie sur LeftToRight ou RightToLeft. Le fait de définir FlowDirection sur RightToLeft sur n’importe quel élément définit l’alignement à droite, l’ordre de lecture de droite à gauche et la disposition du contrôle à passer de droite à gauche. (Hérité de FrameworkElement) |
FocusOnKeyboardInput |
Obtient ou définit une valeur qui détermine si un utilisateur peut effectuer une recherche en tapant n’importe où dans l’application. |
FocusOnKeyboardInputProperty |
Identifie la propriété de dépendance FocusOnKeyboardInput . |
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 |
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 |
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) |
Height |
Obtient ou définit la hauteur suggérée d’un FrameworkElement. (Hérité de FrameworkElement) |
HighContrastAdjustment |
Obtient ou définit une valeur qui indique si l’infrastructure ajuste automatiquement les propriétés visuelles de l’élément lorsque les thèmes à contraste élevé sont activés. (Hérité de UIElement) |
HorizontalAlignment |
Obtient ou définit les caractéristiques d’alignement horizontales appliquées à un FrameworkElement lorsqu’il est composé dans un parent de disposition, tel qu’un panneau ou un contrôle d’éléments. (Hérité de FrameworkElement) |
HorizontalContentAlignment |
Obtient ou définit l'alignement horizontal du contenu du contrôle. (Hérité de Control) |
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) |
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) |
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) |
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 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) |
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.
|
KeyTipHorizontalOffset |
Obtient ou définit une valeur qui indique la distance à gauche ou à droite de l’élément clé par rapport à l’élément UIElement. (Hérité de UIElement) |
KeyTipPlacementMode |
Obtient ou définit une valeur qui indique où la touche d’accès Est placée par rapport à la limite de l’élément UIElement. (Hérité de UIElement) |
KeyTipTarget |
Obtient ou définit une valeur qui indique l’élément ciblé par le conseil de clé d’accès. (Hérité de UIElement) |
KeyTipVerticalOffset |
Obtient ou définit une valeur qui indique jusqu’à quel point le key tip est placé par rapport à l’élément d’interface utilisateur. (Hérité de UIElement) |
Language |
Obtient ou définit les informations de langage de localisation/globalisation qui s’appliquent à un FrameworkElement, ainsi qu’à tous les éléments enfants du FrameworkElement actuel dans la représentation d’objet et dans l’interface utilisateur. (Hérité de FrameworkElement) |
Lights |
Obtient la collection d’objets XamlLight attachés à cet élément. (Hérité de UIElement) |
ManipulationMode |
Obtient ou définit la valeur ManipulationModes utilisée pour le comportement et l’interaction uiElement avec les mouvements. La définition de cette valeur permet de gérer les événements de manipulation de cet élément dans le code d’application. (Hérité de UIElement) |
Margin |
Obtient ou définit la marge externe d’un FrameworkElement. (Hérité de FrameworkElement) |
MaxHeight |
Obtient ou définit la contrainte de hauteur maximale d’un FrameworkElement. (Hérité de FrameworkElement) |
MaxWidth |
Obtient ou définit la contrainte de largeur maximale d’un FrameworkElement. (Hérité de FrameworkElement) |
MinHeight |
Obtient ou définit la contrainte de hauteur minimale d’un FrameworkElement. (Hérité de FrameworkElement) |
MinWidth |
Obtient ou définit la contrainte de largeur minimale d’un FrameworkElement. (Hérité de FrameworkElement) |
Name |
Obtient ou définit le nom d’identification de l’objet. Lorsqu’un processeur XAML crée l’arborescence d’objets à partir du balisage XAML, le code d’exécution peut faire référence à l’objet déclaré XAML par ce nom. (Hérité de FrameworkElement) |
Opacity |
Obtient ou définit le degré d’opacité de l’objet. (Hérité de UIElement) |
OpacityTransition |
Obtient ou définit 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) |
PlaceholderText |
Obtient ou définit le texte affiché dans le contrôle jusqu’à ce que la valeur soit modifiée par une action de l’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) |
Projection |
Obtient ou définit la projection de perspective (effet 3D) à appliquer lors du rendu de cet élément. (Hérité de UIElement) |
QueryText |
Obtient ou définit le contenu du texte de la zone de recherche. |
QueryTextProperty |
Identifie la propriété de dépendance QueryText . |
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 ressource en tant qu’éléments 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 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) |
SearchHistoryContext |
Obtient ou définit une chaîne qui identifie le contexte de la recherche et est utilisée pour stocker l’historique de recherche de l’utilisateur dans l’application. |
SearchHistoryContextProperty |
Identifie la propriété de dépendance SearchHistoryContext . |
SearchHistoryEnabled |
Obtient ou définit une valeur qui détermine si les suggestions de recherche sont effectuées à partir de l’historique de recherche. |
SearchHistoryEnabledProperty |
Identifie la propriété de dépendance SearchHistoryEnabled . |
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. |
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) |
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 panneau ou un contrôle 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 |
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 sur 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 la taille d’un élément UIElement. Les objets parents qui implémentent une disposition personnalisée pour leurs éléments enfants doivent appeler cette méthode à partir de leurs implémentations de remplacement de disposition pour former une mise à jour de disposition récursive. (Hérité de UIElement) |
ArrangeOverride(Size) |
Fournit le comportement de la passe « Arranger » de la disposition. Les classes peuvent remplacer cette méthode pour définir leur propre comportement de passe « Arrange ». (Hérité de FrameworkElement) |
CancelDirectManipulations() |
Annule le traitement de manipulation directe en cours (panoramique/zoom défini par le système) sur n’importe quel parent ScrollViewer qui contient l’élément UIElement actuel. (Hérité de UIElement) |
CapturePointer(Pointer) |
Définit la capture de pointeur sur un élément UIElement. Une fois capturé, seul l’élément qui a la capture déclenche des événements liés au pointeur. (Hérité de UIElement) |
ClearValue(DependencyProperty) |
Efface la valeur locale d’une propriété de dépendance. (Hérité de DependencyObject) |
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’appliquerait dans les cas où une animation n’est pas active. (Hérité de DependencyObject) |
GetBindingExpression(DependencyProperty) |
Renvoie la propriété BindingExpression qui représente la liaison sur la propriété spécifiée. (Hérité de FrameworkElement) |
GetChildrenInTabFocusOrder() |
Permet à une sous-classe UIElement d’exposer des éléments enfants qui participent au focus Tab. (Hérité de UIElement) |
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 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 passe « Mesure ». (Hérité de FrameworkElement) |
OnApplyTemplate() |
Appelé chaque fois que du code d’application ou des processus internes (tels qu’une passe de disposition de reconstruction) appelleNt ApplyTemplate. En termes simples, cela signifie que la méthode est appelée juste avant qu’un élément d’interface utilisateur ne s’affiche dans votre application. Remplacez cette méthode pour influencer la logique post-modèle par défaut d’une classe. (Hérité de FrameworkElement) |
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs) |
Appelé avant l’événement BringIntoViewRequested . (Hérité de UIElement) |
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) |
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 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) |
SetBinding(DependencyProperty, BindingBase) |
Attache une liaison à un FrameworkElement à l’aide de l’objet de liaison fourni. (Hérité de FrameworkElement) |
SetLocalContentSuggestionSettings(LocalContentSuggestionSettings) |
Spécifie si les suggestions basées sur des fichiers locaux sont automatiquement affichées dans les suggestions de zone de recherche et définit les critères que Windows utilise pour localiser et filtrer ces suggestions. |
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) |
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 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 continue dans un mouvement de manipulation, pour avertir l’élément que le menu volant de contexte ne doit pas être ouvert. (Hérité de UIElement) |
ContextRequested |
Se produit lorsque l’utilisateur a terminé un mouvement d’entrée de contexte, tel qu’un clic droit. (Hérité de UIElement) |
DataContextChanged |
Se produit lorsque la valeur de la propriété FrameworkElement.DataContext change. (Hérité de FrameworkElement) |
DoubleTapped |
Se produit lorsqu’une interaction DoubleTap non prise en charge se produit sur la zone de test d’accès de cet élément. (Hérité de UIElement) |
DragEnter |
Se produit lorsque le système d’entrée signale un événement de glissement sous-jacent avec cet élément comme cible. (Hérité de UIElement) |
DragLeave |
Se produit lorsque le système d’entrée signale un événement de glissement sous-jacent avec cet élément comme origine. (Hérité de UIElement) |
DragOver |
Se produit quand le système d’entrée signale un événement de glissement sous-jacent avec pour cible de dépôt potentielle cet élément. (Hérité de UIElement) |
DragStarting |
Se produit lorsqu’une opération de glisser-glisser est lancée. (Hérité de UIElement) |
Drop |
Se produit quand le système d’entrée signale un événement de déplacement sous-jacent avec cet élément comme cible de déplacement. (Hérité de UIElement) |
DropCompleted |
Se produit lorsqu’une opération de glisser-déplacer avec cet élément comme source est terminée. (Hérité de UIElement) |
EffectiveViewportChanged |
Se produit lorsque la fenêtre d’affichage effective de FrameworkElement change. (Hérité de FrameworkElement) |
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 élément FrameworkElement commence à se charger. (Hérité de FrameworkElement) |
LosingFocus |
Se produit avant qu’un élément UIElement ne perde le focus. Cet événement est déclenché de manière synchrone pour garantir que le focus n’est pas déplacé pendant que l’événement est en cours de bulles. (Hérité de UIElement) |
LostFocus |
Se produit lorsqu’un élément UIElement perd le focus. Cet événement est déclenché de manière asynchrone, de sorte que le focus peut se déplacer à nouveau avant que le bouillonnement ne soit terminé. (Hérité de UIElement) |
ManipulationCompleted |
Se produit lorsqu’une manipulation sur l’élément UIElement est terminée. (Hérité de UIElement) |
ManipulationDelta |
Se produit lorsque le périphérique d'entrée change de position pendant une manipulation. (Hérité de UIElement) |
ManipulationInertiaStarting |
Se produit lorsque le périphérique d’entrée perd le contact avec l’objet UIElement durant une manipulation et que cela entraîne un début d’inertie. (Hérité de UIElement) |
ManipulationStarted |
Se produit lorsqu’un périphérique d’entrée entame une manipulation sur l’objet UIElement. (Hérité de UIElement) |
ManipulationStarting |
Se produit lorsque le processeur de manipulation est créé initialement. (Hérité de UIElement) |
NoFocusCandidateFound |
Se produit lorsqu’un utilisateur tente de déplacer le focus (via des onglets ou des flèches directionnelles), mais que le focus ne se déplace pas, car aucun candidat de focus n’est trouvé dans la direction du mouvement. (Hérité de UIElement) |
PointerCanceled |
Se produit lorsqu’un pointeur qui a effectué un contact 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) |
PrepareForFocusOnKeyboardInput |
Se produit lorsque la propriété FocusOnKeyboardInput a la valeur true et que l’application reçoit une entrée de clavier textuelle. |
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) |
QueryChanged |
Se produit lorsque le texte de la requête change. |
QuerySubmitted |
Se produit lorsque l’utilisateur envoie une requête de recherche. |
ResultSuggestionChosen |
Se produit lorsque l’utilisateur sélectionne un résultat de recherche suggéré. |
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) |
SizeChanged |
Se produit lorsque la propriété ActualHeight ou ActualWidth modifie la valeur d’un FrameworkElement. (Hérité de FrameworkElement) |
SuggestionsRequested |
Se produit lorsque le texte de la requête de l’utilisateur change et que l’application doit fournir de nouvelles suggestions à afficher dans le volet de recherche. |
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) |
Unloaded |
Se produit lorsque cet objet n’est plus connecté à l’arborescence d’objets main. (Hérité de FrameworkElement) |