Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais

SimpleScrollViewer

Cette page s’applique uniquement aux projets WPF

La visionneuse à défilement est un contrôle de contenu, qui affiche son contenu dans une zone avec défilement. Vous pouvez placer du contenu dans une visionneuse à défilement dans Blend for Visual Studio en double-cliquant sur la visionneuse à défilement et en y faisant glisser un objet. Si vous souhaitez placer plusieurs objets dans la visionneuse à défilement, vous devez d’abord ajouter un panneau de disposition tel qu’une Grid ou un Canvas. Une visionneuse à défilement peut également afficher du texte par défaut ; vous pouvez modifier le texte en sélectionnant la visionneuse à défilement, et en modifiant ensuite la propriété Content sous Propriétés communes dans le panneau Propriétés. Pour positionner des objets dans la visionneuse à défilement mais au-delà des limites de celle-ci, vous devez manuellement définir les propriétés de positionnement dans les Options avancées sous Disposition dans le panneau Propriétés. La barre de défilement verticale est visible par défaut. Pour faire apparaître la barre de défilement horizontale, définissez la propriété HorizontalScrollBarVisibility sur Visible.



Affichage de planche graphique d’un contrôle SimpleScrollViewer

JJ169810.0f9eba2b-ac29-4bc1-8cdb-9d32dc717992(fr-fr,VS.120).png

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

  • Un panneau de disposition Grid , qui sert à contenir les multiples éléments enfants dans la visionneuse à défilement. La Grid est également utilisée pour permettre à un concepteur d’interface utilisateur d’application d’ajouter plus facilement des objets au modèle. La ligne et la colonne du panneau Grid qui contient l’élément ScrollContentPresenter sont réglées à la taille astérisque (*) afin qu’elles se développent en fonction du développement de la visionneuse à défilement. La ligne et la colonne du panneau Grid qui contient les barres de défilement sont réglées à un dimensionnement automatique en fonction de la taille requise par les barres de défilement.

  • Un élément ScrollContentPresenter , qui est utilisé pour afficher la propriété Content de la barre de défilement à laquelle le modèle est appliqué. Cet élément doit être présent pour afficher le contenu de la barre de défilement.

  • Deux éléments ScrollBar nommés PART_HorizontalScrollBar et PART_VerticalScrollBar , qui sont utilisés pour faire défiler le contenu. Les barres de défilement utilisent le modèle SimpleScrollBarStyle par défaut.

    Mise en garde Attention

    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.

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 les éléments du panneau Déclencheurs pour voir les propriétés qui changent lorsqu'un déclencheur est actif. Par exemple, dans le modèle SimpleScrollViewer, lorsque la propriété IsMouseOver prend la valeur True, l’arrière-plan de l’objet Border adopte la couleur de la ressource MouseOverBrush.

Le modèle SimpleScrollViewer n’utilise pas de ressources pinceau dans le dictionnaire de ressources SimpleStyles.xaml. La propriété Background est plutôt liée par modèle à la propriété Background du contrôle de curseur auquel le modèle est appliqué.

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

  • Le contenu du modèle SimpleScrollViewer est présenté par un élément ScrollContentPresenter qui lie automatiquement son contenu à la propriété Content de l’élément ScrollViewer auquel ce modèle est appliqué. L’élément ScrollContentPresenter doit être présent pour que le modèle SimpleScrollViewer affiche son contenu.

  • La visibilité des barres de défilement est contrôlée par le contrôle de visionneuse à défilement parce que le modèle est lié aux propriétés qui spécifient la visibilité. Cette liaison permet aux barres de défilement de se masquer ou de s’afficher automatiquement en fonction des besoins. Vous pouvez définir la valeur par défaut de la visibilité de la barre de défilement sur le contrôle de visionneuse à défilement, ou dans son modèle.

  • Pour garantir le bon fonctionnement de la visionneuse à défilement, il convient de conserver toutes les liaisons de modèle. Notez également que les barres de défilement nommées PART_HorizontalScrollBar et PART_VerticalScrollBar ne doivent pas être modifiées car ces noms sont utilisés par le code dans la classe du contrôle.

  • Vous pouvez appliquer les modèles de barre de défilement existants dans le modèle de visionneuse à défilement en cliquant avec le bouton droit sur les barres de défilement (nommées PART_HorizontalScrollBar et PART_VerticalScrollBar), en pointant sur Modifier le modèle, en pointant sur Appliquer la ressource et en cliquant sur le nom du modèle de barre de défilement. Notez que l’orientation du modèle doit correspondre à l’orientation de la barre de défilement.

Afficher: