Graphics.Restore(GraphicsState) 方法

定义

命名空间:

System.Drawing

程序集:

System.Drawing.Common.dll

包:

System.Drawing.Common v8.0.0

Source:

Graphics.cs

将此 Graphics 的状态还原到 GraphicsState 表示的状态。

public:
 void Restore(System::Drawing::Drawing2D::GraphicsState ^ gstate);

public void Restore (System.Drawing.Drawing2D.GraphicsState gstate);

member this.Restore : System.Drawing.Drawing2D.GraphicsState -> unit

Public Sub Restore (gstate As GraphicsState)

参数

gstate

GraphicsState

GraphicsState，它表示要将此 Graphics 还原到的状态。

示例

下面的代码示例旨在与 Windows 窗体 一起使用，它需要 PaintEventArgse，这是事件处理程序的参数Paint。 此代码执行以下操作：

• 将 Windows 窗体的世界转换由向量 (100， 0) 。

• 保存窗体的图形状态。

• 将窗体的世界转换重置为标识，并使用纯红色画笔填充矩形。

• 还原已翻译的图形状态，并使用纯蓝色画笔填充第二个矩形。

结果是未翻译的红色填充矩形和已翻译的蓝色填充矩形。

public:
   void SaveRestore2( PaintEventArgs^ e )
   {
      // Translate transformation matrix.
      e->Graphics->TranslateTransform( 100, 0 );

      // Save translated graphics state.
      GraphicsState^ transState = e->Graphics->Save();

      // Reset transformation matrix to identity and fill rectangle.
      e->Graphics->ResetTransform();
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Red ), 0, 0, 100, 100 );

      // Restore graphics state to translated state and fill second
      // rectangle.
      e->Graphics->Restore( transState );
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Blue ), 0, 0, 100, 100 );
   }

private void SaveRestore2(PaintEventArgs e)
{

    // Translate transformation matrix.
    e.Graphics.TranslateTransform(100, 0);

    // Save translated graphics state.
    GraphicsState transState = e.Graphics.Save();

    // Reset transformation matrix to identity and fill rectangle.
    e.Graphics.ResetTransform();
    e.Graphics.FillRectangle(new SolidBrush(Color.Red), 0, 0, 100, 100);

    // Restore graphics state to translated state and fill second

    // rectangle.
    e.Graphics.Restore(transState);
    e.Graphics.FillRectangle(new SolidBrush(Color.Blue), 0, 0, 100, 100);
}

Private Sub SaveRestore2(ByVal e As PaintEventArgs)

    ' Translate transformation matrix.
    e.Graphics.TranslateTransform(100, 0)

    ' Save translated graphics state.
    Dim transState As GraphicsState = e.Graphics.Save()

    ' Reset transformation matrix to identity and fill rectangle.
    e.Graphics.ResetTransform()
    e.Graphics.FillRectangle(New SolidBrush(Color.Red), 0, 0, 100, 100)

    ' Restore graphics state to translated state and fill second

    ' rectangle.
    e.Graphics.Restore(transState)
    e.Graphics.FillRectangle(New SolidBrush(Color.Blue), 0, 0, _
    100, 100)
End Sub

注解

调用 Save 的 Graphics方法时，将把包含 状态 Graphics 的信息块放在堆栈上。 方法 Save 返回一个 GraphicsState 标识该信息块的 。 将标识 GraphicsState 传递给 Restore 方法时，信息块将从堆栈中删除，并用于将 还原 Graphics 到调用方法时 Save 的状态。 请注意， GraphicsState 给定对 Save 方法的调用返回的 只能传递给 方法 Restore 一次。

可以嵌套对 方法的 Save 调用;也就是说，在调用 Save 方法之前，可以多次调用 Restore 方法。 每次调用 Save 方法时，都会在堆栈上放置一个信息块，并且你会收到 GraphicsState 信息块的 。 将其中一个对象传递给 Restore 方法时，Graphics将返回到返回该特定 GraphicsState的方法调用时Save它处于的状态。 该方法 Save 调用放置在堆栈上的信息块将从堆栈中删除，并且该方法调用后 Save 放置在该堆栈上的所有信息块也会被删除。

对 方法的调用将 BeginContainer 信息块与对 方法的调用放在同一堆栈上 Save 。 就像调用与调用配对一Save样Restore，EndContainer方法调用与BeginContainer方法调用配对。

调用 Restore 方法时，在相应调用Save方法后， (方法或BeginContainer方法) 放置在堆栈Save上的所有信息块都将从堆栈中删除。 同样，调用 EndContainer 方法时，在相应调用 BeginContainer 方法后， (方法或BeginContainer方法) 放置在堆栈Save上的所有信息块都会从堆栈中删除。