BitmapImage.IsAnimatedBitmap Propriedade

Definição

Namespace:

Microsoft.UI.Xaml.Media.Imaging

Obtém um valor que indica se uma imagem é animada.

public:
 property bool IsAnimatedBitmap { bool get(); };

bool IsAnimatedBitmap();

public bool IsAnimatedBitmap { get; }

var boolean = bitmapImage.isAnimatedBitmap;

Public ReadOnly Property IsAnimatedBitmap As Boolean

Valor da propriedade

Boolean

bool

true se a imagem for animada; caso contrário, false.

Exemplos

Este exemplo mostra como usar um GIF animado. Um botão permite que o usuário inicie ou interrompa a animação. A propriedade IsAnimatedBitmap é verificada para determinar se o botão é mostrado ou oculto.

O exemplo usa código adaptável de versão para que possa ser 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.

<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
    <Image>
        <Image.Source>
            <BitmapImage x:Name="imageSource"
                         UriSource="Assets/example.gif"
                         ImageOpened="imageSource_ImageOpened"/>
        </Image.Source>
    </Image>

    <AppBarButton x:Name="playButton"
              Icon="Play"
              Visibility="Collapsed"
              Click="playButton_Click"/>
</Grid>

// Show the play/stop button if the image is animated.
private void imageSource_ImageOpened(object sender, RoutedEventArgs e)
{
    var bitmapImage = (BitmapImage)sender;
    // At this point you can query whether the image is animated or not.
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Media.Imaging.BitmapImage", "IsAnimatedBitmap") 
        && bitmapImage.IsAnimatedBitmap == true)
    {
        // Enable the play button
        playButton.Visibility = Visibility.Visible;
    }
}

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.

Notas de compatibilidade

Se seu aplicativo for executado em versões do Windows 10 anteriores à versão 1607, você deverá usar a classe ApiInformation para marcar para a presença dessa propriedade antes de usá-la. 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.