Graphics.Restore(GraphicsState) Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Восстанавливает состояние этого 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 удаляются из стека.
Өнім | Нұсқалар |
---|---|
.NET | 8 (package-provided), 9 (package-provided) |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1 |
.NET Standard | 2.0 (package-provided) |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
.NET кері байланысы
.NET — бастапқы коды ашық жоба. Пікір қалдыру үшін сілтемені таңдаңыз: