Graphics::Restore 方法 (gdiplusgraphics.h)

Graphics::Restore 方法将此 Graphics 对象的状态设置为之前对此 Graphics 对象的 Graphics::Save 方法的调用所存储的状态。

语法

Status Restore(
  [in] GraphicsState gstate
);

parameters

[in] gstate

类型: GraphicsState

(上一次调用此Graphics 对象的 Graphics::Save 方法) 返回的 32 位值,该对象标识已保存状态块。

返回值

类型: 状态

如果该方法成功,则返回 Ok,这是 Status 枚举的元素。

如果方法失败,它将返回 Status 枚举的其他元素之一。

注解

调用 Graphics 对象的 Graphics::Save 方法时,一个保存 Graphics 对象状态的信息块将放在堆栈上。 Graphics::Save 方法返回一个值,该值标识该信息块。 将标识值传递给 Restore 方法时,信息块将从堆栈中删除,并用于将 Graphics 对象还原到调用 Graphics::Save 时的状态。 请注意,对 Graphics::Save 方法的给定调用返回的标识符只能传递给 Graphics::Restore 方法一次。

可以嵌套对 Graphics::Save 方法的调用;也就是说,在调用 Graphics:: Restore 方法之前,可以多次调用 Graphics:: Save 方法。 每次调用 Graphics::Save 方法时,都会在堆栈上放置一个信息块,并且你会收到信息块的标识符。 将其中一个标识符传递给 Graphics::Restore 方法时, Graphics 对象将返回到返回该特定标识符的 Graphics::Save 调用时的状态。 从堆栈中删除 由 Graphics::Save 调用放置在堆栈上的信息块,并且该 Graphics::Save 调用之后放置在该堆栈上的所有信息块也会被删除。

调用 BeginContainer 方法会将信息块与调用 Graphics::Save 方法放在同一堆栈上。 正如 Graphics::Restore 调用与 Graphics::Save 调用配对一样, EndContainer 调用与 BeginContainer 调用配对。

注意调用 Graphics::Restore 时,从 (堆栈中删除对 Graphics::Save 的相应调用后,由 Graphics::SaveBeginContainer) 放置在堆栈上的所有信息块。 同样,调用 EndContainer 时,从堆栈中删除对 BeginContainer 的相应调用后,由 Graphics::SaveBeginContainer) 放置在 (堆栈上的所有信息块。
 

示例

以下示例演示了使用 Graphics::Restore 方法的 两种方法。 第一个示例演示如何还原嵌套保存状态,第二个示例演示如何仅还原两个嵌套保存状态中的第一个。

还原嵌套保存的状态

以下示例将 Graphics 对象的世界转换设置为旋转,然后保存 Graphics 对象的状态。 接下来,代码调用 TranslateTransform,并再次保存状态。 然后,代码调用 ScaleTransform。 此时, Graphics 对象的世界转换是复合转换:先旋转,然后平移,然后缩放。 代码使用红色笔绘制由该复合转换转换转换的椭圆。

代码将第二次调用 Save 返回的 state2 传递给 Graphics::Restore 方法,并使用绿色笔再次绘制椭圆。 绿色椭圆会旋转和转换,但不会缩放。 最后,代码将第一次调用 Save 返回的 state1 传递给 Graphics::Restore 方法,并使用蓝色笔再次绘制椭圆。 蓝色椭圆是旋转的,但不进行转换或缩放。

VOID Example_Save1(HDC hdc)
{
   Graphics graphics(hdc);
   GraphicsState state1, state2;

   graphics.RotateTransform(30.0f);
   state1 = graphics.Save();
   graphics.TranslateTransform(100.0f, 0.0f, MatrixOrderAppend);
   state2 = graphics.Save();
   graphics.ScaleTransform(1.0f, 3.0f, MatrixOrderAppend);
   
   // Draw an ellipse. 
   // Three transformations apply: rotate, then translate, then scale.
   Pen redPen(Color(255, 255, 0, 0));
   graphics.DrawEllipse(&redPen, 0, 0, 100, 20);
 
   // Restore to state2 and draw the ellipse again. 
   // Two transformations apply: rotate then translate.
   graphics.Restore(state2);
   Pen greenPen(Color(255, 0, 255, 0));
   graphics.DrawEllipse(&greenPen, 0, 0, 100, 20);

   // Restore to state1 and draw the ellipse again. 
   // Only the rotation transformation applies.
   graphics.Restore(state1);
   Pen bluePen(Color(255, 0, 0, 255));
   graphics.DrawEllipse(&bluePen, 0, 0, 100, 20);
}

仅还原两个嵌套保存状态中的第一个状态

以下示例将 Graphics 对象的世界转换设置为旋转,然后保存 Graphics 对象的状态。 接下来,代码调用 TranslateTransform,并再次保存状态。 然后,代码调用 ScaleTransform。 此时, Graphics 对象的世界转换是复合转换:先旋转,然后平移,然后缩放。 代码使用红色笔绘制由该复合转换转换转换的椭圆。

代码将第一次调用 Save 返回的 state1 传递给 Graphics::Restore 方法,并使用绿色笔再次绘制椭圆。 绿色椭圆是旋转的,但不进行转换或缩放。

接下来,代码尝试还原由 state2 标识的状态。 尝试失败,因为调用 Restore (state1) 从堆栈中删除了 state1state2 标识的信息块。

VOID Example_Save2(HDC hdc)
{
   Graphics graphics(hdc);
   GraphicsState state1, state2;

   graphics.RotateTransform(30.0f);
   state1 = graphics.Save();
   graphics.TranslateTransform(100.0f, 0.0f, MatrixOrderAppend);
   state2 = graphics.Save();
   graphics.ScaleTransform(1.0f, 3.0f, MatrixOrderAppend);
   
   // Draw an ellipse. 
   // Three transformations apply: rotate, then translate, then scale.
   Pen redPen(Color(255, 255, 0, 0));
   graphics.DrawEllipse(&redPen, 0, 0, 100, 20);
 
   // Restore to state1 and draw the ellipse again. 
   // Only the rotation transformation applies.
   graphics.Restore(state1);
   Pen greenPen(Color(255, 0, 255, 0));
   graphics.DrawEllipse(&greenPen, 0, 0, 100, 20);

   // The information block identified by state2 has been lost.
   // The following call to Restore has no effect because
   // Restore(state1) removed from the stack the
   // information blocks identified by state1 and state2.
   graphics.Restore(state2);

   // The Graphics object is still in the state identified by state1.
   // The following code draws a blue ellipse on top of the previously
   // drawn green ellipse.
   Pen bluePen(Color(255, 0, 0, 255));
   graphics.DrawEllipse(&bluePen, 0, 0, 100, 20);
}

要求

   
最低受支持的客户端 Windows XP、Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 gdiplusgraphics.h (包括 Gdiplus.h)
Library Gdiplus.lib
DLL Gdiplus.dll

另请参阅

显卡

Graphics::Save