Graphics.Restore(GraphicsState) Метод

Определение

Пространство имен:

System.Drawing

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v9.0.0-rc.2.24474.1

Исходный код:

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

Комментарии

При вызове метода SaveGraphicsинформационный блок, содержащий состояние Graphics, помещается в стек. Метод Save возвращает GraphicsState, определяющий этот блок информации. При передаче GraphicsState идентификации методу Restore блок информации удаляется из стека и используется для восстановления Graphics в состояние, в которое он находился во время вызова метода Save. Обратите внимание, что GraphicsState, возвращенные заданным вызовом метода Save, можно передать только один раз в метод Restore.

Вызовы метода Save могут быть вложены; То есть можно вызвать метод Save несколько раз перед вызовом метода Restore. Каждый раз при вызове метода Save информационный блок помещается в стек, и вы получаете GraphicsState для блока информации. При передаче одного из этих объектов методу RestoreGraphics возвращается в состояние, в которое он был в момент вызова метода Save, возвращающего этот конкретный GraphicsState. Блок сведений, размещенный в стеке с помощью вызова метода Save, удаляется из стека, а все блоки информации, помещенные в этот стек после вызова метода Save, также удаляются.

Вызовы метода BeginContainer размещают блоки информации в том же стеке, что и вызовы метода Save. Так же, как вызов Restore связан с вызовом Save, вызов метода EndContainer сопряжен с вызовом метода BeginContainer.

При вызове метода Restore все блоки информации, размещенные в стеке (методом Save или методом BeginContainer), после соответствующего вызова метода Save удаляются из стека. Аналогичным образом при вызове метода EndContainer все блоки информации, помещенные в стек (методом Save или методом BeginContainer), после соответствующего вызова метода BeginContainer удаляются из стека.