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
Комментарии
При вызове Save метода Graphicsобъекта информационный блок, содержащий состояние Graphics , помещается в стек. Метод Save возвращает объект , GraphicsState который идентифицирует этот информационный блок. При передаче идентификатора GraphicsStateRestore в метод информационный блок удаляется из стека и используется для восстановления Graphics до состояния, в которое он находился во время Save вызова метода. Обратите внимание, что объект , GraphicsState возвращенный заданным вызовом Save метода, может быть передан в метод только один раз Restore
.
Save Вызовы метода могут быть вложенными, то есть метод можно вызвать Save несколько раз перед вызовом Restore метода . Каждый раз при вызове Save метода в стек помещается информационный блок, и вы получаете для блока сведений GraphicsState . При передаче одного из этих объектов Restore в метод возвращается в состояние, Graphics в которое он находился во время Save вызова метода, возвращающего этот конкретный GraphicsStateобъект . Блок сведений, размещенный в стеке с помощью Save этого вызова метода, удаляется из стека, а все информационные блоки, размещенные в этом стеке после Save вызова метода, также удаляются.
Вызовы метода размещают информационные BeginContainer блоки в том же стеке, что и вызовы Save метода . Так же, как Restore вызов связан с вызовом Save , EndContainer вызов метода сопряжен с вызовом BeginContainer метода.
При вызове Restore метода все информационные блоки, размещенные в стеке (методом Save или методом BeginContainer ) после соответствующего Save вызова метода, удаляются из стека. Аналогичным образом при вызове EndContainer метода все информационные блоки, размещенные в стеке (методом Save или методом BeginContainer ) после соответствующего BeginContainer вызова метода, удаляются из стека.
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по