Graphics.Save Метод

public:
 System::Drawing::Drawing2D::GraphicsState ^ Save();

public System.Drawing.Drawing2D.GraphicsState Save();

member this.Save : unit -> System.Drawing.Drawing2D.GraphicsState

Public Function Save () As GraphicsState

Возвращаемое значение

Этот метод возвращает GraphicsState значение, представляющее сохраненное состояние этого Graphics.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требуется PaintEventArgse />, который является параметром обработчика событий Paint. Код выполняет следующие действия:

• Преобразует мир преобразования формы Windows с помощью вектора (100, 0).

• Сохраняет состояние графики формы.

• Сбрасывает преобразование формы в удостоверение (матрица 2x2, а также преобразование с нуля вектора) и заполняет прямоугольник с твердой красной кистью.

• Восстанавливает преобразованное графическое состояние и заполняет прямоугольник с твердой синей кистью.

Результатом является нетрансляционный прямоугольник с красной заливкой слева и преобразованный прямоугольник с синей заливкой справа от формы.

public:
   void SaveRestore3( 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 SaveRestore3(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 SaveRestore3(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 этот блок сведений. При передаче идентифицировать GraphicsStateRestore методу блок сведений удаляется из стека и используется для восстановления 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 метода удаляются из стека.