BitmapImage.AutoPlay Propriedade

Definição

Namespace:

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

Requisitos do Windows

Família de dispositivos	Windows 10 Anniversary Edition (introduzida na 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v3.0)

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 imagem Fonte, 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 será reproduzido assim que ele for carregado ou não.

Observação

Para a maioria dos aplicativos, recomendamos que você defina AutoPlay 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 seu 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: usar novas APIs enquanto mantém a compatibilidade com versões anteriores.