Graphics.BeginContainer Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Drawing

Zestaw:: System.Drawing.Common.dll

Zestaw:: System.Drawing.dll

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.

Zapisuje kontener graficzny z bieżącym stanem tego Graphics elementu i otwiera go i używa nowego kontenera graficznego.

Przeciążenia

BeginContainer()	Zapisuje kontener graficzny z bieżącym stanem tego Graphics elementu i otwiera go i używa nowego kontenera graficznego.
BeginContainer(Rectangle, Rectangle, GraphicsUnit)	Zapisuje kontener graficzny z bieżącym stanem tego Graphics elementu i otwiera się i używa nowego kontenera graficznego z określoną transformacją skalowania.
BeginContainer(RectangleF, RectangleF, GraphicsUnit)	Zapisuje kontener graficzny z bieżącym stanem tego Graphics elementu i otwiera się i używa nowego kontenera graficznego z określoną transformacją skalowania.

BeginContainer()

Zapisuje kontener graficzny z bieżącym stanem tego Graphics elementu i otwiera go i używa nowego kontenera graficznego.

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

Zwraca

GraphicsContainer

Ta metoda zwraca wartość reprezentującą GraphicsContainer stan tej Graphics metody w momencie wywołania metody.

Przykłady

Poniższy przykład kodu jest przeznaczony do użycia z Windows Forms i wymaga PaintEventArgs eparametru 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.

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

Uwagi

Użyj tej metody z EndContainer 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 informacji. 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 (według Save metody lub BeginContainer metody) po usunięciu odpowiedniego wywołania metody z Save stosu.

Stan grafiki ustanowiony przez BeginContainer metodę obejmuje cechy renderowania domyślnego stanu grafiki; wszelkie zmiany stanu jakości renderowania istniejące, gdy metoda jest wywoływana, są resetowane do wartości domyślnych.

Dotyczy

BeginContainer(Rectangle, Rectangle, GraphicsUnit)

Zapisuje kontener graficzny z bieżącym stanem tego Graphics elementu i otwiera się i używa nowego kontenera graficznego z określoną transformacją skalowania.

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

Parametry

dstrect: Rectangle

Rectangle struktura, która wraz z parametrem srcrect określa przekształcenie skali dla kontenera.

srcrect: Rectangle

Rectangle struktura, która wraz z parametrem dstrect określa przekształcenie skali dla kontenera.

unit: GraphicsUnit

Element członkowski wyliczenia GraphicsUnit , który określa jednostkę miary dla kontenera.

Zwraca

GraphicsContainer

Ta metoda zwraca wartość reprezentującą GraphicsContainer stan tej Graphics metody w momencie wywołania metody.

Przykłady

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

Tworzy dwa prostokąty, aby określić przekształcenie skali dla nowego kontenera.
Otwiera nowy kontener graficzny i zapisuje stary kontener.
Wypełnia czerwony prostokąt w (skalowanych współrzędnych) nowego kontenera.
Zamyka nowy kontener i przywraca zapisany kontener.
Wypełnia zielony prostokąt (do współrzędnych nieskalowanych) zapisanego kontenera.

Wynikiem jest zielony prostokąt, który zastępuje mniejszy czerwony prostokąt.

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

Uwagi

Ta metoda określa przekształcenie skali dla nowego kontenera graficznego z parametrami dstrect i srcrect . Skala jest równa przekształceniu, które po zastosowaniu do srcrectelementu powoduje wyświetlenie wartości dstrect.

Dotyczy

BeginContainer(RectangleF, RectangleF, GraphicsUnit)

Zapisuje kontener graficzny z bieżącym stanem tego Graphics elementu i otwiera się i używa nowego kontenera graficznego z określoną transformacją skalowania.

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

Parametry

dstrect: RectangleF

RectangleF struktura, która wraz z parametrem srcrect określa przekształcenie skali dla nowego kontenera graficznego.

srcrect: RectangleF

RectangleF struktura, która wraz z parametrem dstrect określa przekształcenie skali dla nowego kontenera graficznego.

unit: GraphicsUnit

Element członkowski wyliczenia GraphicsUnit , który określa jednostkę miary dla kontenera.

Zwraca

GraphicsContainer

Ta metoda zwraca wartość reprezentującą GraphicsContainer stan tej Graphics metody w momencie wywołania metody.

Przykłady

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

Tworzy dwa prostokąty, aby określić przekształcenie skali dla nowego kontenera.
Otwiera nowy kontener graficzny i zapisuje stary kontener.
Wypełnia czerwony prostokąt w (skalowanych współrzędnych) nowego kontenera.
Zamyka nowy kontener i przywraca zapisany kontener.
Wypełnia zielony prostokąt (do współrzędnych nieskalowanych) zapisanego kontenera.

Wynikiem jest zielony prostokąt, który zastępuje mniejszy czerwony prostokąt.

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

Uwagi

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 (według Save metody lub BeginContainer metody) po usunięciu odpowiedniego wywołania metody z Save stosu.

Dotyczy