Partager via

Comment : lier les données de la propriété Zoom de DocumentViewer à l'aide de ZoomPercentageConverter

  • Article

Mise à jour : novembre 2007

Cet exemple XAML (Extensible Application Markup Language) montre comment lier les données de la propriété DocumentViewer.Zoom à un contrôle de texte à l'aide du convertisseur de type ZoomPercentageConverter.

Exemple

<Window x:Class="SDKSample.Window1"
        xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml">
  <Grid>
    <Grid.Resources>
      <ZoomPercentageConverter x:Key="MyConverterKey" />
    </Grid.Resources>
    <Grid.RowDefinitions>
      <RowDefinition Height="*" />
      <RowDefinition Height="*" />
    </Grid.RowDefinitions>
    <DocumentViewer Name="dvZoomSource" Grid.Row="0" />
    <TextBox Grid.Row="1">
      <TextBox.Text>
        <Binding
            ElementName="dvZoomSource" 
            Path="Zoom" 
            Converter="{StaticResource MyConverterKey}" 
            Mode="OneWay" />
      </TextBox.Text>
    </TextBox>
  </Grid>
</Window>

Notes de tâche

  • Dans cet exemple, toutes les modifications de la valeur de Zoom sont répercutées immédiatement dans le TextBoxlié aux données. Le convertisseur de type ZoomPercentageConverter est appelé automatiquement toutes les fois qu'une mise à jour se propage à travers la liaison de données. Ce convertisseur de type particulier traduit la valeur double de Zoom dans une valeur de chaîne ajoutée avec un signe de pourcentage (%).

  • Cet exemple utilise une syntaxe de déclaration de liaison d'élément de propriété pour lier la valeur de Zoom à la propriété Text d'un TextBox.

  • La clause ElementName dans la déclaration de liaison fait référence au Nom de l'élément source, qui dans ce cas est "dvZoomSource."

  • La clause Path dans la déclaration de liaison nomme la propriété source, que dans ce cas est Zoom.

  • La clause Converter spécifie un convertisseur de type à utiliser pour cette liaison de données. Dans ce cas, la clause fait référence à un mappage de ressource statique définie localement qui fait correspondre la clé de ressource (x:Key) à la valeur référencée dans la clause Converter. Dans l'exemple précité, la clé de ressource est "MyConverterKey." La clé elle-même est une valeur de chaîne arbitraire qui doit être unique dans la portée actuelle. Les ressources définies localement doivent être référencées à l'aide de la syntaxe StaticResource illustrée dans l'exemple ci-dessus.

  • La clause Mode dans la déclaration de liaison spécifie qu'il s'agit d'une liaison de données unidirectionnelle ; les mises à jour de la valeur source de Zoom sont répercutées dans la Zone de texte cible, mais les modifications apportées au contenu de la Zone de texte ne modifient pas la valeur de Zoom.

Voir aussi

Concepts

Vue d'ensemble de la liaison de données

Vue d'ensemble des déclarations de liaison

Référence

IValueConverter