Graphics.BeginContainer Méthode

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Enregistre un conteneur graphique avec l'état actuel de ce Graphics et ouvre et utilise un nouveau conteneur graphique.

Surcharges

BeginContainer()	Enregistre un conteneur graphique avec l'état actuel de ce Graphics et ouvre et utilise un nouveau conteneur graphique.
BeginContainer(Rectangle, Rectangle, GraphicsUnit)	Enregistre un conteneur graphique avec l'état actuel de ce Graphics et 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 ce Graphics et ouvre et utilise un nouveau conteneur graphique avec la transformation d'échelle spécifiée.

BeginContainer()

Source:

Graphics.cs

Enregistre un conteneur graphique avec l'état actuel de ce Graphics et 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 un GraphicsContainer qui représente l'état de ce Graphics au moment de l'appel de la 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 Paint gestionnaire d’événements. 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 le nouveau conteneur (coordonnées traduites du).

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

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

Le résultat est un rectangle vert qui remplace 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 EndContainer méthode pour créer des conteneurs graphiques imbriqués. Les conteneurs graphiques conservent l’état des graphiques, tels que la transformation, la région de découpage et les propriétés de rendu.

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

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

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

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

L’état graphique établi par la BeginContainer méthode 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é aux valeurs par défaut.

BeginContainer(Rectangle, Rectangle, GraphicsUnit)

Source:

Graphics.cs

Enregistre un conteneur graphique avec l'état actuel de ce Graphics et 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

Structure Rectangle qui, associée au paramètre srcrect, spécifie une transformation d'échelle pour le conteneur.

srcrect

Rectangle

Structure Rectangle qui, associée au 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 du conteneur.

Retours

GraphicsContainer

Cette méthode retourne un GraphicsContainer qui représente l'état de ce Graphics au moment de l'appel de la 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 Paint gestionnaire d’événements. Le code effectue les actions suivantes :

• Crée deux rectangles pour spécifier une transformation de mise à l’échelle pour le nouveau conteneur.

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

• Remplit un rectangle rouge dans le nouveau conteneur (coordonnées mises à l’échelle du).

• 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 superpose 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 EndContainer méthode pour créer des conteneurs graphiques imbriqués. Les conteneurs graphiques conservent l’état des graphiques, tels que la transformation, la région de découpage et les propriétés de rendu.

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

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

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

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

Cette méthode spécifie une transformation de mise à l’échelle pour le nouveau conteneur graphique avec les dstrect paramètres et srcrect . L’échelle est égale à la transformation qui, lorsqu’elle est appliquée à , aboutit à srcrectdstrect.

L’état graphique établi par la BeginContainer méthode 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é aux valeurs par défaut.

BeginContainer(RectangleF, RectangleF, GraphicsUnit)

Source:

Graphics.cs

Enregistre un conteneur graphique avec l'état actuel de ce Graphics et 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

Structure RectangleF qui, associée au paramètre srcrect, spécifie une transformation d'échelle pour le nouveau conteneur graphique.

srcrect

RectangleF

Structure RectangleF qui, associée au 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 du conteneur.

Retours

GraphicsContainer

Cette méthode retourne un GraphicsContainer qui représente l'état de ce Graphics au moment de l'appel de la 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 Paint gestionnaire d’événements. Le code effectue les actions suivantes :

• Crée deux rectangles pour spécifier une transformation de mise à l’échelle pour le nouveau conteneur.

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

• Remplit un rectangle rouge dans le nouveau conteneur (coordonnées mises à l’échelle du).

• 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 superpose 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 EndContainer méthode pour créer des conteneurs graphiques imbriqués. Les conteneurs graphiques conservent l’état des graphiques, tels que la transformation, la région de découpage et les propriétés de rendu.

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

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

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

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

Cette méthode spécifie une transformation de mise à l’échelle pour le nouveau conteneur graphique avec les dstrect paramètres et srcrect . L’échelle est égale à la transformation qui, lorsqu’elle est appliquée à , aboutit à srcrectdstrect.

L’état graphique établi par la BeginContainer méthode 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é aux valeurs par défaut.