HOW TO：使用 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