Graphics.EndContainer(GraphicsContainer) Metoda

Definicja

Przestrzeń nazw:

System.Drawing

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v8.0.0

Źródło:

Graphics.cs

Zamyka bieżący kontener graficzny i przywraca stan tego Graphics stanu zapisany przez wywołanie BeginContainer() metody .

public:
 void EndContainer(System::Drawing::Drawing2D::GraphicsContainer ^ container);

public void EndContainer (System.Drawing.Drawing2D.GraphicsContainer container);

member this.EndContainer : System.Drawing.Drawing2D.GraphicsContainer -> unit

Public Sub EndContainer (container As GraphicsContainer)

Parametry

container

GraphicsContainer

GraphicsContainer reprezentuje kontener, który jest przywracany przez tę metodę.

Przykłady

Poniższy przykład kodu jest przeznaczony do użycia z Windows Forms i wymaga PaintEventArgseparametru Paint programu obsługi zdarzeń. Kod wykonuje następujące akcje:

• Otwiera nowy kontener graficzny i zapisuje stary kontener.

• Tłumaczy współrzędne świata w kontenerze.

• Wypełnia czerwony prostokąt w (przetłumaczonych współrzędnych) nowego kontenera.

• Zamyka nowy kontener i przywraca zapisany kontener.

• Wypełnia zielony prostokąt (do nieprzetłumaczonych współrzędnych) zapisanego kontenera.

Wynikiem jest zielony prostokąt, który zastępuje czerwony prostokąt o tym samym rozmiarze.

public:
   void EndContainerState( 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 );
   }

public void EndContainerState(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);
}

Public Sub EndContainerState(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

Uwagi

Użyj tej metody z BeginContainer metodą do tworzenia zagnieżdżonych kontenerów graficznych. Kontenery graficzne zachowują stan grafiki, takie jak przekształcanie, region przycinania i właściwości renderowania.

Po wywołaniu BeginContainer metody Graphicsbloku informacji, który przechowuje stan obiektu Graphics , jest umieszczany na stosie. Metoda BeginContainer zwraca element GraphicsContainer identyfikujący ten blok informacyjny. Po przekazaniu obiektu identyfikującego do EndContainer metody blok informacji zostanie usunięty ze stosu i zostanie użyty do przywrócenia Graphics stanu, w którym znajdował się w momencie BeginContainer wywołania metody.

Kontenery można zagnieżdżać; oznacza to, że można wywołać metodę BeginContainer kilka razy przed wywołaniem EndContainer metody. Za każdym razem, gdy wywołujesz metodę BeginContainer , blok informacji jest umieszczany na stosie i otrzymujesz element GraphicsContainer dla bloku informacji. Po przekazaniu jednego z tych obiektów do EndContainer metody Graphics zwracany jest stan, w którym znajdował się w momencie BeginContainer wywołania metody, które zwróciło tę konkretną GraphicsContainermetodę . Blok informacji umieszczony na stosie przez BeginContainer to wywołanie metody jest usuwany ze stosu, a wszystkie bloki informacji umieszczone na tym BeginContainer stosie po wywołaniu metody również zostaną usunięte.

Wywołania metody Save umieszczają bloki informacji na tym samym stosie co wywołania BeginContainer metody . Podobnie jak EndContainer wywołanie metody jest sparowane z BeginContainer wywołaniem metody, Restore wywołanie metody jest sparowane z Save wywołaniem metody.

Po wywołaniu EndContainer metody wszystkie bloki informacji umieszczone na stosie (według Save metody lub BeginContainer metody) po usunięciu odpowiedniego wywołania BeginContainer metody z stosu. Podobnie po wywołaniu Restore metody wszystkie bloki informacji umieszczone na stosie (przy Save użyciu metody lub BeginContainer metody) po usunięciu odpowiedniego wywołania metody z Save stosu.