Graphics.BeginContainer Yöntem

Tanım

Ad Alanı:

System.Drawing

Bütünleştirilmiş Kod:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v9.0.0-preview.5.24306.5

Bu Graphics geçerli durumuyla bir grafik kapsayıcısı kaydeder ve yeni bir grafik kapsayıcısı açar ve kullanır.

Aşırı Yüklemeler

BeginContainer()	Bu Graphics geçerli durumuyla bir grafik kapsayıcısı kaydeder ve yeni bir grafik kapsayıcısı açar ve kullanır.
BeginContainer(Rectangle, Rectangle, GraphicsUnit)	Bu Graphics geçerli durumuna sahip bir grafik kapsayıcısını kaydeder ve belirtilen ölçek dönüştürmesiyle yeni bir grafik kapsayıcısı açar ve kullanır.
BeginContainer(RectangleF, RectangleF, GraphicsUnit)	Bu Graphics geçerli durumuna sahip bir grafik kapsayıcısını kaydeder ve belirtilen ölçek dönüştürmesiyle yeni bir grafik kapsayıcısı açar ve kullanır.

BeginContainer()

Kaynak:

Graphics.cs

Bu Graphics geçerli durumuyla bir grafik kapsayıcısı kaydeder ve yeni bir grafik kapsayıcısı açar ve kullanır.

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

Döndürülenler

GraphicsContainer

Bu yöntem, yöntem çağrısı sırasında bu Graphics durumunu temsil eden bir GraphicsContainer döndürür.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

• Yeni bir grafik kapsayıcısı açar ve eski kapsayıcıyı kaydeder.

• Kapsayıcıdaki dünya koordinatlarını çevirir.

• Yeni kapsayıcıda (çevrilmiş koordinatları) kırmızı bir dikdörtgen doldurur.

• Yeni kapsayıcıyı kapatır ve kaydedilen kapsayıcıyı geri yükler.

• Kaydedilen kapsayıcının yeşil bir dikdörtgenini (çevrilmemiş koordinatlara) doldurur.

Sonuç, aynı boyuttaki kırmızı dikdörtgeni aşan yeşil bir dikdörtgendir.

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

Açıklamalar

İç içe grafik kapsayıcıları oluşturmak için EndContainer yöntemiyle bu yöntemi kullanın. Grafik kapsayıcıları dönüştürme, kırpma bölgesi ve işleme özellikleri gibi grafik durumunu korur.

bir GraphicsBeginContainer yöntemini çağırdığınızda, Graphics durumunu tutan bir bilgi bloğu bir yığına konur. BeginContainer yöntemi, bu bilgi bloğunu tanımlayan bir GraphicsContainer döndürür. Tanımlayıcı nesneyi EndContainer yöntemine geçirdiğinizde, bilgi bloğu yığından kaldırılır ve GraphicsBeginContainer yöntem çağrısı sırasında olduğu duruma geri yüklemek için kullanılır.

Kapsayıcılar iç içe olabilir; başka bir ifadeyle, EndContainer yöntemini çağırmadan önce BeginContainer yöntemini birkaç kez çağırabilirsiniz. BeginContainer yöntemini her çağırdığınızda, yığına bir bilgi bloğu eklenir ve bilgi bloğu için bir GraphicsContainer alırsınız. Bu nesnelerden birini EndContainer yöntemine geçirdiğinizde, Graphics ilgili GraphicsContainerdöndüren BeginContainer yöntemi çağrısı sırasında olduğu duruma döndürülür. Bu BeginContainer yöntem çağrısı tarafından yığına yerleştirilen bilgi bloğu yığından kaldırılır ve bu BeginContainer yöntem çağrısından sonra bu yığına yerleştirilen tüm bilgi blokları da kaldırılır.

Save yöntemine yapılan çağrılar, bilgi bloklarını BeginContainer yöntemine yapılan çağrılar ile aynı yığına yerleştirir. EndContainer yöntem çağrısının BeginContainer yöntem çağrısıyla eşlendiği gibi, Restore yöntem çağrısı da Save yöntem çağrısıyla eşleştirilir.

EndContainer yöntemini çağırdığınızda, BeginContainer yöntemine karşılık gelen çağrıdan sonra yığına yerleştirilen tüm bilgi blokları (Save yöntemi veya BeginContainer yöntemi tarafından) yığından kaldırılır. Benzer şekilde, Restore yöntemini çağırdığınızda, Save yöntemine karşılık gelen çağrıdan sonra yığına yerleştirilen tüm bilgi blokları (Save yöntemi veya BeginContainer yöntemi tarafından) yığından kaldırılır.

BeginContainer yöntemi tarafından oluşturulan grafik durumu, varsayılan grafik durumunun işleme niteliklerini içerir; yöntem çağrıldığında var olan tüm işleme kalitesi durum değişiklikleri varsayılan değerlere sıfırlanır.

BeginContainer(Rectangle, Rectangle, GraphicsUnit)

Kaynak:

Graphics.cs

Bu Graphics geçerli durumuna sahip bir grafik kapsayıcısını kaydeder ve belirtilen ölçek dönüştürmesiyle yeni bir grafik kapsayıcısı açar ve kullanır.

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

Parametreler

dstrect

Rectangle

srcrect parametresiyle birlikte kapsayıcı için bir ölçek dönüşümü belirten Rectangle yapısı.

srcrect

Rectangle

dstrect parametresiyle birlikte kapsayıcı için bir ölçek dönüşümü belirten Rectangle yapısı.

unit

GraphicsUnit

Kapsayıcı için ölçü birimini belirten GraphicsUnit numaralandırmasının üyesi.

Döndürülenler

GraphicsContainer

Bu yöntem, yöntem çağrısı sırasında bu Graphics durumunu temsil eden bir GraphicsContainer döndürür.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

• Yeni kapsayıcı için ölçek dönüşümü belirtmek üzere iki dikdörtgen oluşturur.

• Yeni grafik kapsayıcısını açar ve eski kapsayıcıyı kaydeder.

• Yeni kapsayıcıda (ölçeklendirilmiş koordinatları) kırmızı bir dikdörtgen doldurur.

• Yeni kapsayıcıyı kapatır ve kaydedilen kapsayıcıyı geri yükler.

• Kaydedilen kapsayıcının yeşil bir dikdörtgenini (ölçeklendirilmemiş koordinatlara) doldurur.

Sonuç, daha küçük bir kırmızı dikdörtgenin üzerine gelen yeşil bir dikdörtgendir.

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

Açıklamalar

İç içe grafik kapsayıcıları oluşturmak için EndContainer yöntemiyle bu yöntemi kullanın. Grafik kapsayıcıları dönüştürme, kırpma bölgesi ve işleme özellikleri gibi grafik durumunu korur.

bir GraphicsBeginContainer yöntemini çağırdığınızda, Graphics durumunu tutan bir bilgi bloğu bir yığına konur. BeginContainer yöntemi, bu bilgi bloğunu tanımlayan bir GraphicsContainer döndürür. Tanımlayıcı nesneyi EndContainer yöntemine geçirdiğinizde, bilgi bloğu yığından kaldırılır ve GraphicsBeginContainer yöntem çağrısı sırasında olduğu duruma geri yüklemek için kullanılır.

Kapsayıcılar iç içe olabilir; başka bir ifadeyle, EndContainer yöntemini çağırmadan önce BeginContainer yöntemini birkaç kez çağırabilirsiniz. BeginContainer yöntemini her çağırdığınızda, yığına bir bilgi bloğu eklenir ve bilgi bloğu için bir GraphicsContainer alırsınız. Bu nesnelerden birini EndContainer yöntemine geçirdiğinizde, Graphics ilgili GraphicsContainerdöndüren BeginContainer yöntemi çağrısı sırasında olduğu duruma döndürülür. Bu BeginContainer yöntem çağrısı tarafından yığına yerleştirilen bilgi bloğu yığından kaldırılır ve bu BeginContainer yöntem çağrısından sonra bu yığına yerleştirilen tüm bilgi blokları da kaldırılır.

Save yöntemine yapılan çağrılar, bilgi bloklarını BeginContainer yöntemine yapılan çağrılar ile aynı yığına yerleştirir. EndContainer yöntem çağrısının BeginContainer yöntem çağrısıyla eşlendiği gibi, Restore yöntem çağrısı da Save yöntem çağrısıyla eşleştirilir.

EndContainer yöntemini çağırdığınızda, BeginContainer yöntemine karşılık gelen çağrıdan sonra yığına yerleştirilen tüm bilgi blokları (Save yöntemi veya BeginContainer yöntemi tarafından) yığından kaldırılır. Benzer şekilde, Restore yöntemini çağırdığınızda, Save yöntemine karşılık gelen çağrıdan sonra yığına yerleştirilen tüm bilgi blokları (Save yöntemi veya BeginContainer yöntemi tarafından) yığından kaldırılır.

Bu yöntem, dstrect ve srcrect parametreleriyle yeni grafik kapsayıcısı için bir ölçek dönüştürmesi belirtir. Ölçek, srcrectuygulandığında dstrectsonucunu veren dönüştürmeye eşittir.

BeginContainer yöntemi tarafından oluşturulan grafik durumu, varsayılan grafik durumunun işleme niteliklerini içerir; yöntem çağrıldığında var olan tüm işleme kalitesi durum değişiklikleri varsayılan değerlere sıfırlanır.

BeginContainer(RectangleF, RectangleF, GraphicsUnit)

Kaynak:

Graphics.cs

Bu Graphics geçerli durumuna sahip bir grafik kapsayıcısını kaydeder ve belirtilen ölçek dönüştürmesiyle yeni bir grafik kapsayıcısı açar ve kullanır.

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

Parametreler

dstrect

RectangleF

srcrect parametresiyle birlikte yeni grafik kapsayıcısı için bir ölçek dönüşümü belirten RectangleF yapısı.

srcrect

RectangleF

dstrect parametresiyle birlikte yeni grafik kapsayıcısı için bir ölçek dönüşümü belirten RectangleF yapısı.

unit

GraphicsUnit

Kapsayıcı için ölçü birimini belirten GraphicsUnit numaralandırmasının üyesi.

Döndürülenler

GraphicsContainer

Bu yöntem, yöntem çağrısı sırasında bu Graphics durumunu temsil eden bir GraphicsContainer döndürür.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

• Yeni kapsayıcı için ölçek dönüşümü belirtmek üzere iki dikdörtgen oluşturur.

• Yeni grafik kapsayıcısını açar ve eski kapsayıcıyı kaydeder.

• Yeni kapsayıcıda (ölçeklendirilmiş koordinatları) kırmızı bir dikdörtgen doldurur.

• Yeni kapsayıcıyı kapatır ve kaydedilen kapsayıcıyı geri yükler.

• Kaydedilen kapsayıcının yeşil bir dikdörtgenini (ölçeklendirilmemiş koordinatlara) doldurur.

Sonuç, daha küçük bir kırmızı dikdörtgenin üzerine gelen yeşil bir dikdörtgendir.

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

Açıklamalar

İç içe grafik kapsayıcıları oluşturmak için EndContainer yöntemiyle bu yöntemi kullanın. Grafik kapsayıcıları dönüştürme, kırpma bölgesi ve işleme özellikleri gibi grafik durumunu korur.

bir GraphicsBeginContainer yöntemini çağırdığınızda, Graphics durumunu tutan bir bilgi bloğu bir yığına konur. BeginContainer yöntemi, bu bilgi bloğunu tanımlayan bir GraphicsContainer döndürür. Tanımlayıcı nesneyi EndContainer yöntemine geçirdiğinizde, bilgi bloğu yığından kaldırılır ve GraphicsBeginContainer yöntem çağrısı sırasında olduğu duruma geri yüklemek için kullanılır.

Kapsayıcılar iç içe olabilir; başka bir ifadeyle, EndContainer yöntemini çağırmadan önce BeginContainer yöntemini birkaç kez çağırabilirsiniz. BeginContainer yöntemini her çağırdığınızda, yığına bir bilgi bloğu eklenir ve bilgi bloğu için bir GraphicsContainer alırsınız. Bu nesnelerden birini EndContainer yöntemine geçirdiğinizde, Graphics ilgili GraphicsContainerdöndüren BeginContainer yöntemi çağrısı sırasında olduğu duruma döndürülür. Bu BeginContainer yöntem çağrısı tarafından yığına yerleştirilen bilgi bloğu yığından kaldırılır ve bu BeginContainer yöntem çağrısından sonra bu yığına yerleştirilen tüm bilgi blokları da kaldırılır.

Save yöntemine yapılan çağrılar, bilgi bloklarını BeginContainer yöntemine yapılan çağrılar ile aynı yığına yerleştirir. EndContainer yöntem çağrısının BeginContainer yöntem çağrısıyla eşlendiği gibi, Restore yöntem çağrısı da Save yöntem çağrısıyla eşleştirilir.

EndContainer yöntemini çağırdığınızda, BeginContainer yöntemine karşılık gelen çağrıdan sonra yığına yerleştirilen tüm bilgi blokları (Save yöntemi veya BeginContainer yöntemi tarafından) yığından kaldırılır. Benzer şekilde, Restore yöntemini çağırdığınızda, Save yöntemine karşılık gelen çağrıdan sonra yığına yerleştirilen tüm bilgi blokları (Save yöntemi veya BeginContainer yöntemi tarafından) yığından kaldırılır.

Bu yöntem, dstrect ve srcrect parametreleriyle yeni grafik kapsayıcısı için bir ölçek dönüştürmesi belirtir. Ölçek, srcrectuygulandığında dstrectsonucunu veren dönüştürmeye eşittir.

BeginContainer yöntemi tarafından oluşturulan grafik durumu, varsayılan grafik durumunun işleme niteliklerini içerir; yöntem çağrıldığında var olan tüm işleme kalitesi durum değişiklikleri varsayılan değerlere sıfırlanır.