Graphics.BeginContainer 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.
Zapisuje kontener graficzny z bieżącym stanem tego Graphics obiektu i otwiera go i używa nowego kontenera grafiki.
Przeciążenia
BeginContainer() |
Zapisuje kontener graficzny z bieżącym stanem tego Graphics obiektu i otwiera go i używa nowego kontenera grafiki. |
BeginContainer(Rectangle, Rectangle, GraphicsUnit) |
Zapisuje kontener graficzny z bieżącym stanem tego Graphics obiektu i otwiera go i używa nowego kontenera grafiki z określoną transformacją skalowania. |
BeginContainer(RectangleF, RectangleF, GraphicsUnit) |
Zapisuje kontener graficzny z bieżącym stanem tego Graphics obiektu i otwiera go i używa nowego kontenera grafiki z określoną transformacją skalowania. |
BeginContainer()
- Źródło:
- Graphics.cs
- Źródło:
- Graphics.cs
- Źródło:
- Graphics.cs
Zapisuje kontener graficzny z bieżącym stanem tego Graphics obiektu i otwiera go i używa nowego kontenera grafiki.
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
Ta metoda zwraca GraphicsContainer wartość , która reprezentuje stan tego Graphics w momencie wywołania metody.
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.
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
Ta metoda służy do EndContainer 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.
Stan grafiki ustanowiony przez BeginContainer metodę zawiera cechy renderowania domyślnego stanu grafiki; wszystkie zmiany stanu jakości renderowania istniejące po wywołaniu metody są resetowane do wartości domyślnych.
Dotyczy
BeginContainer(Rectangle, Rectangle, GraphicsUnit)
- Źródło:
- Graphics.cs
- Źródło:
- Graphics.cs
- Źródło:
- Graphics.cs
Zapisuje kontener graficzny z bieżącym stanem tego Graphics obiektu i otwiera go i używa nowego kontenera grafiki 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 GraphicsUnit wyliczenia, który określa jednostkę miary dla kontenera.
Zwraca
Ta metoda zwraca GraphicsContainer wartość , która reprezentuje stan tego Graphics w momencie wywołania metody.
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:
Tworzy dwa prostokąty w celu określenia przekształcenia skalowania 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 nakłada 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 służy do EndContainer 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.
Ta metoda określa przekształcenie skalowania dla nowego kontenera grafiki z parametrami dstrect
i srcrect
. Skala jest równa przekształceniu, które po zastosowaniu do srcrect
elementu powoduje dstrect
zwrócenie wartości .
Stan grafiki ustanowiony przez BeginContainer metodę zawiera cechy renderowania domyślnego stanu grafiki; wszystkie zmiany stanu jakości renderowania istniejące po wywołaniu metody są resetowane do wartości domyślnych.
Dotyczy
BeginContainer(RectangleF, RectangleF, GraphicsUnit)
- Źródło:
- Graphics.cs
- Źródło:
- Graphics.cs
- Źródło:
- Graphics.cs
Zapisuje kontener graficzny z bieżącym stanem tego Graphics obiektu i otwiera go i używa nowego kontenera grafiki 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 grafiki.
- srcrect
- RectangleF
RectangleF struktura, która wraz z parametrem dstrect
określa przekształcenie skali dla nowego kontenera grafiki.
- unit
- GraphicsUnit
Element członkowski GraphicsUnit wyliczenia, który określa jednostkę miary dla kontenera.
Zwraca
Ta metoda zwraca GraphicsContainer wartość , która reprezentuje stan tego Graphics w momencie wywołania metody.
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:
Tworzy dwa prostokąty w celu określenia przekształcenia skalowania 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 nakłada 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
Ta metoda służy do EndContainer 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.
Ta metoda określa przekształcenie skalowania dla nowego kontenera grafiki z parametrami dstrect
i srcrect
. Skala jest równa przekształceniu, które po zastosowaniu do srcrect
elementu powoduje dstrect
zwrócenie wartości .
Stan grafiki ustanowiony przez BeginContainer metodę zawiera cechy renderowania domyślnego stanu grafiki; wszystkie zmiany stanu jakości renderowania istniejące po wywołaniu metody są resetowane do wartości domyślnych.
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