Graphics.BeginContainer Methode

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

Retouren

Deze methode retourneert een GraphicsContainer die de status hiervan Graphics aangeeft op het moment van de aanroep van de methode.

Voorbeelden

Het volgende codevoorbeeld is ontworpen voor gebruik met Windows Forms en vereist PaintEventArgse, een parameter van de Paint gebeurtenis-handler. De code voert de volgende acties uit:

• Hiermee opent u een nieuwe grafische container en slaat u de oude container op.

• Vertaalt de wereldcoördinaten in de container.

• Hiermee vult u een rode rechthoek in de nieuwe container (vertaalde coördinaten van de container).

• Hiermee sluit u de nieuwe container en herstelt u de opgeslagen container.

• Vult een groene rechthoek (op de niet-vertaalde coördinaten) van de opgeslagen container.

Het resultaat is een groene rechthoek die een rode rechthoek van dezelfde grootte overschrijft.

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

Opmerkingen

Gebruik deze methode met de EndContainer methode om geneste grafische containers te maken. Grafische containers behouden de grafische status, zoals transformatie, knipregio en renderingeigenschappen.

Wanneer u de BeginContainer methode van een Graphicsaanroept, wordt een informatieblok met de status van de Graphics gegevens op een stapel geplaatst. De BeginContainer methode retourneert een GraphicsContainer die dat informatieblok identificeert. Wanneer u het identificatieobject doorgeeft aan de EndContainer methode, wordt het informatieblok uit de stack verwijderd en gebruikt om de Graphics status te herstellen waarin het object zich bevond op het moment van de BeginContainer methode-aanroep.

Containers kunnen worden genest; Dat wil gezegd, u kunt de BeginContainer methode meerdere keren aanroepen voordat u de EndContainer methode aanroept. Telkens wanneer u de BeginContainer methode aanroept, wordt er een informatieblok op de stapel geplaatst en ontvangt u een GraphicsContainer voor het informatieblok. Wanneer u een van deze objecten doorgeeft aan de EndContainer methode, wordt deze Graphics geretourneerd naar de status waarin deze zich bevond op het moment van de BeginContainer methode-aanroep die dat specifieke object GraphicsContainerheeft geretourneerd. Het informatieblok dat door die BeginContainer methodeaanroep op de stack wordt geplaatst, wordt verwijderd uit de stack en alle informatieblokken die na die methodeaanroep op die BeginContainer stapel worden geplaatst, worden ook verwijderd.

Aanroepen naar de Save methode plaatsen informatieblokken op dezelfde stack als aanroepen naar de BeginContainer methode. Net zoals een EndContainer methodeaanroep wordt gekoppeld aan een BeginContainer methodeaanroep, wordt een Restore methodeaanroep gekoppeld aan een Save methodeaanroep.

Wanneer u de EndContainer methode aanroept, worden alle informatieblokken die op de stack worden geplaatst (door de Save methode of door de BeginContainer methode) na de bijbehorende aanroep van de BeginContainer methode verwijderd uit de stack. Wanneer u de Restore methode aanroept, worden alle informatieblokken die op de stack worden geplaatst (door de Save methode of door de BeginContainer methode) na de bijbehorende aanroep van de Save methode verwijderd uit de stack.

De grafische status die door de BeginContainer methode is ingesteld, bevat de renderingkwaliteitskwaliteit van de standaardafbeeldingsstatus. Elke status van de renderingkwaliteit wordt gewijzigd wanneer de methode wordt aangeroepen, wordt opnieuw ingesteld op de standaardwaarden.

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

Parameters

Retouren

Deze methode retourneert een GraphicsContainer die de status hiervan Graphics aangeeft op het moment van de aanroep van de methode.

Voorbeelden

Het volgende codevoorbeeld is ontworpen voor gebruik met Windows Forms en vereist PaintEventArgse, een parameter van de Paint gebeurtenis-handler. De code voert de volgende acties uit:

• Hiermee maakt u twee rechthoeken om een schaaltransformatie voor de nieuwe container op te geven.

• Hiermee opent u de nieuwe grafische container en slaat u de oude container op.

• Hiermee vult u een rode rechthoek in de nieuwe container (geschaalde coördinaten van de container).

• Hiermee sluit u de nieuwe container en herstelt u de opgeslagen container.

• Vult een groene rechthoek (op de niet-geschaalde coördinaten) van de opgeslagen container.

Het resultaat is een groene rechthoek die een kleinere rode rechthoek overschrijft.

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

Opmerkingen

Gebruik deze methode met de EndContainer methode om geneste grafische containers te maken. Grafische containers behouden de grafische status, zoals transformatie, knipregio en renderingeigenschappen.

Wanneer u de BeginContainer methode van een Graphicsaanroept, wordt een informatieblok met de status van de Graphics gegevens op een stapel geplaatst. De BeginContainer methode retourneert een GraphicsContainer die dat informatieblok identificeert. Wanneer u het identificatieobject doorgeeft aan de EndContainer methode, wordt het informatieblok uit de stack verwijderd en gebruikt om de Graphics status te herstellen waarin het object zich bevond op het moment van de BeginContainer methode-aanroep.

Containers kunnen worden genest; Dat wil gezegd, u kunt de BeginContainer methode meerdere keren aanroepen voordat u de EndContainer methode aanroept. Telkens wanneer u de BeginContainer methode aanroept, wordt er een informatieblok op de stapel geplaatst en ontvangt u een GraphicsContainer voor het informatieblok. Wanneer u een van deze objecten doorgeeft aan de EndContainer methode, wordt deze Graphics geretourneerd naar de status waarin deze zich bevond op het moment van de BeginContainer methode-aanroep die dat specifieke object GraphicsContainerheeft geretourneerd. Het informatieblok dat door die BeginContainer methodeaanroep op de stack wordt geplaatst, wordt verwijderd uit de stack en alle informatieblokken die na die methodeaanroep op die BeginContainer stapel worden geplaatst, worden ook verwijderd.

Aanroepen naar de Save methode plaatsen informatieblokken op dezelfde stack als aanroepen naar de BeginContainer methode. Net zoals een EndContainer methodeaanroep wordt gekoppeld aan een BeginContainer methodeaanroep, wordt een Restore methodeaanroep gekoppeld aan een Save methodeaanroep.

Wanneer u de EndContainer methode aanroept, worden alle informatieblokken die op de stack worden geplaatst (door de Save methode of door de BeginContainer methode) na de bijbehorende aanroep van de BeginContainer methode verwijderd uit de stack. Wanneer u de Restore methode aanroept, worden alle informatieblokken die op de stack worden geplaatst (door de Save methode of door de BeginContainer methode) na de bijbehorende aanroep van de Save methode verwijderd uit de stack.

Met deze methode geeft u een schaaltransformatie op voor de nieuwe grafische container met de dstrect en srcrect parameters. De schaal is gelijk aan de transformatie waarop, wanneer deze wordt toegepast srcrect, resulteert in dstrect.

De grafische status die door de BeginContainer methode is ingesteld, bevat de renderingkwaliteitskwaliteit van de standaardafbeeldingsstatus. Elke status van de renderingkwaliteit wordt gewijzigd wanneer de methode wordt aangeroepen, wordt opnieuw ingesteld op de standaardwaarden.

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

Parameters

Retouren

Deze methode retourneert een GraphicsContainer die de status hiervan Graphics aangeeft op het moment van de aanroep van de methode.

Voorbeelden

Het volgende codevoorbeeld is ontworpen voor gebruik met Windows Forms en vereist PaintEventArgse, een parameter van de Paint gebeurtenis-handler. De code voert de volgende acties uit:

• Hiermee maakt u twee rechthoeken om een schaaltransformatie voor de nieuwe container op te geven.

• Hiermee opent u de nieuwe grafische container en slaat u de oude container op.

• Hiermee vult u een rode rechthoek in de nieuwe container (geschaalde coördinaten van de container).

• Hiermee sluit u de nieuwe container en herstelt u de opgeslagen container.

• Vult een groene rechthoek (op de niet-geschaalde coördinaten) van de opgeslagen container.

Het resultaat is een groene rechthoek die een kleinere rode rechthoek overschrijft.

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

Opmerkingen

Gebruik deze methode met de EndContainer methode om geneste grafische containers te maken. Grafische containers behouden de grafische status, zoals transformatie, knipregio en renderingeigenschappen.

Wanneer u de BeginContainer methode van een Graphicsaanroept, wordt een informatieblok met de status van de Graphics gegevens op een stapel geplaatst. De BeginContainer methode retourneert een GraphicsContainer die dat informatieblok identificeert. Wanneer u het identificatieobject doorgeeft aan de EndContainer methode, wordt het informatieblok uit de stack verwijderd en gebruikt om de Graphics status te herstellen waarin het object zich bevond op het moment van de BeginContainer methode-aanroep.

Containers kunnen worden genest; Dat wil gezegd, u kunt de BeginContainer methode meerdere keren aanroepen voordat u de EndContainer methode aanroept. Telkens wanneer u de BeginContainer methode aanroept, wordt er een informatieblok op de stapel geplaatst en ontvangt u een GraphicsContainer voor het informatieblok. Wanneer u een van deze objecten doorgeeft aan de EndContainer methode, wordt deze Graphics geretourneerd naar de status waarin deze zich bevond op het moment van de BeginContainer methode-aanroep die dat specifieke object GraphicsContainerheeft geretourneerd. Het informatieblok dat door die BeginContainer methodeaanroep op de stack wordt geplaatst, wordt verwijderd uit de stack en alle informatieblokken die na die methodeaanroep op die BeginContainer stapel worden geplaatst, worden ook verwijderd.

Aanroepen naar de Save methode plaatsen informatieblokken op dezelfde stack als aanroepen naar de BeginContainer methode. Net zoals een EndContainer methodeaanroep wordt gekoppeld aan een BeginContainer methodeaanroep, wordt een Restore methodeaanroep gekoppeld aan een Save methodeaanroep.

Wanneer u de EndContainer methode aanroept, worden alle informatieblokken die op de stack worden geplaatst (door de Save methode of door de BeginContainer methode) na de bijbehorende aanroep van de BeginContainer methode verwijderd uit de stack. Wanneer u de Restore methode aanroept, worden alle informatieblokken die op de stack worden geplaatst (door de Save methode of door de BeginContainer methode) na de bijbehorende aanroep van de Save methode verwijderd uit de stack.

Met deze methode geeft u een schaaltransformatie op voor de nieuwe grafische container met de dstrect en srcrect parameters. De schaal is gelijk aan de transformatie waarop, wanneer deze wordt toegepast srcrect, resulteert in dstrect.

De grafische status die door de BeginContainer methode is ingesteld, bevat de renderingkwaliteitskwaliteit van de standaardafbeeldingsstatus. Elke status van de renderingkwaliteit wordt gewijzigd wanneer de methode wordt aangeroepen, wordt opnieuw ingesteld op de standaardwaarden.