BitmapImage.Stop 메서드

정의

네임스페이스:

Microsoft.UI.Xaml.Media.Imaging

애니메이션 이미지의 애니메이션을 종료합니다.

public:
 virtual void Stop() = Stop;

void Stop();

public void Stop();

function stop()

Public Sub Stop ()

예제

ApiInformation.IsMethodPresent를 사용하여 호출하기 전에 Stop 메서드가 있는지 검사 방법은 다음과 같습니다.

if (ApiInformation.IsMethodPresent("Windows.UI.Xaml.Media.Imaging.BitmapImage", "Stop"))
{
    imageSource.Stop();
}

이 예제에서는 애니메이션 GIF를 사용하는 방법을 보여줍니다. 단추를 사용하면 사용자가 애니메이션을 시작하거나 중지할 수 있습니다. 재생을 전환하기 위해 Play 또는 Stop 메서드를 호출할지 여부를 확인하려면 IsPlaying 속성을 확인합니다.

이 예제에서는 버전 적응 코드를 사용하여 모든 버전의 Windows 10 실행할 수 있습니다. 이 경우 IsPlaying 속성이 있으면 Play 및 Stop 메서드도 존재하므로 추가 API 검사 필요하지 않습니다.

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

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

// Play or stop the animated bitmap.
void playButton_Click(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Media.Imaging.BitmapImage", "IsPlaying") 
        && imageSource.IsPlaying == true)
    {
        playButton.Icon = new SymbolIcon(Symbol.Play);
        imageSource.Stop();
    }
    else
    {
        playButton.Icon = new SymbolIcon(Symbol.Stop);
        imageSource.Play();
    }   
}

설명

Windows 10 버전 1607부터 XAML Image 요소는 애니메이션 GIF 이미지를 지원합니다. BitmapImage를 이미지 원본으로 사용하는 경우 BitmapImage API에 액세스하여 애니메이션 GIF 이미지의 재생을 제어할 수 있습니다. 자세한 내용은 BitmapImage 클래스 설명 및 애니메이션 GIF 재생 샘플의 '애니메이션 이미지' 섹션을 참조하세요.

애니메이션 비트맵의 재생을 제어하려면 Play 및 Stop 메서드와 함께 IsPlaying 속성을 사용합니다.

호환성 정보

앱이 버전 1607 이전의 Windows 10 릴리스에서 실행되는 경우 사용하기 전에 ApiInformation 클래스를 사용하여 이 메서드가 있는지 검사 합니다. 자세한 내용은 버전 적응 코드: 이전 버전과의 호환성을 유지하면서 새 API 사용을 참조하세요.