Graphics.EndContainer(GraphicsContainer) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zamyka bieżący kontener graficzny i przywraca stan tego Graphics elementu do stanu zapisanego 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 który 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 PaintEventArgse
parametru 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 nakłada 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
Ta metoda służy do BeginContainer tworzenia zagnieżdżonych kontenerów graficznych. Kontenery grafiki zachowują stan grafiki, takie jak przekształcanie, przycinanie regionu i właściwości renderowania.
Po wywołaniu BeginContainer metody obiektu Graphicsblok informacji, który przechowuje stan obiektu Graphics , jest umieszczany na stosie. Metoda BeginContainer zwraca wartość GraphicsContainer , która identyfikuje ten blok informacji. Po przekazaniu obiektu identyfikującego EndContainer do metody blok informacji jest usuwany ze stosu i jest używany do przywracania Graphics do stanu, w którym znajdował się w momencie BeginContainer wywołania metody.
Kontenery mogą być zagnieżdżone; 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 obiekt jest zwracany do stanu, w którym znajdował się w czasie BeginContainer wywołania metody, które zwróciło ten konkretny GraphicsContainerelement . Blok informacji umieszczony na stosie przez BeginContainer to wywołanie metody jest usuwany ze stosu, a wszystkie bloki informacji umieszczone na tym stosie po wywołaniu BeginContainer metody również zostaną usunięte.
Save Wywołania metody 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 wywołaniem Save metody.
Po wywołaniu EndContainer metody wszystkie bloki informacji umieszczone na stosie (przez Save metodę lub BeginContainer metodę) po usunięciu odpowiedniego wywołania BeginContainer metody z stosu. Podobnie po wywołaniu Restore metody wszystkie bloki informacyjne umieszczone na stosie (za pomocą Save metody lub BeginContainer metody) po usunięciu odpowiedniego wywołania Save metody z stosu.
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla