BitmapImage.AutoPlay Propiedad

Definición

Espacio de nombres:

Windows.UI.Xaml.Media.Imaging

Obtiene o establece un valor que indica si una imagen animada debe reproducirse tan pronto como se cargue.

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 de propiedad

Boolean

bool

true si una imagen animada debe reproducirse tan pronto como se cargue; de lo contrario, false. El valor predeterminado es true.

Requisitos de Windows

Familia de dispositivos	Windows 10 Anniversary Edition (se introdujo en la versión 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v3.0)

Ejemplos

En este ejemplo se muestra cómo usar código adaptable de versión para usar esta propiedad en una aplicación que se ejecuta 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.

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

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.

Utilice la propiedad Reproducción automática, que tiene como valor predeterminado true, para especificar si un mapa de bits animado se reproduce en cuanto se carga.

Nota:

Para la mayoría de las aplicaciones, se recomienda establecer Reproducción automática en false si UISettings.AnimationsEnabled es false, para admitir las necesidades de accesibilidad de los usuarios. No hagas esto si el contenido del GIF animado es importante para la facilidad de uso de la aplicación.

Notas de compatibilidad

Si la aplicación se ejecuta en versiones de Windows 10 anteriores a la versión 1607, debes establecer esta propiedad en el código y usar la clase ApiInformation para comprobar la presencia de esta propiedad antes de usarla. Si estableces esta propiedad en XAML, obtendrás un error del compilador XAML. 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.