Partager via


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 Microsoft Expression Blend en double-cliquant sur la visionneuse à défilement et en y faisant glisser un élément. Si vous souhaitez placer plusieurs éléments dans la visionneuse à défilement, vous devez d’abord ajouter un panneau de disposition tel qu’une grille ou un canevas. 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 éléments 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 de propriétés 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, attribuez à la propriété HorizontalScrollBarVisibility la valeur Visible.

Vue de planche graphique d’un contrôle SimpleScrollViewer

Cc295291.0f9eba2b-ac29-4bc1-8cdb-9d32dc717992(fr-fr,Expression.10).png

Composition du modèle de contrôle

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

  • Un panneau de disposition Grille, qui sert à contenir les multiples éléments enfants dans la visionneuse à défilement. La grille est également utilisée pour permettre à un concepteur d’interface utilisateur d’application d’ajouter plus facilement des éléments au modèle. La ligne et la colonne du panneau Grille qui contient l’élément ScrollContentPresenter est réglée à la taille astérisque (*) afin qu’elle se développe en fonction du développement de la visionneuse à défilement. La ligne et la colonne du panneau Grille 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 servent à faire défiler le contenu. Les barres de défilement utilisent le modèle SimpleScrollBarStyle par défaut.

    Cc295291.alert_caution(fr-fr,Expression.10).gifAttention :

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

    Liste d’objets : parties de base (modèle) d’un contrôle SimpleScrollViewer

    Cc295291.ce27ad4d-055a-4d08-b6ee-f83fd4836820(fr-fr,Expression.10).png

Cc295291.7e183f1f-37d8-4dcb-980c-19a5d61ca087(fr-fr,Expression.10).gifHaut de la page

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 les éléments sous Déclencheurs dans le panneau Interaction pour voir les propriétés qui sont changées 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’élément Border adopte la couleur de la ressource MouseOverBrush.

Cc295291.7e183f1f-37d8-4dcb-980c-19a5d61ca087(fr-fr,Expression.10).gifHaut de la page

Pinceaux utilisés

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

Cc295291.7e183f1f-37d8-4dcb-980c-19a5d61ca087(fr-fr,Expression.10).gifHaut de la page

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 ajoutera des éléments visuels à votre contrôle. Expression Blend recherche un panneau de disposition comme le contrôle Grid et l’active par défaut afin que de nouveaux éléments ajoutés à la planche graphique deviennent des éléments 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 changé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 des parties du contrô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.

Cc295291.7e183f1f-37d8-4dcb-980c-19a5d61ca087(fr-fr,Expression.10).gifHaut de la page