Graphics.Restore(GraphicsState) メソッド

定義

この Graphics の状態を GraphicsState によって表される状態に復元します。Restores the state of this Graphics to the state represented by a 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

この Graphics を復元したときの状態を表す GraphicsStateGraphicsState that represents the state to which to restore this Graphics.

次のコード例は、Windows フォームで使用するように設計されてい PaintEventArgs e ます。これは、イベントハンドラーのパラメーターであるを必要とし Paint ます。The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. コードは、次のアクションを実行します。The code performs the following actions:

  • Windows フォームのワールド変換をベクター (100, 0) で変換します。Translates the world transform of the Windows Form by a vector (100, 0).

  • フォームのグラフィックスの状態を保存します。Saves the graphics state of the form.

  • フォームのワールド変換を id にリセットし、四角形に単色の赤いブラシで塗りつぶします。Resets the world transform of the form to an identity and fills a rectangle with a solid red brush.

  • 変換されたグラフィックスの状態を復元し、2番目の四角形に単色の青のブラシで塗りつぶします。Restores the translated graphics state and fills a second rectangle with a solid blue brush.

結果は、変換されていない赤で塗りつぶされた四角形と、変換された青で塗りつぶされた四角形になります。The result is an untranslated red-filled rectangle and a translated blue-filled rectangle.

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 がスタックに配置されます。When you call the Save method of a Graphics, an information block that holds the state of the Graphics is put on a stack. Saveメソッドは、 GraphicsState その情報ブロックを識別するを返します。The Save method returns a GraphicsState that identifies that information block. 識別を GraphicsState メソッドに渡すと、 Restore 情報ブロックがスタックから削除され、 Graphics メソッド呼び出し時の状態にを復元するために使用され Save ます。When you pass the identifying GraphicsState to the Restore method, the information block is removed from the stack and is used to restore the Graphics to the state it was in at the time of the Save method call. GraphicsStateメソッドへの特定の呼び出しによって返されるは、 Save メソッドに1回だけ渡すことができ Restore ます。Note that the GraphicsState returned by a given call to the Save method can be passed only once to the Restore method.

メソッドの呼び出しは入れ子にする Save ことができます。つまり、メソッドを Save 呼び出す前に、メソッドを複数回呼び出すことができます RestoreCalls to the Save method can be nested; that is, you can call the Save method several times before you call the Restore method. メソッドを呼び出すたびに、 Save 情報ブロックがスタックに格納され、 GraphicsState 情報ブロックのを受け取ります。Each time you call the Save method, an information block is put on the stack, and you receive a GraphicsState for the information block. これらのオブジェクトのいずれかをメソッドに渡すと Restore 、その Graphics 特定のを返したメソッド呼び出しの時点の状態にが返され Save GraphicsState ます。When you pass one of those objects to the Restore method, the Graphics is returned to the state it was in at the time of the Save method call that returned that particular GraphicsState. そのメソッド呼び出しによってスタックに配置された情報ブロック Save がスタックから削除され、そのメソッド呼び出しの後にそのスタックに配置されたすべての情報ブロックが削除され Save ます。The information block placed on the stack by that Save method call is removed from the stack, and all information blocks placed on that stack after that Save method call are also removed.

メソッドを呼び出す BeginContainer と、メソッドの呼び出しと同じスタックに情報ブロックが配置され Save ます。Calls to the BeginContainer method place information blocks on the same stack as calls to the Save method. Restore呼び出しが呼び出しとペアになっているのと同様 Save に、 EndContainer メソッド呼び出しは BeginContainer メソッド呼び出しとペアになります。Just as a Restore call is paired with a Save call, a EndContainer method call is paired with a BeginContainer method call.

メソッドを呼び出すと RestoreSave メソッドへの対応する呼び出しがスタックから削除された後、(メソッドまたはメソッドによって) スタックに配置されたすべての情報ブロック BeginContainer Save がスタックから削除されます。When you call the Restore method, all information blocks placed on the stack (by the Save method or by the BeginContainer method) after the corresponding call to the Save method are removed from the stack. 同様に、メソッドを呼び出すと、 EndContainer メソッドへの対応する呼び出しがスタックから削除された後、(メソッドまたはメソッドによって) スタックに配置されたすべての情報ブロック Save BeginContainer BeginContainer がスタックから削除されます。Likewise, when you call the EndContainer method, all information blocks placed on the stack (by the Save method or by the BeginContainer method) after the corresponding call to the BeginContainer method are removed from the stack.

適用対象