Graphics.BeginContainer Méthode

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Enregistre un conteneur graphique avec l’état actuel de cette Graphics et s’ouvre et utilise un nouveau conteneur graphique.

Surcharges

BeginContainer()	Enregistre un conteneur graphique avec l’état actuel de cette Graphics et s’ouvre et utilise un nouveau conteneur graphique.
BeginContainer(Rectangle, Rectangle, GraphicsUnit)	Enregistre un conteneur graphique avec l’état actuel de cette Graphics et s’ouvre et utilise un nouveau conteneur graphique avec la transformation d’échelle spécifiée.
BeginContainer(RectangleF, RectangleF, GraphicsUnit)	Enregistre un conteneur graphique avec l’état actuel de cette Graphics et s’ouvre et utilise un nouveau conteneur graphique avec la transformation d’échelle spécifiée.

BeginContainer()

Enregistre un conteneur graphique avec l’état actuel de cette Graphics et s’ouvre et utilise un nouveau conteneur graphique.

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

Retours

GraphicsContainer

Cette méthode retourne une GraphicsContainer qui représente l’état de cette Graphics au moment de l’appel de méthode.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du gestionnaire d’événements Paint. Le code effectue les actions suivantes :

• Ouvre un nouveau conteneur graphique et enregistre l’ancien conteneur.

• Traduit les coordonnées du monde dans le conteneur.

• Remplit un rectangle rouge dans les nouvelles coordonnées (traduites du nouveau conteneur).

• Ferme le nouveau conteneur et restaure le conteneur enregistré.

• Remplit un rectangle vert (aux coordonnées non converties) du conteneur enregistré.

Le résultat est un rectangle vert qui dépasse un rectangle rouge de la même taille.

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

Remarques

Utilisez cette méthode avec la méthode EndContainer pour créer des conteneurs graphiques imbriqués. Les conteneurs graphiques conservent l’état graphique, comme la transformation, la région de découpage et les propriétés de rendu.

Lorsque vous appelez la méthode BeginContainer d’un Graphics, un bloc d’informations qui contient l’état du Graphics est placé sur une pile. La méthode BeginContainer retourne un GraphicsContainer qui identifie ce bloc d’informations. Lorsque vous passez l’objet d’identification à la méthode EndContainer, le bloc d’informations est supprimé de la pile et est utilisé pour restaurer l'Graphics à l’état dans lequel il était au moment de l’appel de méthode BeginContainer.

Les conteneurs peuvent être imbriqués ; autrement dit, vous pouvez appeler la méthode BeginContainer plusieurs fois avant d’appeler la méthode EndContainer. Chaque fois que vous appelez la méthode BeginContainer, un bloc d’informations est placé sur la pile et vous recevez un GraphicsContainer pour le bloc d’informations. Lorsque vous passez l’un de ces objets à la méthode EndContainer, le Graphics est retourné à l’état dans lequel il était au moment de l’appel de méthode BeginContainer qui a retourné ce GraphicsContainerparticulier. Le bloc d’informations placé sur la pile par ce BeginContainer appel de méthode est supprimé de la pile, et tous les blocs d’informations placés sur cette pile après cet appel de méthode BeginContainer sont également supprimés.

Les appels à la méthode Save placent des blocs d’informations sur la même pile que les appels à la méthode BeginContainer. Tout comme un appel de méthode EndContainer est associé à un appel de méthode BeginContainer, un appel de méthode Restore est associé à un appel de méthode Save.

Lorsque vous appelez la méthode EndContainer, tous les blocs d’informations placés sur la pile (par la méthode Save ou par la méthode BeginContainer) après l’appel correspondant à la méthode BeginContainer sont supprimés de la pile. De même, lorsque vous appelez la méthode Restore, tous les blocs d’informations placés sur la pile (par la méthode Save ou par la méthode BeginContainer) après l’appel correspondant à la méthode Save sont supprimés de la pile.

L’état graphique établi par la méthode BeginContainer inclut les qualités de rendu de l’état graphique par défaut ; tout changement d’état de qualité de rendu existant lorsque la méthode est appelée est réinitialisée aux valeurs par défaut.

BeginContainer(Rectangle, Rectangle, GraphicsUnit)

Enregistre un conteneur graphique avec l’état actuel de cette Graphics et s’ouvre et utilise un nouveau conteneur graphique avec la transformation d’échelle spécifiée.

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

Paramètres

dstrect

Rectangle

Rectangle structure qui, avec le paramètre srcrect, spécifie une transformation d’échelle pour le conteneur.

srcrect

Rectangle

Rectangle structure qui, avec le paramètre dstrect, spécifie une transformation d’échelle pour le conteneur.

unit

GraphicsUnit

Membre de l’énumération GraphicsUnit qui spécifie l’unité de mesure pour le conteneur.

Retours

GraphicsContainer

Cette méthode retourne une GraphicsContainer qui représente l’état de cette Graphics au moment de l’appel de méthode.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du gestionnaire d’événements Paint. Le code effectue les actions suivantes :

• Crée deux rectangles pour spécifier une transformation d’échelle pour le nouveau conteneur.

• Ouvre le nouveau conteneur graphique et enregistre l’ancien conteneur.

• Remplit un rectangle rouge dans les nouvelles coordonnées mises à l’échelle du nouveau conteneur.

• Ferme le nouveau conteneur et restaure le conteneur enregistré.

• Remplit un rectangle vert (aux coordonnées non mise à l’échelle) du conteneur enregistré.

Le résultat est un rectangle vert qui dépasse un rectangle rouge plus petit.

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

Remarques

Utilisez cette méthode avec la méthode EndContainer pour créer des conteneurs graphiques imbriqués. Les conteneurs graphiques conservent l’état graphique, comme la transformation, la région de découpage et les propriétés de rendu.

Lorsque vous appelez la méthode BeginContainer d’un Graphics, un bloc d’informations qui contient l’état du Graphics est placé sur une pile. La méthode BeginContainer retourne un GraphicsContainer qui identifie ce bloc d’informations. Lorsque vous passez l’objet d’identification à la méthode EndContainer, le bloc d’informations est supprimé de la pile et est utilisé pour restaurer l'Graphics à l’état dans lequel il était au moment de l’appel de méthode BeginContainer.

Les conteneurs peuvent être imbriqués ; autrement dit, vous pouvez appeler la méthode BeginContainer plusieurs fois avant d’appeler la méthode EndContainer. Chaque fois que vous appelez la méthode BeginContainer, un bloc d’informations est placé sur la pile et vous recevez un GraphicsContainer pour le bloc d’informations. Lorsque vous passez l’un de ces objets à la méthode EndContainer, le Graphics est retourné à l’état dans lequel il était au moment de l’appel de méthode BeginContainer qui a retourné ce GraphicsContainerparticulier. Le bloc d’informations placé sur la pile par ce BeginContainer appel de méthode est supprimé de la pile, et tous les blocs d’informations placés sur cette pile après cet appel de méthode BeginContainer sont également supprimés.

Les appels à la méthode Save placent des blocs d’informations sur la même pile que les appels à la méthode BeginContainer. Tout comme un appel de méthode EndContainer est associé à un appel de méthode BeginContainer, un appel de méthode Restore est associé à un appel de méthode Save.

Lorsque vous appelez la méthode EndContainer, tous les blocs d’informations placés sur la pile (par la méthode Save ou par la méthode BeginContainer) après l’appel correspondant à la méthode BeginContainer sont supprimés de la pile. De même, lorsque vous appelez la méthode Restore, tous les blocs d’informations placés sur la pile (par la méthode Save ou par la méthode BeginContainer) après l’appel correspondant à la méthode Save sont supprimés de la pile.

Cette méthode spécifie une transformation d’échelle pour le nouveau conteneur graphique avec les paramètres dstrect et srcrect. L’échelle est égale à la transformation qui, lorsqu’elle est appliquée à srcrect, entraîne dstrect.

L’état graphique établi par la méthode BeginContainer inclut les qualités de rendu de l’état graphique par défaut ; tout changement d’état de qualité de rendu existant lorsque la méthode est appelée est réinitialisée aux valeurs par défaut.

BeginContainer(RectangleF, RectangleF, GraphicsUnit)

Enregistre un conteneur graphique avec l’état actuel de cette Graphics et s’ouvre et utilise un nouveau conteneur graphique avec la transformation d’échelle spécifiée.

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

Paramètres

dstrect

RectangleF

RectangleF structure qui, avec le paramètre srcrect, spécifie une transformation d’échelle pour le nouveau conteneur graphique.

srcrect

RectangleF

RectangleF structure qui, avec le paramètre dstrect, spécifie une transformation d’échelle pour le nouveau conteneur graphique.

unit

GraphicsUnit

Membre de l’énumération GraphicsUnit qui spécifie l’unité de mesure pour le conteneur.

Retours

GraphicsContainer

Cette méthode retourne une GraphicsContainer qui représente l’état de cette Graphics au moment de l’appel de méthode.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du gestionnaire d’événements Paint. Le code effectue les actions suivantes :

• Crée deux rectangles pour spécifier une transformation d’échelle pour le nouveau conteneur.

• Ouvre le nouveau conteneur graphique et enregistre l’ancien conteneur.

• Remplit un rectangle rouge dans les nouvelles coordonnées mises à l’échelle du nouveau conteneur.

• Ferme le nouveau conteneur et restaure le conteneur enregistré.

• Remplit un rectangle vert (aux coordonnées non mise à l’échelle) du conteneur enregistré.

Le résultat est un rectangle vert qui dépasse un rectangle rouge plus petit.

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

Remarques

Utilisez cette méthode avec la méthode EndContainer pour créer des conteneurs graphiques imbriqués. Les conteneurs graphiques conservent l’état graphique, comme la transformation, la région de découpage et les propriétés de rendu.

Lorsque vous appelez la méthode BeginContainer d’un Graphics, un bloc d’informations qui contient l’état du Graphics est placé sur une pile. La méthode BeginContainer retourne un GraphicsContainer qui identifie ce bloc d’informations. Lorsque vous passez l’objet d’identification à la méthode EndContainer, le bloc d’informations est supprimé de la pile et est utilisé pour restaurer l'Graphics à l’état dans lequel il était au moment de l’appel de méthode BeginContainer.

Les conteneurs peuvent être imbriqués ; autrement dit, vous pouvez appeler la méthode BeginContainer plusieurs fois avant d’appeler la méthode EndContainer. Chaque fois que vous appelez la méthode BeginContainer, un bloc d’informations est placé sur la pile et vous recevez un GraphicsContainer pour le bloc d’informations. Lorsque vous passez l’un de ces objets à la méthode EndContainer, le Graphics est retourné à l’état dans lequel il était au moment de l’appel de méthode BeginContainer qui a retourné ce GraphicsContainerparticulier. Le bloc d’informations placé sur la pile par ce BeginContainer appel de méthode est supprimé de la pile, et tous les blocs d’informations placés sur cette pile après cet appel de méthode BeginContainer sont également supprimés.

Les appels à la méthode Save placent des blocs d’informations sur la même pile que les appels à la méthode BeginContainer. Tout comme un appel de méthode EndContainer est associé à un appel de méthode BeginContainer, un appel de méthode Restore est associé à un appel de méthode Save.

Lorsque vous appelez la méthode EndContainer, tous les blocs d’informations placés sur la pile (par la méthode Save ou par la méthode BeginContainer) après l’appel correspondant à la méthode BeginContainer sont supprimés de la pile. De même, lorsque vous appelez la méthode Restore, tous les blocs d’informations placés sur la pile (par la méthode Save ou par la méthode BeginContainer) après l’appel correspondant à la méthode Save sont supprimés de la pile.

Cette méthode spécifie une transformation d’échelle pour le nouveau conteneur graphique avec les paramètres dstrect et srcrect. L’échelle est égale à la transformation qui, lorsqu’elle est appliquée à srcrect, entraîne dstrect.

L’état graphique établi par la méthode BeginContainer inclut les qualités de rendu de l’état graphique par défaut ; tout changement d’état de qualité de rendu existant lorsque la méthode est appelée est réinitialisée aux valeurs par défaut.