Graphics.Save 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
保存此 Graphics 的当前状态,并用 GraphicsState 标识保存的状态。
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 窗体 一起使用,它需要 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 标识该信息块的 。 将标识 GraphicsState 传递给 Restore 方法时,信息块将从堆栈中删除,并用于将 还原 Graphics 到调用方法时 Save 的状态。 请注意, GraphicsState 给定对 Save 方法的调用返回的 只能传递给 方法 Restore 一次。
可以嵌套对 方法的 Save 调用;也就是说,在调用 Save 方法之前,可以多次调用 Restore 方法。 每次调用 Save 方法时,都会在堆栈上放置一个信息块,并且你会收到 GraphicsState 信息块的 。 将其中一个对象传递给 Restore 方法时,Graphics将返回到返回该特定 GraphicsState的方法调用时Save它处于的状态。 该方法 Save 调用放置在堆栈上的信息块将从堆栈中删除,并且该方法调用后 Save 放置在该堆栈上的所有信息块也会被删除。
对 方法的调用将 BeginContainer 信息块与对 方法的调用放在同一堆栈上 Save 。 就像调用与调用配对一Save样Restore,EndContainer方法调用与BeginContainer方法调用配对。
调用 Restore 方法时,在相应调用Save方法后, (方法或BeginContainer方法) 放置在堆栈Save上的所有信息块都将从堆栈中删除。 同样,调用 EndContainer 方法时,在相应调用 BeginContainer 方法后,由 方法或BeginContainer方法) 放置在 (Save 堆栈上的所有信息块都会从堆栈中删除。
适用于
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈