Partilhar via

Como: Associar Dados da propriedade Zoom de DocumentViewer usando ZoomPercentageConverter

  • Artigo

Este Extensible Application Markup Language (XAML) de exemplo mostra como vincular os dados da propriedade DocumentViewer.Zoom a um controle textual usando o conversor de tipo ZoomPercentageConverter.

Exemplo

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

Comentários de tarefas

  • Nesse exemplo, quaisquer alterações para o valor de Zoom são refletidas imediatamente na TextBox vinculado a dados. O conversor de tipo ZoomPercentageConverter é automaticamente chamado sempre que uma atualização se propaga por meio de associação de dados. Este conversor de tipo específico converte o valor duplo de Zoom em um valor string concatenado com um sinal de porcentagem (%).

  • Este exemplo usa uma declaração da ligação de sintaxe para propriedade de elemento para ligar o valor de Zoom à propriedade Text de um TextBox.

  • A cláusula ElementName na declaração da ligação refere-se ao Name do elemento de origem, que nesse caso é "dvZoomSource".

  • A cláusula Path na declaração da vinculação nomeia a propriedade de origem, que nesse caso, é Zoom .

  • A cláusula Converter especifica um conversor de tipo para usar este associação de dados. Nesse caso, cláusula se refere a um mapeamento de recurso estático localmente definido combinando a chave de recurso (x:Key) com o valor referenciado na cláusula Converter. No exemplo acima, a chave de recurso é "MyConverterKey". A chave em si é um valor da sequência de caracteres arbitrário que deve ser exclusiva dentro do escopo atual. Recursos definidos localmente devem ser referenciados usando a sintaxe de StaticResource mostrada no exemplo acima.

  • A cláusula Mode na declaração da vinculação especifica que esta é uma associação de dados unidirecional; atualizações no valor do código de Zoom são refletidas na TextBox de destino, mas alterações para o conteúdo de TextBox não alteram o valor de Zoom .

Consulte também

Conceitos

Revisão de Associação de Dados

Resumo de Declaração de Associações

Referência

IValueConverter