Graphics.BeginContainer Método

Definición

Guarda un contenedor de gráficos con el estado actual de este Graphics y abre y usa un nuevo contenedor de gráficos.Saves a graphics container with the current state of this Graphics and opens and uses a new graphics container.

Sobrecargas

BeginContainer()

Guarda un contenedor de gráficos con el estado actual de este Graphics y abre y usa un nuevo contenedor de gráficos.Saves a graphics container with the current state of this Graphics and opens and uses a new graphics container.

BeginContainer(Rectangle, Rectangle, GraphicsUnit)

Guarda un contenedor de gráficos con el estado actual de este Graphics y abre y usa un nuevo contenedor de gráficos con la transformación de escala especificada.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)

Guarda un contenedor de gráficos con el estado actual de este Graphics y abre y usa un nuevo contenedor de gráficos con la transformación de escala especificada.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()

Guarda un contenedor de gráficos con el estado actual de este Graphics y abre y usa un nuevo contenedor de gráficos.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

Devoluciones

Este método devuelve un GraphicsContainer que representa el estado de este Graphics en el momento de la llamada al método.This method returns a GraphicsContainer that represents the state of this Graphics at the time of the method call.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del controlador de eventos 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. El código realiza las siguientes acciones:The code performs the following actions:

  • Abre un nuevo contenedor de gráficos y guarda el contenedor antiguo.Opens a new graphics container and saves the old container.

  • Traduce las coordenadas universales del contenedor.Translates the world coordinates in the container.

  • Rellena un rectángulo rojo en el nuevo contenedor (coordenadas traducidas del).Fills a red rectangle in the (translated coordinates of the) new container.

  • Cierra el nuevo contenedor y restaura el contenedor guardado.Closes the new container and restores the saved container.

  • Rellena un rectángulo verde (en las coordenadas sin traducir) del contenedor guardado.Fills a green rectangle (to the untranslated coordinates) of the saved container.

El resultado es un rectángulo verde que se basa en un rectángulo rojo del mismo tamaño.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

Comentarios

Use este método con el método EndContainer para crear contenedores de gráficos anidados.Use this method with the EndContainer method to create nested graphics containers. Los contenedores de gráficos conservan el estado de los gráficos, como la transformación, la región de recorte y las propiedades de representación.Graphics containers retain graphics state, such as transformation, clipping region, and rendering properties.

Cuando se llama al método BeginContainer de una Graphics, se coloca en una pila un bloque de información que contiene el estado de la 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. El método BeginContainer devuelve un GraphicsContainer que identifica ese bloque de información.The BeginContainer method returns a GraphicsContainer that identifies that information block. Al pasar el objeto de identificación al método EndContainer, el bloque de información se quita de la pila y se usa para restaurar el Graphics al estado en el que se encontraba en el momento de la llamada al método 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.

Los contenedores se pueden anidar; es decir, puede llamar al método BeginContainer varias veces antes de llamar al método EndContainer.Containers can be nested; that is, you can call the BeginContainer method several times before you call the EndContainer method. Cada vez que se llama al método BeginContainer, se coloca un bloque de información en la pila y se recibe un GraphicsContainer para el bloque de información.Each time you call the BeginContainer method, an information block is put on the stack, and you receive a GraphicsContainer for the information block. Cuando se pasa uno de esos objetos al método EndContainer, el Graphics se devuelve al estado en el que se encontraba en el momento de la llamada al método BeginContainer que devolvía ese GraphicsContainerdeterminado.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. El bloque de información colocado en la pila mediante el BeginContainer llamada al método se quita de la pila, y todos los bloques de información colocados en esa pila después de ese BeginContainer llamada al método también se quitan.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.

Las llamadas al método Save colocan bloques de información en la misma pila como llamadas al método BeginContainer.Calls to the Save method place information blocks on the same stack as calls to the BeginContainer method. Del mismo modo que una llamada al método EndContainer se empareja con una llamada al método BeginContainer, una llamada al método Restore se empareja con una llamada al método 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.

Cuando se llama al método EndContainer, todos los bloques de información colocados en la pila (por el método Save o por el método BeginContainer) después de que la llamada correspondiente al método BeginContainer se quite de la pila.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. Del mismo modo, cuando se llama al método Restore, todos los bloques de información colocados en la pila (por el método Save o por el método BeginContainer) después de que la llamada correspondiente al método Save se quite de la pila.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.

El estado de los gráficos establecido por el método BeginContainer incluye las cualidades de representación del estado predeterminado de los gráficos. los cambios de estado de calidad de representación existentes cuando se llama al método se restablecen a los valores predeterminados.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)

Guarda un contenedor de gráficos con el estado actual de este Graphics y abre y usa un nuevo contenedor de gráficos con la transformación de escala especificada.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

Parámetros

dstrect
Rectangle

Estructura Rectangle que, junto con el parámetro srcrect, especifica una transformación de escala para el contenedor.Rectangle structure that, together with the srcrect parameter, specifies a scale transformation for the container.

srcrect
Rectangle

Estructura Rectangle que, junto con el parámetro dstrect, especifica una transformación de escala para el contenedor.Rectangle structure that, together with the dstrect parameter, specifies a scale transformation for the container.

unit
GraphicsUnit

Miembro de la enumeración GraphicsUnit que especifica la unidad de medida para el contenedor.Member of the GraphicsUnit enumeration that specifies the unit of measure for the container.

Devoluciones

Este método devuelve un GraphicsContainer que representa el estado de este Graphics en el momento de la llamada al método.This method returns a GraphicsContainer that represents the state of this Graphics at the time of the method call.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del controlador de eventos 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. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea dos rectángulos para especificar una transformación de escala para el nuevo contenedor.Creates two rectangles to specify a scale transformation for the new container.

  • Abre el nuevo contenedor de gráficos y guarda el contenedor antiguo.Opens the new graphics container and saves the old container.

  • Rellena un rectángulo rojo en el nuevo contenedor (coordenadas escaladas del).Fills a red rectangle in the (scaled coordinates of the) new container.

  • Cierra el nuevo contenedor y restaura el contenedor guardado.Closes the new container and restores the saved container.

  • Rellena un rectángulo verde (en las coordenadas sin escala) del contenedor guardado.Fills a green rectangle (to the unscaled coordinates) of the saved container.

El resultado es un rectángulo verde que se basa en un rectángulo rojo más pequeño.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

Comentarios

Use este método con el método EndContainer para crear contenedores de gráficos anidados.Use this method with the EndContainer method to create nested graphics containers. Los contenedores de gráficos conservan el estado de los gráficos, como la transformación, la región de recorte y las propiedades de representación.Graphics containers retain graphics state, such as transformation, clipping region, and rendering properties.

Cuando se llama al método BeginContainer de una Graphics, se coloca en una pila un bloque de información que contiene el estado de la 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. El método BeginContainer devuelve un GraphicsContainer que identifica ese bloque de información.The BeginContainer method returns a GraphicsContainer that identifies that information block. Al pasar el objeto de identificación al método EndContainer, el bloque de información se quita de la pila y se usa para restaurar el Graphics al estado en el que se encontraba en el momento de la llamada al método 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.

Los contenedores se pueden anidar; es decir, puede llamar al método BeginContainer varias veces antes de llamar al método EndContainer.Containers can be nested; that is, you can call the BeginContainer method several times before you call the EndContainer method. Cada vez que se llama al método BeginContainer, se coloca un bloque de información en la pila y se recibe un GraphicsContainer para el bloque de información.Each time you call the BeginContainer method, an information block is put on the stack, and you receive a GraphicsContainer for the information block. Cuando se pasa uno de esos objetos al método EndContainer, el Graphics se devuelve al estado en el que se encontraba en el momento de la llamada al método BeginContainer que devolvía ese GraphicsContainerdeterminado.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. El bloque de información colocado en la pila mediante el BeginContainer llamada al método se quita de la pila, y todos los bloques de información colocados en esa pila después de ese BeginContainer llamada al método también se quitan.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.

Las llamadas al método Save colocan bloques de información en la misma pila como llamadas al método BeginContainer.Calls to the Save method place information blocks on the same stack as calls to the BeginContainer method. Del mismo modo que una llamada al método EndContainer se empareja con una llamada al método BeginContainer, una llamada al método Restore se empareja con una llamada al método 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.

Cuando se llama al método EndContainer, todos los bloques de información colocados en la pila (por el método Save o por el método BeginContainer) después de que la llamada correspondiente al método BeginContainer se quite de la pila.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. Del mismo modo, cuando se llama al método Restore, todos los bloques de información colocados en la pila (por el método Save o por el método BeginContainer) después de que la llamada correspondiente al método Save se quite de la pila.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.

Este método especifica una transformación de escala para el nuevo contenedor de gráficos con los parámetros dstrect y srcrect.This method specifies a scale transformation for the new graphics container with the dstrect and srcrect parameters. La escala es igual a la transformación que, cuando se aplica a srcrect, da como resultado dstrect.The scale is equal to the transformation that, when applied to srcrect, results in dstrect.

El estado de los gráficos establecido por el método BeginContainer incluye las cualidades de representación del estado predeterminado de los gráficos. los cambios de estado de calidad de representación existentes cuando se llama al método se restablecen a los valores predeterminados.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)

Guarda un contenedor de gráficos con el estado actual de este Graphics y abre y usa un nuevo contenedor de gráficos con la transformación de escala especificada.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

Parámetros

dstrect
RectangleF

Estructura RectangleF que, junto con el parámetro srcrect, especifica una transformación de escala para el nuevo contenedor de gráficos.RectangleF structure that, together with the srcrect parameter, specifies a scale transformation for the new graphics container.

srcrect
RectangleF

Estructura RectangleF que, junto con el parámetro dstrect, especifica una transformación de escala para el nuevo contenedor de gráficos.RectangleF structure that, together with the dstrect parameter, specifies a scale transformation for the new graphics container.

unit
GraphicsUnit

Miembro de la enumeración GraphicsUnit que especifica la unidad de medida para el contenedor.Member of the GraphicsUnit enumeration that specifies the unit of measure for the container.

Devoluciones

Este método devuelve un GraphicsContainer que representa el estado de este Graphics en el momento de la llamada al método.This method returns a GraphicsContainer that represents the state of this Graphics at the time of the method call.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del controlador de eventos 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. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea dos rectángulos para especificar una transformación de escala para el nuevo contenedor.Creates two rectangles to specify a scale transformation for the new container.

  • Abre el nuevo contenedor de gráficos y guarda el contenedor antiguo.Opens the new graphics container and saves the old container.

  • Rellena un rectángulo rojo en el nuevo contenedor (coordenadas escaladas del).Fills a red rectangle in the (scaled coordinates of the) new container.

  • Cierra el nuevo contenedor y restaura el contenedor guardado.Closes the new container and restores the saved container.

  • Rellena un rectángulo verde (en las coordenadas sin escala) del contenedor guardado.Fills a green rectangle (to the unscaled coordinates) of the saved container.

El resultado es un rectángulo verde que se basa en un rectángulo rojo más pequeño.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

Comentarios

Use este método con el método EndContainer para crear contenedores de gráficos anidados.Use this method with the EndContainer method to create nested graphics containers. Los contenedores de gráficos conservan el estado de los gráficos, como la transformación, la región de recorte y las propiedades de representación.Graphics containers retain graphics state, such as transformation, clipping region, and rendering properties.

Cuando se llama al método BeginContainer de una Graphics, se coloca en una pila un bloque de información que contiene el estado de la 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. El método BeginContainer devuelve un GraphicsContainer que identifica ese bloque de información.The BeginContainer method returns a GraphicsContainer that identifies that information block. Al pasar el objeto de identificación al método EndContainer, el bloque de información se quita de la pila y se usa para restaurar el Graphics al estado en el que se encontraba en el momento de la llamada al método 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.

Los contenedores se pueden anidar; es decir, puede llamar al método BeginContainer varias veces antes de llamar al método EndContainer.Containers can be nested; that is, you can call the BeginContainer method several times before you call the EndContainer method. Cada vez que se llama al método BeginContainer, se coloca un bloque de información en la pila y se recibe un GraphicsContainer para el bloque de información.Each time you call the BeginContainer method, an information block is put on the stack, and you receive a GraphicsContainer for the information block. Cuando se pasa uno de esos objetos al método EndContainer, el Graphics se devuelve al estado en el que se encontraba en el momento de la llamada al método BeginContainer que devolvía ese GraphicsContainerdeterminado.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. El bloque de información colocado en la pila mediante el BeginContainer llamada al método se quita de la pila, y todos los bloques de información colocados en esa pila después de ese BeginContainer llamada al método también se quitan.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.

Las llamadas al método Save colocan bloques de información en la misma pila como llamadas al método BeginContainer.Calls to the Save method place information blocks on the same stack as calls to the BeginContainer method. Del mismo modo que una llamada al método EndContainer se empareja con una llamada al método BeginContainer, una llamada al método Restore se empareja con una llamada al método 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.

Cuando se llama al método EndContainer, todos los bloques de información colocados en la pila (por el método Save o por el método BeginContainer) después de que la llamada correspondiente al método BeginContainer se quite de la pila.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. Del mismo modo, cuando se llama al método Restore, todos los bloques de información colocados en la pila (por el método Save o por el método BeginContainer) después de que la llamada correspondiente al método Save se quite de la pila.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.

Este método especifica una transformación de escala para el nuevo contenedor de gráficos con los parámetros dstrect y srcrect.This method specifies a scale transformation for the new graphics container with the dstrect and srcrect parameters. La escala es igual a la transformación que, cuando se aplica a srcrect, da como resultado dstrect.The scale is equal to the transformation that, when applied to srcrect, results in dstrect.

El estado de los gráficos establecido por el método BeginContainer incluye las cualidades de representación del estado predeterminado de los gráficos. los cambios de estado de calidad de representación existentes cuando se llama al método se restablecen a los valores predeterminados.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.

Se aplica a