Язык

BitmapImage.AutoPlay Свойство

Определение

Пространство имен:
Microsoft.UI.Xaml.Media.Imaging
Изменить

Возвращает или задает значение, указывающее, должен ли анимационный образ воспроизводиться сразу после загрузки.

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

Значение свойства

Boolean

bool

Значение true , если анимированное изображение должно воспроизводиться сразу после загрузки; в противном случае значение false. Значение по умолчанию: true.

Примеры

В этом примере показано, как использовать адаптивный код версии для использования этого свойства в приложении, работающем во всех версиях Windows 10. В версиях до версии 1607 отображается первый кадр GIF, но он не анимирован.

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

Комментарии

Начиная с Windows 10 версии 1607 элемент XAML Image поддерживает анимированные ИЗОБРАЖЕНИЯ GIF. При использовании BitmapImage в качестве источника изображения можно получить доступ к API BitmapImage для управления воспроизведением анимированного GIF-изображения. Дополнительные сведения см. в разделе "Анимированные изображения" класса BitmapImage и примера воспроизведения анимированного GIF-файла.

Используйте свойство AutoPlay, которое по умолчанию имеет значение true, чтобы указать, воспроизводится ли анимированный растровый рисунок сразу после загрузки.

Note

Для большинства приложений рекомендуется задать для автозапуска значение false , если UISettings.AnimationsEnabled имеет значение false, чтобы поддерживать потребности пользователей в специальных возможностях. Не делайте этого, если содержимое анимированного GIF важно для удобства использования приложения.

Заметки о совместимости

Если приложение работает в выпусках Windows 10 до версии 1607, необходимо задать это свойство в коде и использовать класс ApiInformation, чтобы проверить наличие этого свойства перед его использованием. Если задать это свойство в XAML, вы получите ошибку компилятора XAML. Дополнительные сведения см. в статье "Адаптивный код версии": использование новых API при сохранении совместимости с предыдущими версиями.

Применяется к