ImageAnimator.Animate(Image, EventHandler) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
以動畫形式顯示多幀影像。
public:
static void Animate(System::Drawing::Image ^ image, EventHandler ^ onFrameChangedHandler);
public static void Animate(System.Drawing.Image image, EventHandler onFrameChangedHandler);
static member Animate : System.Drawing.Image * EventHandler -> unit
Public Shared Sub Animate (image As Image, onFrameChangedHandler As EventHandler)
參數
- onFrameChangedHandler
- EventHandler
一個 EventHandler 指定動畫幀變化時所呼叫方法的物件。
範例
這個 Windows Forms 應用程式示範如何將動畫圖像繪製到螢幕上。 圖片是從與應用程式同一個資料夾 SampleAnimation.gif 動畫 GIF 檔案製作而成。
#using <System.dll>
#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>
using namespace System;
using namespace System::Drawing;
using namespace System::Windows::Forms;
public ref class AnimateImageForm : public Form
{
// Create a Bitmap Object.
private:
Bitmap^ animatedImage;
private:
bool currentlyAnimating;
public:
AnimateImageForm()
{
try
{
animatedImage = gcnew Bitmap("SampleAnimation.gif");
}
catch (ArgumentException^)
{
MessageBox::Show("Could not read the image file " +
"\"SampleAnimation.gif\",\n" +
"or it is not a valid image file.");
}
}
// This method begins the animation.
public:
void AnimateImage()
{
// Begin the animation only once.
// Make sure to animate only if animatedImage was
// successfully initialised.
if (!currentlyAnimating && animatedImage != nullptr)
{
ImageAnimator::Animate(animatedImage,
gcnew EventHandler(this, &AnimateImageForm::OnFrameChanged));
currentlyAnimating = true;
}
}
private:
void OnFrameChanged(Object^ , EventArgs^ )
{
// Force a call to the Paint event handler.
this->Invalidate();
}
protected:
virtual void OnPaint(PaintEventArgs^ e) override
{
// Begin the animation.
AnimateImage();
// Get the next frame ready for rendering.
ImageAnimator::UpdateFrames();
if (animatedImage != nullptr)
{
// Draw the next frame in the animation.
e->Graphics->DrawImage(this->animatedImage,
Point(0, 0));
}
}
};
[STAThread]
int main()
{
Application::Run(gcnew AnimateImageForm());
}
using System;
using System.Drawing;
using System.Windows.Forms;
public class animateImage : Form
{
//Create a Bitmpap Object.
Bitmap animatedImage = new Bitmap("SampleAnimation.gif");
bool currentlyAnimating = false;
//This method begins the animation.
public void AnimateImage()
{
if (!currentlyAnimating)
{
//Begin the animation only once.
ImageAnimator.Animate(animatedImage, new EventHandler(this.OnFrameChanged));
currentlyAnimating = true;
}
}
private void OnFrameChanged(object o, EventArgs e)
{
//Force a call to the Paint event handler.
this.Invalidate();
}
protected override void OnPaint(PaintEventArgs e)
{
//Begin the animation.
AnimateImage();
//Get the next frame ready for rendering.
ImageAnimator.UpdateFrames();
//Draw the next frame in the animation.
e.Graphics.DrawImage(this.animatedImage, new Point(0, 0));
}
public static void Main()
{
Application.Run(new animateImage());
}
}
Imports System.Drawing
Imports System.Windows.Forms
Public Class animateImage
Inherits Form
'Create a Bitmpap Object.
Private animatedImage As New Bitmap("SampleAnimation.gif")
Private currentlyAnimating As Boolean = False
'This method begins the animation.
Public Sub AnimateImage()
If Not currentlyAnimating Then
'Begin the animation only once.
ImageAnimator.Animate(animatedImage, _
New EventHandler(AddressOf Me.OnFrameChanged))
currentlyAnimating = True
End If
End Sub
Private Sub OnFrameChanged(ByVal o As Object, ByVal e As EventArgs)
'Force a call to the Paint event handler.
Me.Invalidate()
End Sub
Protected Overrides Sub OnPaint(ByVal e As PaintEventArgs)
'Begin the animation.
AnimateImage()
'Get the next frame ready for rendering.
ImageAnimator.UpdateFrames()
'Draw the next frame in the animation.
e.Graphics.DrawImage(Me.animatedImage, New Point(0, 0))
End Sub
Public Shared Sub Main()
Application.Run(New AnimateImage)
End Sub
End Class
備註
Note
在 .NET 6 和更新版本中,只有 Windows作系統才支援包含此類型的 System.Drawing.Common 套件。 跨平台應用程式使用此類會引發編譯時警告及執行時異常。 如需詳細資訊,請參閱 僅限 Windows 上支援的 System.Drawing.Common。