Graphics.Save 方法

public:
 System::Drawing::Drawing2D::GraphicsState ^ Save();

public System.Drawing.Drawing2D.GraphicsState Save();

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

Public Function Save () As GraphicsState

傳回

此方法回傳 GraphicsState 代表該 Graphics儲存狀態的 a。

範例

以下程式碼範例是為 Windows Forms 設計的，並需要 PaintEventArgse，這是 Paint 事件處理程序的參數。 此程式碼會執行下列動作：

• 將 Windows 表單的世界轉換轉換為向量 （100， 0）。

• 這樣可以保存表單的圖形狀態。

• 將形式的世界轉換重置為恆等式（2x2 恆等矩陣加上一個零向量平移），並用實心紅色筆刷填滿矩形。

• 還原翻譯後的圖形狀態，並用實心藍色筆刷填滿矩形。

結果是左側為未平移紅色填補矩形，右側為平移藍色填補矩形。

public:
   void SaveRestore3( 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 SaveRestore3(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 SaveRestore3(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

備註

當你呼叫 的方法時SaveGraphics，會有一個儲存狀態Graphics的資訊區塊被放入堆疊中。 該 Save 方法回傳 a GraphicsState ，以識別該資訊區塊。 當你將識別 GraphicsState 碼傳給 Restore 方法時，資訊區塊會從堆疊中移除，並用來 Graphics 還原方法呼叫時 Save 的狀態。 請注意，呼叫該方法所回傳GraphicsState的資訊Save只能傳遞一次給該Restore方法。

呼叫方法Save可以巢狀;也就是說，你可以在呼叫Save該方法之前多次呼叫該Restore方法。 每次你呼叫該 Save 方法時，堆疊上都會有一個資訊區塊，而你則會收到該資訊區塊的 a GraphicsState 。 當你把其中一個物件傳給方法時Restore，會Graphics回傳到呼叫該特定 Save的 時的狀態GraphicsState。 該方法呼叫放置於堆疊 Save 上的資訊區塊會從堆疊中移除，而該方法呼叫後 Save 放置於該堆疊上的資訊區塊也會被移除。

呼叫該 BeginContainer 方法時，資訊區塊與呼叫 Save 方法同一個堆疊。 就像 Restore 呼叫與呼叫 Save 配對一樣， EndContainer 方法呼叫也會與 BeginContainer 方法呼叫配對。

當你呼叫該Restore方法時，所有在呼叫Save該方法後放置於堆疊上的資訊區塊（無論是由該BeginContainer方法還是方法）Save都會從堆疊中移除。 同理，當你呼叫該EndContainer方法時，所有在呼叫Save該方法後放置於堆疊上的資訊區塊（無論是由該方法或BeginContainer由該方法）BeginContainer都會從堆疊中移除。