通过

如何：使用 ZoomPercentageConverter 对 DocumentViewer 的 Zoom 属性进行数据绑定

  • 项目

更新：2007 年 11 月

此可扩展应用程序标记语言 (XAML) 示例演示了如何使用 ZoomPercentageConverter 类型转换器将 DocumentViewer.Zoom 属性的数据绑定到文本控件。

示例

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

任务备注

  • 在本示例中，对 Zoom 值的任何更改会立即反映在数据绑定的 TextBox 中。只要通过数据绑定传递更新，就会自动调用 ZoomPercentageConverter 类型转换器。此特定类型转换器将 Zoom 的双精度值转换成追加了一个百分号 (%) 的字符串值。

  • 此示例使用属性元素语法绑定声明将 Zoom 的值绑定到一个 TextBox 的 Text 属性。

  • 绑定声明中的 ElementName 子句引用源元素的 Name，在本例中是“dvZoomSource”。

  • 绑定声明中的 Path 子句对源属性进行命名，在本例中是 Zoom。

  • Converter 子句指定一个类型转换器以用于此数据绑定。在本例中，子句通过将资源键 (x:Key) 与 Converter 子句中引用的值进行匹配，来引用本地定义的静态资源映射。 在上述示例中，资源键为“MyConverterKey”。该键本身是必须在当前范围内保持唯一的任意字符串值。 必须使用上述示例所示的 StaticResource 语法来引用本地定义的资源。

  • 绑定声明中的 Mode 子句指定这是单向数据绑定，对 Zoom 的源值进行的更新会反映在目标 TextBox 中，但是对 TextBox 内容的更改不会更改 Zoom 的值。

请参见

概念

数据绑定概述

绑定声明概述

参考

IValueConverter