Graphics.BeginContainer Graphics.BeginContainer Graphics.BeginContainer Graphics.BeginContainer Method

定义

保存具有此 Graphics 的当前状态的图形容器,然后打开并使用新的图形容器。Saves a graphics container with the current state of this Graphics and opens and uses a new graphics container.

重载

BeginContainer() BeginContainer() BeginContainer() BeginContainer()

保存具有此 Graphics 的当前状态的图形容器,然后打开并使用新的图形容器。Saves a graphics container with the current state of this Graphics and opens and uses a new graphics container.

BeginContainer(Rectangle, Rectangle, GraphicsUnit) BeginContainer(Rectangle, Rectangle, GraphicsUnit) BeginContainer(Rectangle, Rectangle, GraphicsUnit) BeginContainer(Rectangle, Rectangle, GraphicsUnit)

保存具有此 Graphics 的当前状态的图形容器,然后打开并使用具有指定缩放变形的新图形容器。Saves a graphics container with the current state of this Graphics and opens and uses a new graphics container with the specified scale transformation.

BeginContainer(RectangleF, RectangleF, GraphicsUnit) BeginContainer(RectangleF, RectangleF, GraphicsUnit) BeginContainer(RectangleF, RectangleF, GraphicsUnit) BeginContainer(RectangleF, RectangleF, GraphicsUnit)

保存具有此 Graphics 的当前状态的图形容器,然后打开并使用具有指定缩放变形的新图形容器。Saves a graphics container with the current state of this Graphics and opens and uses a new graphics container with the specified scale transformation.

BeginContainer() BeginContainer() BeginContainer() BeginContainer()

保存具有此 Graphics 的当前状态的图形容器,然后打开并使用新的图形容器。Saves a graphics container with the current state of this Graphics and opens and uses a new graphics container.

public:
 System::Drawing::Drawing2D::GraphicsContainer ^ BeginContainer();
public System.Drawing.Drawing2D.GraphicsContainer BeginContainer ();
member this.BeginContainer : unit -> System.Drawing.Drawing2D.GraphicsContainer
Public Function BeginContainer () As GraphicsContainer

返回

此方法返回一个 GraphicsContainer,该对象表示该方法调用运行时此 Graphics 的状态。This method returns a GraphicsContainer that represents the state of this Graphics at the time of the method call.

示例

下面的代码示例旨在与 Windows 窗体一起使用,并且它需要PaintEventArgs e作为Paint事件处理程序的参数。The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. 该代码执行下列操作:The code performs the following actions:

  • 打开新的图形容器并保存旧容器。Opens a new graphics container and saves the old container.

  • 将世界坐标转换到容器中。Translates the world coordinates in the container.

  • 在的(已转换的)新容器中填充红色矩形。Fills a red rectangle in the (translated coordinates of the) new container.

  • 关闭新容器并还原已保存的容器。Closes the new container and restores the saved container.

  • 填充已保存容器的绿色矩形(到未翻译的坐标)。Fills a green rectangle (to the untranslated coordinates) of the saved container.

结果是一个绿色矩形,它 overlies 大小相同的红色矩形。The result is a green rectangle that overlies a red rectangle of the same size.

private:
   void BeginContainerVoid( PaintEventArgs^ e )
   {
      // Begin graphics container.
      GraphicsContainer^ containerState = e->Graphics->BeginContainer();

      // Translate world transformation.
      e->Graphics->TranslateTransform( 100.0F, 100.0F );

      // Fill translated rectangle in container with red.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Red ), 0, 0, 200, 200 );

      // End graphics container.
      e->Graphics->EndContainer( containerState );

      // Fill untransformed rectangle with green.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Green ), 0, 0, 200, 200 );
   }
private void BeginContainerVoid(PaintEventArgs e)
{
    // Begin graphics container.
    GraphicsContainer containerState = e.Graphics.BeginContainer();
             
    // Translate world transformation.
    e.Graphics.TranslateTransform(100.0F, 100.0F);
             
    // Fill translated rectangle in container with red.
    e.Graphics.FillRectangle(new SolidBrush(Color.Red), 0, 0, 200, 200);
             
    // End graphics container.
    e.Graphics.EndContainer(containerState);
             
    // Fill untransformed rectangle with green.
    e.Graphics.FillRectangle(new SolidBrush(Color.Green), 0, 0, 200, 200);
}
Private Sub BeginContainerVoid(ByVal e As PaintEventArgs)

    ' Begin graphics container.
    Dim containerState As GraphicsContainer = _
    e.Graphics.BeginContainer()

    ' Translate world transformation.
    e.Graphics.TranslateTransform(100.0F, 100.0F)

    ' Fill translated rectangle in container with red.
    e.Graphics.FillRectangle(New SolidBrush(Color.Red), 0, 0, 200, 200)

    ' End graphics container.
    e.Graphics.EndContainer(containerState)

    ' Fill untransformed rectangle with green.
    e.Graphics.FillRectangle(New SolidBrush(Color.Green), 0, 0, _
    200, 200)
End Sub

注解

将此方法与EndContainer方法一起使用可创建嵌套图形容器。Use this method with the EndContainer method to create nested graphics containers. 图形容器将保留图形状态,如转换、剪辑区域和呈现属性。Graphics containers retain graphics state, such as transformation, clipping region, and rendering properties.

调用BeginContainer的方法Graphics时,保存的Graphics状态的信息块将放在堆栈上。When you call the BeginContainer method of a Graphics, an information block that holds the state of the Graphics is put on a stack. BeginContainer 方法GraphicsContainer返回标识该信息块的。The BeginContainer method returns a GraphicsContainer that identifies that information block. 将标识对象传递给EndContainer方法时,信息块将从堆栈中移除,并用于将Graphics还原到在BeginContainer方法调用时它所处的状态。When you pass the identifying object to the EndContainer method, the information block is removed from the stack and is used to restore the Graphics to the state it was in at the time of the BeginContainer method call.

容器可以嵌套;也就是说,您可以在BeginContainer EndContainer调用方法之前多次调用方法。Containers can be nested; that is, you can call the BeginContainer method several times before you call the EndContainer method. 每次调用BeginContainer方法时,都会将信息块放在堆栈上,并GraphicsContainer收到信息块的。Each time you call the BeginContainer method, an information block is put on the stack, and you receive a GraphicsContainer for the information block. 将其中一个EndContainer对象传递给方法时Graphics ,将返回到它在BeginContainer方法调用时返回该特定GraphicsContainer的状态。When you pass one of those objects to the EndContainer method, the Graphics is returned to the state it was in at the time of the BeginContainer method call that returned that particular GraphicsContainer. 从堆栈中删除由该BeginContainer方法调用放置在堆栈上的信息块,并且也会删除该BeginContainer方法调用之后置于该堆栈上的所有信息块。The information block placed on the stack by that BeginContainer method call is removed from the stack, and all information blocks placed on that stack after that BeginContainer method call are also removed.

调用方法会将信息块放在与调用BeginContainer方法相同的堆栈上。 SaveCalls to the Save method place information blocks on the same stack as calls to the BeginContainer method. 正如EndContainer方法调用BeginContainer与方法调用配对一样, Restore方法调用与Save方法调用配对。Just as an EndContainer method call is paired with a BeginContainer method call, a Restore method call is paired with a Save method call.

调用EndContainer方法时,将从堆栈中移除在调用BeginContainer方法后,在堆栈Save上放置的所有BeginContainer信息块(由方法或方法调用)。When you call the EndContainer method, all information blocks placed on the stack (by the Save method or by the BeginContainer method) after the corresponding call to the BeginContainer method are removed from the stack. 同样, Restore当调用方法时,将从堆栈中移除对Save方法的相应调用后Save放置在堆栈上BeginContainer的所有信息块(由方法或方法调用)。Likewise, when you call the Restore method, all information blocks placed on the stack (by the Save method or by the BeginContainer method) after the corresponding call to the Save method are removed from the stack.

BeginContainer方法建立的图形状态包括默认图形状态的渲染质量; 当调用方法时,任何呈现质量状态更改都将重置为默认值。The graphics state established by the BeginContainer method includes the rendering qualities of the default graphics state; any rendering-quality state changes existing when the method is called are reset to the default values.

BeginContainer(Rectangle, Rectangle, GraphicsUnit) BeginContainer(Rectangle, Rectangle, GraphicsUnit) BeginContainer(Rectangle, Rectangle, GraphicsUnit) BeginContainer(Rectangle, Rectangle, GraphicsUnit)

保存具有此 Graphics 的当前状态的图形容器,然后打开并使用具有指定缩放变形的新图形容器。Saves a graphics container with the current state of this Graphics and opens and uses a new graphics container with the specified scale transformation.

public:
 System::Drawing::Drawing2D::GraphicsContainer ^ BeginContainer(System::Drawing::Rectangle dstrect, System::Drawing::Rectangle srcrect, System::Drawing::GraphicsUnit unit);
public System.Drawing.Drawing2D.GraphicsContainer BeginContainer (System.Drawing.Rectangle dstrect, System.Drawing.Rectangle srcrect, System.Drawing.GraphicsUnit unit);
member this.BeginContainer : System.Drawing.Rectangle * System.Drawing.Rectangle * System.Drawing.GraphicsUnit -> System.Drawing.Drawing2D.GraphicsContainer
Public Function BeginContainer (dstrect As Rectangle, srcrect As Rectangle, unit As GraphicsUnit) As GraphicsContainer

参数

dstrect
Rectangle Rectangle Rectangle Rectangle

Rectangle 结构,它与 srcrect 参数一起为容器指定缩放变换。Rectangle structure that, together with the srcrect parameter, specifies a scale transformation for the container.

srcrect
Rectangle Rectangle Rectangle Rectangle

Rectangle 结构,它与 dstrect 参数一起为容器指定缩放变换。Rectangle structure that, together with the dstrect parameter, specifies a scale transformation for the container.

unit
GraphicsUnit GraphicsUnit GraphicsUnit GraphicsUnit

GraphicsUnit 枚举的成员,它指定容器的度量单位。Member of the GraphicsUnit enumeration that specifies the unit of measure for the container.

返回

此方法返回一个 GraphicsContainer,该对象表示该方法调用运行时此 Graphics 的状态。This method returns a GraphicsContainer that represents the state of this Graphics at the time of the method call.

示例

下面的代码示例旨在与 Windows 窗体一起使用,并且它需要PaintEventArgs e作为Paint事件处理程序的参数。The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. 该代码执行下列操作:The code performs the following actions:

  • 创建两个矩形,为新容器指定缩放变换。Creates two rectangles to specify a scale transformation for the new container.

  • 打开新的图形容器并保存旧容器。Opens the new graphics container and saves the old container.

  • 在的(缩放的)新容器中填充红色矩形。Fills a red rectangle in the (scaled coordinates of the) new container.

  • 关闭新容器并还原已保存的容器。Closes the new container and restores the saved container.

  • 填充已保存容器的绿色矩形(到未缩放的坐标)。Fills a green rectangle (to the unscaled coordinates) of the saved container.

结果是一个绿色矩形,它 overlies 一个较小的红色矩形。The result is a green rectangle that overlies a smaller red rectangle.

private:
   void BeginContainerRectangle( PaintEventArgs^ e )
   {
      // Define transformation for container.
      Rectangle srcRect = Rectangle(0,0,200,200);
      Rectangle destRect = Rectangle(100,100,150,150);

      // Begin graphics container.
      GraphicsContainer^ containerState = e->Graphics->BeginContainer( destRect, srcRect, GraphicsUnit::Pixel );

      // Fill red rectangle in container.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Red ), 0, 0, 200, 200 );

      // End graphics container.
      e->Graphics->EndContainer( containerState );

      // Fill untransformed rectangle with green.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Green ), 0, 0, 200, 200 );
   }
private void BeginContainerRectangle(PaintEventArgs e)
{
    // Define transformation for container.
    Rectangle srcRect = new Rectangle(0, 0, 200, 200);
    Rectangle destRect = new Rectangle(100, 100, 150, 150);
             
    // Begin graphics container.
    GraphicsContainer containerState = e.Graphics.BeginContainer(
        destRect, srcRect,
        GraphicsUnit.Pixel);
             
    // Fill red rectangle in container.
    e.Graphics.FillRectangle(new SolidBrush(Color.Red), 0, 0, 200, 200);
             
    // End graphics container.
    e.Graphics.EndContainer(containerState);
             
    // Fill untransformed rectangle with green.
    e.Graphics.FillRectangle(new SolidBrush(Color.Green), 0, 0, 200, 200);
}
Private Sub BeginContainerRectangle(ByVal e As PaintEventArgs)

    ' Define transformation for container.
    Dim srcRect As New Rectangle(0, 0, 200, 200)
    Dim destRect As New Rectangle(100, 100, 150, 150)

    ' Begin graphics container.
    Dim containerState As GraphicsContainer = _
    e.Graphics.BeginContainer(destRect, srcRect, GraphicsUnit.Pixel)

    ' Fill red rectangle in container.
    e.Graphics.FillRectangle(New SolidBrush(Color.Red), 0, 0, 200, 200)

    ' End graphics container.
    e.Graphics.EndContainer(containerState)

    ' Fill untransformed rectangle with green.
    e.Graphics.FillRectangle(New SolidBrush(Color.Green), 0, 0, _
    200, 200)
End Sub

注解

将此方法与EndContainer方法一起使用可创建嵌套图形容器。Use this method with the EndContainer method to create nested graphics containers. 图形容器将保留图形状态,如转换、剪辑区域和呈现属性。Graphics containers retain graphics state, such as transformation, clipping region, and rendering properties.

调用BeginContainer的方法Graphics时,保存的Graphics状态的信息块将放在堆栈上。When you call the BeginContainer method of a Graphics, an information block that holds the state of the Graphics is put on a stack. BeginContainer 方法GraphicsContainer返回标识该信息块的。The BeginContainer method returns a GraphicsContainer that identifies that information block. 将标识对象传递给EndContainer方法时,信息块将从堆栈中移除,并用于将Graphics还原到在BeginContainer方法调用时它所处的状态。When you pass the identifying object to the EndContainer method, the information block is removed from the stack and is used to restore the Graphics to the state it was in at the time of the BeginContainer method call.

容器可以嵌套;也就是说,您可以在BeginContainer EndContainer调用方法之前多次调用方法。Containers can be nested; that is, you can call the BeginContainer method several times before you call the EndContainer method. 每次调用BeginContainer方法时,都会将信息块放在堆栈上,并GraphicsContainer收到信息块的。Each time you call the BeginContainer method, an information block is put on the stack, and you receive a GraphicsContainer for the information block. 将其中一个EndContainer对象传递给方法时Graphics ,将返回到它在BeginContainer方法调用时返回该特定GraphicsContainer的状态。When you pass one of those objects to the EndContainer method, the Graphics is returned to the state it was in at the time of the BeginContainer method call that returned that particular GraphicsContainer. 从堆栈中删除由该BeginContainer方法调用放置在堆栈上的信息块,并且也会删除该BeginContainer方法调用之后置于该堆栈上的所有信息块。The information block placed on the stack by that BeginContainer method call is removed from the stack, and all information blocks placed on that stack after that BeginContainer method call are also removed.

调用方法会将信息块放在与调用BeginContainer方法相同的堆栈上。 SaveCalls to the Save method place information blocks on the same stack as calls to the BeginContainer method. 正如EndContainer方法调用BeginContainer与方法调用配对一样, Restore方法调用与Save方法调用配对。Just as an EndContainer method call is paired with a BeginContainer method call, a Restore method call is paired with a Save method call.

调用EndContainer方法时,将从堆栈中移除在调用BeginContainer方法后,在堆栈Save上放置的所有BeginContainer信息块(由方法或方法调用)。When you call the EndContainer method, all information blocks placed on the stack (by the Save method or by the BeginContainer method) after the corresponding call to the BeginContainer method are removed from the stack. 同样, Restore当调用方法时,将从堆栈中移除对Save方法的相应调用后Save放置在堆栈上BeginContainer的所有信息块(由方法或方法调用)。Likewise, when you call the Restore method, all information blocks placed on the stack (by the Save method or by the BeginContainer method) after the corresponding call to the Save method are removed from the stack.

此方法为具有dstrectsrcrect参数的新图形容器指定缩放转换。This method specifies a scale transformation for the new graphics container with the dstrect and srcrect parameters. 刻度等于转换,在应用到srcrect后,将dstrect生成。The scale is equal to the transformation that, when applied to srcrect, results in dstrect.

BeginContainer方法建立的图形状态包括默认图形状态的渲染质量; 当调用方法时,任何呈现质量状态更改都将重置为默认值。The graphics state established by the BeginContainer method includes the rendering qualities of the default graphics state; any rendering-quality state changes existing when the method is called are reset to the default values.

BeginContainer(RectangleF, RectangleF, GraphicsUnit) BeginContainer(RectangleF, RectangleF, GraphicsUnit) BeginContainer(RectangleF, RectangleF, GraphicsUnit) BeginContainer(RectangleF, RectangleF, GraphicsUnit)

保存具有此 Graphics 的当前状态的图形容器,然后打开并使用具有指定缩放变形的新图形容器。Saves a graphics container with the current state of this Graphics and opens and uses a new graphics container with the specified scale transformation.

public:
 System::Drawing::Drawing2D::GraphicsContainer ^ BeginContainer(System::Drawing::RectangleF dstrect, System::Drawing::RectangleF srcrect, System::Drawing::GraphicsUnit unit);
public System.Drawing.Drawing2D.GraphicsContainer BeginContainer (System.Drawing.RectangleF dstrect, System.Drawing.RectangleF srcrect, System.Drawing.GraphicsUnit unit);
member this.BeginContainer : System.Drawing.RectangleF * System.Drawing.RectangleF * System.Drawing.GraphicsUnit -> System.Drawing.Drawing2D.GraphicsContainer
Public Function BeginContainer (dstrect As RectangleF, srcrect As RectangleF, unit As GraphicsUnit) As GraphicsContainer

参数

dstrect
RectangleF RectangleF RectangleF RectangleF

RectangleF 结构,它与 srcrect 参数一起为新的图形容器指定缩放变换。RectangleF structure that, together with the srcrect parameter, specifies a scale transformation for the new graphics container.

srcrect
RectangleF RectangleF RectangleF RectangleF

RectangleF 结构,它与 dstrect 参数一起为新的图形容器指定缩放变换。RectangleF structure that, together with the dstrect parameter, specifies a scale transformation for the new graphics container.

unit
GraphicsUnit GraphicsUnit GraphicsUnit GraphicsUnit

GraphicsUnit 枚举的成员,它指定容器的度量单位。Member of the GraphicsUnit enumeration that specifies the unit of measure for the container.

返回

此方法返回一个 GraphicsContainer,该对象表示该方法调用运行时此 Graphics 的状态。This method returns a GraphicsContainer that represents the state of this Graphics at the time of the method call.

示例

下面的代码示例旨在与 Windows 窗体一起使用,并且它需要PaintEventArgs e作为Paint事件处理程序的参数。The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. 该代码执行下列操作:The code performs the following actions:

  • 创建两个矩形,为新容器指定缩放变换。Creates two rectangles to specify a scale transformation for the new container.

  • 打开新的图形容器并保存旧容器。Opens the new graphics container and saves the old container.

  • 在的(缩放的)新容器中填充红色矩形。Fills a red rectangle in the (scaled coordinates of the) new container.

  • 关闭新容器并还原已保存的容器。Closes the new container and restores the saved container.

  • 填充已保存容器的绿色矩形(到未缩放的坐标)。Fills a green rectangle (to the unscaled coordinates) of the saved container.

结果是一个绿色矩形,它 overlies 一个较小的红色矩形。The result is a green rectangle that overlies a smaller red rectangle.

private:
   void BeginContainerRectangleF( PaintEventArgs^ e )
   {
      // Define transformation for container.
      RectangleF srcRect = RectangleF(0.0F,0.0F,200.0F,200.0F);
      RectangleF destRect = RectangleF(100.0F,100.0F,150.0F,150.0F);

      // Begin graphics container.
      GraphicsContainer^ containerState = e->Graphics->BeginContainer( destRect, srcRect, GraphicsUnit::Pixel );

      // Fill red rectangle in container.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Red ), 0.0F, 0.0F, 200.0F, 200.0F );

      // End graphics container.
      e->Graphics->EndContainer( containerState );

      // Fill untransformed rectangle with green.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Green ), 0.0F, 0.0F, 200.0F, 200.0F );
   }
private void BeginContainerRectangleF(PaintEventArgs e)
{
    // Define transformation for container.
    RectangleF srcRect = new RectangleF(0.0F, 0.0F, 200.0F, 200.0F);
    RectangleF destRect = new RectangleF(100.0F, 100.0F, 150.0F, 150.0F);
             
    // Begin graphics container.
    GraphicsContainer containerState = e.Graphics.BeginContainer(
        destRect, srcRect,
        GraphicsUnit.Pixel);
             
    // Fill red rectangle in container.
    e.Graphics.FillRectangle(new SolidBrush(Color.Red), 0.0F, 0.0F, 200.0F, 200.0F);
             
    // End graphics container.
    e.Graphics.EndContainer(containerState);
             
    // Fill untransformed rectangle with green.
    e.Graphics.FillRectangle(new SolidBrush(Color.Green), 0.0F, 0.0F, 200.0F, 200.0F);
}
Private Sub BeginContainerRectangleF(ByVal e As PaintEventArgs)

    ' Define transformation for container.
    Dim srcRect As New RectangleF(0.0F, 0.0F, 200.0F, 200.0F)
    Dim destRect As New RectangleF(100.0F, 100.0F, 150.0F, 150.0F)

    ' Begin graphics container.
    Dim containerState As GraphicsContainer = _
    e.Graphics.BeginContainer(destRect, srcRect, GraphicsUnit.Pixel)

    ' Fill red rectangle in container.
    e.Graphics.FillRectangle(New SolidBrush(Color.Red), 0.0F, 0.0F, _
    200.0F, 200.0F)

    ' End graphics container.
    e.Graphics.EndContainer(containerState)

    ' Fill untransformed rectangle with green.
    e.Graphics.FillRectangle(New SolidBrush(Color.Green), 0.0F, 0.0F, _
    200.0F, 200.0F)
End Sub

注解

将此方法与EndContainer方法一起使用可创建嵌套图形容器。Use this method with the EndContainer method to create nested graphics containers. 图形容器将保留图形状态,如转换、剪辑区域和呈现属性。Graphics containers retain graphics state, such as transformation, clipping region, and rendering properties.

调用BeginContainer的方法Graphics时,保存的Graphics状态的信息块将放在堆栈上。When you call the BeginContainer method of a Graphics, an information block that holds the state of the Graphics is put on a stack. BeginContainer 方法GraphicsContainer返回标识该信息块的。The BeginContainer method returns a GraphicsContainer that identifies that information block. 将标识对象传递给EndContainer方法时,信息块将从堆栈中移除,并用于将Graphics还原到在BeginContainer方法调用时它所处的状态。When you pass the identifying object to the EndContainer method, the information block is removed from the stack and is used to restore the Graphics to the state it was in at the time of the BeginContainer method call.

容器可以嵌套;也就是说,您可以在BeginContainer EndContainer调用方法之前多次调用方法。Containers can be nested; that is, you can call the BeginContainer method several times before you call the EndContainer method. 每次调用BeginContainer方法时,都会将信息块放在堆栈上,并GraphicsContainer收到信息块的。Each time you call the BeginContainer method, an information block is put on the stack, and you receive a GraphicsContainer for the information block. 将其中一个EndContainer对象传递给方法时Graphics ,将返回到它在BeginContainer方法调用时返回该特定GraphicsContainer的状态。When you pass one of those objects to the EndContainer method, the Graphics is returned to the state it was in at the time of the BeginContainer method call that returned that particular GraphicsContainer. 从堆栈中删除由该BeginContainer方法调用放置在堆栈上的信息块,并且也会删除该BeginContainer方法调用之后置于该堆栈上的所有信息块。The information block placed on the stack by that BeginContainer method call is removed from the stack, and all information blocks placed on that stack after that BeginContainer method call are also removed.

调用方法会将信息块放在与调用BeginContainer方法相同的堆栈上。 SaveCalls to the Save method place information blocks on the same stack as calls to the BeginContainer method. 正如EndContainer方法调用BeginContainer与方法调用配对一样, Restore方法调用与Save方法调用配对。Just as an EndContainer method call is paired with a BeginContainer method call, a Restore method call is paired with a Save method call.

调用EndContainer方法时,将从堆栈中移除在调用BeginContainer方法后,在堆栈Save上放置的所有BeginContainer信息块(由方法或方法调用)。When you call the EndContainer method, all information blocks placed on the stack (by the Save method or by the BeginContainer method) after the corresponding call to the BeginContainer method are removed from the stack. 同样, Restore当调用方法时,将从堆栈中移除对Save方法的相应调用后Save放置在堆栈上BeginContainer的所有信息块(由方法或方法调用)。Likewise, when you call the Restore method, all information blocks placed on the stack (by the Save method or by the BeginContainer method) after the corresponding call to the Save method are removed from the stack.

此方法为具有dstrectsrcrect参数的新图形容器指定缩放转换。This method specifies a scale transformation for the new graphics container with the dstrect and srcrect parameters. 刻度等于转换,在应用到srcrect后,将dstrect生成。The scale is equal to the transformation that, when applied to srcrect, results in dstrect.

BeginContainer方法建立的图形状态包括默认图形状态的渲染质量; 当调用方法时,任何呈现质量状态更改都将重置为默认值。The graphics state established by the BeginContainer method includes the rendering qualities of the default graphics state; any rendering-quality state changes existing when the method is called are reset to the default values.

适用于