描述

 

关闭以前由BeginContainer方法打开的图形容器。

 

C++ 语法

 

 

PowerBASIC 语法

 

 

参数

 

graphics

 

[in]指向图像对象的指针。

 

state

 

[in]标识要关闭的容器的值（以前由GdipBeginContainer返回）。

 

返回值

 

如果函数成功，则返回Ok，它是状态枚举的一个元素。

 

如果函数失败，它返回状态枚举的其他元素之一。

 

备注

 

当您调用图像对象的GdipBeginContainer函数时，将保存图像对象状态的信息块放在堆栈上。GdipBeginContainer函数返回一个标识该信息块的值。当您将识别值传递给GdipEndContainer方法时，信息块将从堆栈中移除，并用于将Graphics对象还原到GdipBeginContainer调用时所处的状态。

 

容器可嵌套;也就是说，您可以在调用GdipEndContainer方法之前多次调用GdipBeginContainer函数。每次调用GdipBeginContainer方法时，信息块都放在堆栈上，您将收到该信息块的标识符。当您将其中一个标识符传递给GdipEndContainer方法时，图像对象将返回到返回该特定标识符的GdipBeginContainer调用时所处的状态。由GdipBeginContainer调用放置在堆栈上的信息块将从堆栈中删除，并且在GdipBeginContainer调用之后放置在该堆栈上的所有信息块也将被删除。

 

调用GdipSaveGraphics函数将信息块放在与GdipBeginContainer方法调用相同的堆栈上。正如GdipEndContainer呼叫与GdipBeginContainer呼叫配对，GdipRestoreGraphics呼叫与GdipSaveGraphics呼叫配对。

 

警告当您致电GdipEndContainer时，相应调用GdipBeginContainer之后，堆栈中放置的所有信息块（由GdipSaveGraphics或GdipBeginContainer）从堆栈中移除。同样地，当您调用GdipRestoreGraphics时，从堆栈中删除相应调用GdipSaveGraphics之后堆栈上的所有信息块（GdipSaveGraphics或GdipBeginContainer）。