SimpleScrollBar (prise en charge de WPF dans Blend)

Cette page s’applique uniquement aux projets WPF

La barre de défilement est un contrôle simple qui affiche un marqueur sur une barre à une position dépendant de la propriété Value. Pour définir l'orientation de la barre de défilement dans Blend for Visual Studio, utilisez la propriété Orientation sous Disposition dans le panneau Propriétés. Vous pouvez définir le Minimum, le Maximum et la Value actuelle de la barre de défilement sous Propriétés communes dans le panneau Propriétés. La valeur actuelle doit être comprise entre les valeurs minimale et maximale.

Vue de planche graphique d’un contrôle SimpleScrollBar

JJ171014.db3af5e5-8b09-42e7-b541-543b3b2bbcb3(fr-fr,VS.120).png

Composition du modèle de contrôle

Le modèle de contrôle SimpleScrollBar est composé des éléments suivants :

  • Panneau Grid nommé GridRoot, qui sert à contenir plusieurs objets enfants dans la barre de défilement. La Grid est également utilisée pour vous permettre d'ajouter plus facilement des objets au modèle. La Grid est divisée en trois lignes où les lignes supérieure et inférieure ont des tailles maximales définies de telle sorte qu’elles ne peuvent pas dépasser 18 pixels (en unités indépendantes des périphériques, qui sont approximativement de 1/96 de pouce), et la ligne du milieu est définie à la taille astérisque (*), ce qui signifie qu’elle se développe en fonction du développement de la fenêtre.

  • Deux objets RepeatButton nommés DecreaseRepeat et IncreaseRepeat, qui servent à déplacer le marqueur de position sur la barre. Les objets RepeatButton contiennent du contenu qui affiche des flèches. De nouveau, une Grid est utilisée comme racine pour chacun de ceux-ci afin que l’utilisateur puisse facilement modifier les objets Path (nommés DecreaseArrow et IncreaseArrow) et ajouter du contenu.

  • Objet Track nommé PART_Track qui sert à afficher un objet Thumb le long d’une barre. Les parties exposées de la barre se doublent sous la forme de contrôles RepeatButtons nommés PageDown et PageUp. Tous deux utilisent le modèle SimpleScrollRepeatButtonStyle pouvant être modifié séparément. Les sections IncreaseRepeatButton et DecreaseRepeatButton du tracé utilisent des liaisons de Command afin de pouvoir appeler des commandes sur la classe de barre de défilement. L’objet Thumb utilise le modèle SimpleThumbStyle pouvant être modifié séparément.

  • Une transformation de disposition, qui sert à afficher la barre du curseur dans une orientation horizontale. Cette conception simplifie l’édition du style sans avoir à se souvenir de modifier deux modèles différents. Cependant, dans certains cas, les deux orientations doivent être suffisamment différentes pour imposer des modèles distincts. Dans ce cas, il convient d’utiliser un élément Setter dans l’élément Style en mode XAML d’Blend pour changer de modèle en fonction de l’orientation. Vous trouverez un exemple dans le modèle par défaut du contrôle système ScrollBar.

    Avertissement

    Ne renommez pas un objet dont le nom commence par « PART_ » car il est fait référence à ces objets dans le code mettant en œuvre le contrôle.

Déclencheurs de propriété utilisés

Des déclencheurs de propriété dans le modèle de contrôle sont utilisés pour que le contrôle réagisse aux changements de propriétés. Vous pouvez cliquer sur l'élément dans le panneau Déclencheurs pour voir les propriétés qui sont changées lorsqu’un déclencheur est actif. Par exemple, dans le modèle SimpleScrollBar, lorsque la propriété Orientation a la valeur Horizontal, plusieurs propriétés sont changées pour refléter la nouvelle orientation de la barre de progression.

Pinceaux utilisés

Le modèle SimpleScrollBar utilise uniquement une ressource pinceau système pour la propriété Foreground. D'autres ressources pinceau sont référencées dans les modèles que la SimpleScrollBar utilise, comme les modèles SimpleRepeatButton, SimpleThumbStyle, et SimpleScrollRepeatButtonStyle. Pour changer l'aspect du modèle SimpleScrollBar, vous pouvez modifier les pinceaux que ces modèles utilisent ou vous pouvez créer de nouveaux modèles.

Recommandations et directives de conception

  • En général, utilisez un contrôle Grid comme racine de votre modèle si vous prévoyez qu'un concepteur ajoute d'autres éléments visuels à votre contrôle. Blend cherche un panneau de disposition comme le contrôle Grid et le rend actif par défaut pour que les nouveaux objets qui sont ajoutés à la planche graphique se retrouvent en tant qu'objets enfants du panneau de disposition.

  • Vous pouvez appliquer le modèle SimpleScrollBar à la barre de défilement qui est utilisée dans le modèle pour un ScrollViewer.

  • Comme le modèle SimpleScrollBar utilise d’autres modèles, il pourrait être laborieux de parcourir les divers niveaux de modèles pour obtenir celui que vous souhaitez modifier. Pour modifier les modèles directement, vous pouvez cliquer sur le bouton Modifier la ressource en regard du nom du modèle dans le panneau Ressources. Puis, dans le mode d’édition du style, cliquez avec le bouton droit sur Style dans le panneau Objets et chronologie, pointez sur Modifier le modèle, puis cliquez sur Modifier l'élément actuel. Il peut également être plus simple de supprimer les références aux sous-modèles (réinitialiser la propriété Style sous Divers dans le panneau Propriétés), et de concevoir la totalité dans un seul modèle.

  • Pour garantir le fonctionnement du contrôle, vous devez conserver les liaisons de commande qui déclenchent des commandes sur la classe du contrôle et fournir un autre moyen d’établir un contrat entre le contrôle et la classe qui le représente. Ces liaisons sont présentes dans les propriétés Command des objets IncreaseRepeat, DecreaseRepeat, PageUp, et PageDown et dans le déclencheur Orientation=Horizontal.

  • Si vous le voulez, vous pouvez ajouter des déclencheurs au modèle SimpleScrollBar ou modifier les objets dans l’objet PART_Track pour rendre l’aspect de la barre plus attrayant. Dans ce cas, ne renommez pas l’objet PART_Track ni aucun de ses objets enfants car il est fait référence à ces objets depuis le code qui met en œuvre ce contrôle. L’objet PART_Track peut trouver ses parties car elles sont placées sous des en-têtes de contrôle spécifiques : Track.IncreaseRepeatButton, Track.DecreaseRepeatButton et Track.Thumb. Le Thumb est également un contrôle Windows Presentation Foundation (WPF) spécifique qui peut être déplacé par glissement.

Voir aussi

Tâches

Essayez ! Personnaliser l’aspect d’un contrôle SimpleScrollBar