Graphics.Restore(GraphicsState) 方法

定義

命名空間:

System.Drawing

組件:

System.Drawing.Common.dll

套件:

System.Drawing.Common v8.0.0

來源:

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 Forms 使用，而且需要 PaintEventArgse，這是事件處理程序的參數Paint。 此程式碼會執行下列動作：

• 將 Windows Form 世界轉換轉譯為向量 (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 呼叫可以是巢狀的;也就是說，您可以在呼叫 SaveRestore 方法之前呼叫方法數次。 每次呼叫 Save 方法時，都會將資訊區塊放在堆疊上，而您會收到 GraphicsState 資訊區塊的 。 當您將其中一個對象傳遞至 Restore 方法時，Graphics會傳回傳回該特定GraphicsState之Save方法呼叫時的狀態。 該方法 Save 呼叫放置在堆疊上的資訊區塊會從堆疊中移除，而且也會移除該方法呼叫之後 Save 在該堆棧上放置的所有資訊區塊。

呼叫 方法時 BeginContainer ，會將資訊區塊放在與呼叫 Save 方法相同的堆疊上。 就像呼叫與Save呼叫配對一樣Restore，EndContainer方法呼叫會與BeginContainer方法呼叫配對。

當您呼叫 Restore 方法時，方法 (堆疊上 Save 放置的所有資訊區塊，或 BeginContainer 方法) 方法的對應呼叫 Save 之後，都會從堆疊中移除。 同樣地，當您呼叫 EndContainer 方法時，方法 (堆疊上 Save 放置的所有資訊區塊，或 BeginContainer 方法) 方法的對應呼叫 BeginContainer 之後，都會從堆疊中移除。