BitmapImage.IsAnimatedBitmap Propiedad

Definición

Espacio de nombres:

Microsoft.UI.Xaml.Media.Imaging

Obtiene un valor que indica si se anima una imagen.

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

bool IsAnimatedBitmap();

public bool IsAnimatedBitmap { get; }

var boolean = bitmapImage.isAnimatedBitmap;

Public ReadOnly Property IsAnimatedBitmap As Boolean

Valor de propiedad

Boolean

bool

true si la imagen está animada; de lo contrario, false.

Ejemplos

En este ejemplo se muestra cómo usar un GIF animado. Un botón permite al usuario iniciar o detener la animación. La propiedad IsAnimatedBitmap se comprueba para determinar si el botón se muestra o está oculto.

En el ejemplo se usa código adaptable de versión para que pueda ejecutarse en todas las versiones de Windows 10. En las versiones anteriores a la versión 1607, se muestra el primer fotograma del GIF, pero no se anima.

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

Comentarios

A partir de Windows 10, versión 1607, el elemento Imagen XAML admite imágenes GIF animadas. Al usar bitmapImage como origen de la imagen, puede acceder a BitmapImage API para controlar la reproducción de la imagen GIF animada. Para obtener más información, consulta la sección "Imágenes animadas" de los comentarios de la clase BitmapImage y el ejemplo de reproducción gif animada.

Notas de compatibilidad

Si la aplicación se ejecuta en versiones de Windows 10 anteriores a la versión 1607, debes usar la clase ApiInformation para comprobar la presencia de esta propiedad antes de usarla. Para obtener más información, consulta Código adaptable de versión: Usar nuevas API al tiempo que mantiene la compatibilidad con versiones anteriores.