BitmapImage.AutoPlay Propriedade

Definição

Namespace:

Microsoft.UI.Xaml.Media.Imaging

Obtém ou define um valor que indica se uma imagem animada deve ser reproduzida assim que for carregada.

public:
 property bool AutoPlay { bool get(); void set(bool value); };

bool AutoPlay();

void AutoPlay(bool value);

public bool AutoPlay { get; set; }

var boolean = bitmapImage.autoPlay;
bitmapImage.autoPlay = boolean;

Public Property AutoPlay As Boolean

Valor da propriedade

Boolean

bool

true se uma imagem animada deve ser reproduzida assim que for carregada; caso contrário, false. O padrão é true.

Exemplos

Este exemplo mostra como usar o código adaptável de versão para usar essa propriedade em um aplicativo executado em todas as versões do Windows 10. Em versões anteriores à versão 1607, o primeiro quadro do GIF é mostrado, mas não é animado.

<Image Loaded="Image_Loaded">
    <Image.Source>
        <BitmapImage x:Name="imageSource"
                     UriSource="Assets/example.gif"/>
    </Image.Source>
</Image>

// Set the AutoPlay property.
private void Image_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Media.Imaging.BitmapImage", "AutoPlay") == true)
    {
        imageSource.AutoPlay = false;
    }
}

Comentários

A partir do Windows 10, versão 1607, o elemento Imagem XAML dá suporte a imagens GIF animadas. Ao usar um BitmapImage como a origem da imagem, você pode acessar a API BitmapImage para controlar a reprodução da imagem GIF animada. Para obter mais informações, consulte a seção 'Imagens animadas' da classe BitmapImage Comentários e o exemplo de reprodução gif animado.

Use a propriedade AutoPlay, que usa como padrão true, para especificar se um bitmap animado é reproduzido assim que ele é carregado.

Observação

Para a maioria dos aplicativos, recomendamos que você defina a Reprodução Automática como false se UISettings.AnimationsEnabled for false, para dar suporte às necessidades de acessibilidade dos usuários. Não faça isso se o conteúdo do GIF animado for importante para a usabilidade do seu aplicativo.

Notas de compatibilidade

Se o aplicativo for executado em versões do Windows 10 anteriores à versão 1607, você deverá definir essa propriedade no código e usar a classe ApiInformation para marcar para a presença dessa propriedade antes de usá-la. Se você definir essa propriedade em XAML, receberá um erro do compilador XAML. Para obter mais informações, consulte Código adaptável de versão: use novas APIs enquanto mantém a compatibilidade com versões anteriores.