SvgImageSource Classe

Definição

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SvgImageSource : ImageSource

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class SvgImageSource : ImageSource

Public Class SvgImageSource
Inherits ImageSource

Herança

Object IInspectable DependencyObject ImageSource SvgImageSource

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemplos

Aqui está um exemplo de como definir a origem de uma imagem para um arquivo SVG. Como não há nenhuma altura ou largura especificada explicitamente, o layout do aplicativo ditará o tamanho apropriado para o SVG decodificar.

<Image Source="Assets/mysvg.svg"/>

Comentários

SvgImageSource permite que você use uma origem SVG para ser exibida usando um ImageBrush ou diretamente em um controle Image . O SvgImageSource dá suporte ao modo estático seguro da especificação SVG e não dá suporte a animações ou interações. A API do Direct2D fornece o suporte de renderização SVG subjacente e, para obter mais informações sobre o elemento SVG específico e o suporte a atributos, consulte Suporte a SVG. Para obter mais informações sobre formatos e como usar o URI (Uniform Resource Identifier) para acessar arquivos de origem de imagem provenientes de recursos de aplicativo, consulte Image e ImageBrush.

O SvgImageSource representa uma abstração para que uma origem SVG possa ser definida de forma assíncrona, mas ainda assim ser referenciada na marcação XAML como um valor de propriedade ou no código como um objeto que não usa sintaxe aguardável. Quando você cria um objeto SvgImageSource no código, ele inicialmente não tem uma origem válida. Em seguida, você deve definir sua origem usando uma destas técnicas:

• Use o construtor SvgImageSource(Uri) em vez do construtor padrão. Embora seja um construtor, você pode pensar nisso como tendo um comportamento assíncrono implícito: o SvgImageSource não estará pronto para uso até que ele gere um evento Open que indique uma operação bem-sucedida do conjunto de origem assíncrona.
• Defina a propriedade UriSource . Assim como acontece com o construtor Uri , essa ação é implicitamente assíncrona e o SvgImageSource não estará pronto para uso até gerar um evento Open .
• Use SetSourceAsync(IRandomAccessStream). Esse método é explicitamente assíncrono. As propriedades em que você pode usar um SvgImageSource, como Source, foram projetadas para esse comportamento assíncrono e não gerarão exceções se elas estiverem definidas usando um SvgImageSource que ainda não tenha uma fonte completa. Em vez de lidar com exceções, você deve manipular eventos Open ou OpenFailed diretamente no SvgImageSource ou no controle que usa a origem (se esses eventos estiverem disponíveis na classe de controle).

Aberto e OpenFailed são mutuamente exclusivos. Um evento ou outro sempre será gerado sempre que um objeto SvgImageSource tiver seu valor de origem definido ou redefinido.

Dimensionamento

Dependendo do caso de uso pretendido, você pode especificar o tamanho de um SvgImageSource de várias maneiras diferentes:

• Use as propriedades RasterizePixelHeight e RasterizePixelWidth para especificar uma altura e largura explícitas em pixels lógicos para decodificar a origem SVG.
• Se você não especificar um RasterizePixelHeight ou RasterizePixelWidth, o layout do aplicativo ditará o tamanho do decodificado enquanto ainda preserva a taxa de proporção. Se nenhum tamanho puder ser determinado no layout do aplicativo, a origem do SVG será decodificada para o tamanho máximo da janela.

Compatibilidade de versões

A classe SvgImageSource não está disponível antes do Windows 10, versão 1703. Se a configuração de "versão mínima da plataforma" do aplicativo no Microsoft Visual Studio for menor que a "versão introduzida" mostrada no bloco Requisitos mais adiante nesta página, você não poderá usar o SvgImageSource. Para obter mais informações, consulte Código adaptável de versão.

Para evitar exceções quando seu aplicativo é executado em versões anteriores do Windows 10, não defina essa propriedade em XAML nem use-a sem executar um runtime marcar. Este exemplo mostra como usar a classe ApiInformation para marcar para a presença dessa classe antes de usá-la.

Construtores

Propriedades

Métodos

Eventos

Aplica-se a