Graphics.Restore(GraphicsState) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將這個 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 之後,都會從堆疊中移除。
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應