Graphics.Restore(GraphicsState) Method

Definition

Восстанавливает состояние данного объекта 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)

Parameters

gstate
GraphicsState

Объект GraphicsState, представляющий состояние, в которое должен восстанавливаться данный объект Graphics.GraphicsState that represents the state to which to restore this Graphics.

Examples

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий 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 Form в вектор (100, 0).Translates the world transform of the Windows Form by a vector (100, 0).

  • Сохраняет графическое состояние формы.Saves the graphics state of the form.

  • Сбрасывает универсальное преобразование формы в удостоверение и заполняет прямоугольник сплошной красной кистью.Resets the world transform of the form to an identity and fills a rectangle with a solid red brush.

  • Восстанавливает переведенное состояние графики и заполняет второй прямоугольник сплошной синей кистью.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

Remarks

При вызове метода 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, можно передать методу 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 можно вызвать несколько раз перед вызовом метода Restore.Calls 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.

При вызове метода Restore все информационные блоки, размещенные в стеке (методом Save или методом 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.

Applies to