Graphics.BeginContainer Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Bunun geçerli durumuyla bir grafik kapsayıcısı Graphics kaydeder ve yeni bir grafik kapsayıcısı açar ve kullanır.
Aşırı Yüklemeler
BeginContainer() |
Bunun geçerli durumuyla bir grafik kapsayıcısı Graphics kaydeder ve yeni bir grafik kapsayıcısı açar ve kullanır. |
BeginContainer(Rectangle, Rectangle, GraphicsUnit) |
Bunun geçerli durumuyla bir grafik kapsayıcısını Graphics kaydeder ve belirtilen ölçek dönüştürmesiyle yeni bir grafik kapsayıcısı açar ve kullanır. |
BeginContainer(RectangleF, RectangleF, GraphicsUnit) |
Bunun geçerli durumuyla bir grafik kapsayıcısını Graphics kaydeder ve belirtilen ölçek dönüştürmesiyle yeni bir grafik kapsayıcısı açar ve kullanır. |
BeginContainer()
- Kaynak:
- Graphics.cs
- Kaynak:
- Graphics.cs
- Kaynak:
- Graphics.cs
Bunun geçerli durumuyla bir grafik kapsayıcısı Graphics 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
Bu yöntem, yöntem çağrısı sırasındaki durumunu Graphics 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 olay işleyicisinin Paint bir parametresi olan gerektirir.PaintEventArgse
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 yöntemiyle EndContainer 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.
yöntemini GraphicsçağırdığınızdaBeginContainer, durumunu tutan Graphics bir bilgi bloğu bir yığına konur. yöntemi, BeginContainer bu bilgi bloğunu tanımlayan bir GraphicsContainer döndürür. Tanımlayıcı nesneyi yöntemine EndContainer geçirdiğinizde, bilgi bloğu yığından kaldırılır ve öğesini yöntem çağrısı sırasındaki BeginContainer durumuna geri yüklemek Graphics için kullanılır.
Kapsayıcılar iç içe yerleştirilebilir; diğer bir ifadeyle BeginContainer , yöntemini çağırmadan önce yöntemini birkaç kez çağırabilirsiniz EndContainer . yöntemini her çağırdığınızda BeginContainer yığına bir bilgi bloğu eklenir ve bilgi bloğu için bir GraphicsContainer alırsınız. Yöntemine EndContainer bu nesnelerden birini geçirdiğinizde, Graphics yöntemi çağrısı sırasında içinde olduğu BeginContainer duruma döndürülür ve bu belirli GraphicsContaineröğesini döndürür. Bu yöntem çağrısı tarafından BeginContainer yığına yerleştirilen bilgi bloğu yığından kaldırılır ve bu yöntem çağrısından sonra BeginContainer bu yığına yerleştirilen tüm bilgi blokları da kaldırılır.
yöntemine yapılan Save çağrılar, yöntem çağrıları ile aynı yığına bilgi blokları BeginContainer yerleştirir. Yöntem çağrısının yöntem BeginContainer çağrısıyla eşlendiği gibiEndContainer, yöntem Restore çağrısı da yöntem Save çağrısıyla eşleştirilir.
yöntemini çağırdığınızda, yönteme EndContainer karşılık gelen çağrıdan BeginContainer sonra yığına yerleştirilen tüm bilgi blokları (Saveyöntemi veya yöntemi tarafındanBeginContainer) yığından kaldırılır. Benzer şekilde, yöntemini çağırdığınızdaRestore, yönteme karşılık gelen çağrıdan Save sonra yığına yerleştirilen tüm bilgi blokları (Saveyöntemi veya BeginContainer yöntemi tarafından) yığından kaldırılır.
yöntemi tarafından BeginContainer oluşturulan grafik durumu, varsayılan grafik durumunun işleme özelliklerini içerir; yöntem çağrıldığında var olan işleme kalitesi durumları varsayılan değerlere sıfırlanır.
Şunlara uygulanır
BeginContainer(Rectangle, Rectangle, GraphicsUnit)
- Kaynak:
- Graphics.cs
- Kaynak:
- Graphics.cs
- Kaynak:
- Graphics.cs
Bunun geçerli durumuyla bir grafik kapsayıcısını Graphics 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
Rectangle yapısı, parametresiyle srcrect
birlikte kapsayıcı için bir ölçek dönüştürmesi belirtir.
- srcrect
- Rectangle
Rectangle yapısı, parametresiyle dstrect
birlikte kapsayıcı için bir ölçek dönüştürmesi belirtir.
- unit
- GraphicsUnit
Kapsayıcı için GraphicsUnit ölçü birimini belirten numaralandırmanın üyesi.
Döndürülenler
Bu yöntem, yöntem çağrısı sırasındaki durumunu Graphics 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 olay işleyicisinin Paint bir parametresi olan gerektirir.PaintEventArgse
Kod aşağıdaki eylemleri gerçekleştirir:
Yeni kapsayıcı için ölçek dönüştürmesi 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 yöntemiyle EndContainer 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.
yöntemini GraphicsçağırdığınızdaBeginContainer, durumunu tutan Graphics bir bilgi bloğu bir yığına konur. yöntemi, BeginContainer bu bilgi bloğunu tanımlayan bir GraphicsContainer döndürür. Tanımlayıcı nesneyi yöntemine EndContainer geçirdiğinizde, bilgi bloğu yığından kaldırılır ve öğesini yöntem çağrısı sırasındaki BeginContainer durumuna geri yüklemek Graphics için kullanılır.
Kapsayıcılar iç içe yerleştirilebilir; diğer bir ifadeyle BeginContainer , yöntemini çağırmadan önce yöntemini birkaç kez çağırabilirsiniz EndContainer . yöntemini her çağırdığınızda BeginContainer yığına bir bilgi bloğu eklenir ve bilgi bloğu için bir GraphicsContainer alırsınız. Yöntemine EndContainer bu nesnelerden birini geçirdiğinizde, Graphics yöntemi çağrısı sırasında içinde olduğu BeginContainer duruma döndürülür ve bu belirli GraphicsContaineröğesini döndürür. Bu yöntem çağrısı tarafından BeginContainer yığına yerleştirilen bilgi bloğu yığından kaldırılır ve bu yöntem çağrısından sonra BeginContainer bu yığına yerleştirilen tüm bilgi blokları da kaldırılır.
yöntemine yapılan Save çağrılar, yöntem çağrıları ile aynı yığına bilgi blokları BeginContainer yerleştirir. Yöntem çağrısının yöntem BeginContainer çağrısıyla eşlendiği gibiEndContainer, yöntem Restore çağrısı da yöntem Save çağrısıyla eşleştirilir.
yöntemini çağırdığınızda, yönteme EndContainer karşılık gelen çağrıdan BeginContainer sonra yığına yerleştirilen tüm bilgi blokları (Saveyöntemi veya yöntemi tarafındanBeginContainer) yığından kaldırılır. Benzer şekilde, yöntemini çağırdığınızdaRestore, yönteme karşılık gelen çağrıdan Save sonra yığına yerleştirilen tüm bilgi blokları (Saveyöntemi veya BeginContainer yöntemi tarafından) yığından kaldırılır.
Bu yöntem, ve srcrect
parametreleriyle yeni grafik kapsayıcısı için bir ölçek dönüştürmesi dstrect
belirtir. Ölçek, öğesine uygulandığında sonucu dstrect
veren dönüştürmeye srcrect
eşittir.
yöntemi tarafından BeginContainer oluşturulan grafik durumu, varsayılan grafik durumunun işleme özelliklerini içerir; yöntem çağrıldığında var olan işleme kalitesi durumları varsayılan değerlere sıfırlanır.
Şunlara uygulanır
BeginContainer(RectangleF, RectangleF, GraphicsUnit)
- Kaynak:
- Graphics.cs
- Kaynak:
- Graphics.cs
- Kaynak:
- Graphics.cs
Bunun geçerli durumuyla bir grafik kapsayıcısını Graphics 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
RectangleF yapısı, parametresiyle srcrect
birlikte yeni grafik kapsayıcısı için bir ölçek dönüştürmesi belirtir.
- srcrect
- RectangleF
RectangleF yapısı, parametresiyle dstrect
birlikte yeni grafik kapsayıcısı için bir ölçek dönüştürmesi belirtir.
- unit
- GraphicsUnit
Kapsayıcı için GraphicsUnit ölçü birimini belirten numaralandırmanın üyesi.
Döndürülenler
Bu yöntem, yöntem çağrısı sırasındaki durumunu Graphics 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 olay işleyicisinin Paint bir parametresi olan gerektirir.PaintEventArgse
Kod aşağıdaki eylemleri gerçekleştirir:
Yeni kapsayıcı için ölçek dönüştürmesi 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 yöntemiyle EndContainer 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.
yöntemini GraphicsçağırdığınızdaBeginContainer, durumunu tutan Graphics bir bilgi bloğu bir yığına konur. yöntemi, BeginContainer bu bilgi bloğunu tanımlayan bir GraphicsContainer döndürür. Tanımlayıcı nesneyi yöntemine EndContainer geçirdiğinizde, bilgi bloğu yığından kaldırılır ve öğesini yöntem çağrısı sırasındaki BeginContainer durumuna geri yüklemek Graphics için kullanılır.
Kapsayıcılar iç içe yerleştirilebilir; diğer bir ifadeyle BeginContainer , yöntemini çağırmadan önce yöntemini birkaç kez çağırabilirsiniz EndContainer . yöntemini her çağırdığınızda BeginContainer yığına bir bilgi bloğu eklenir ve bilgi bloğu için bir GraphicsContainer alırsınız. Yöntemine EndContainer bu nesnelerden birini geçirdiğinizde, Graphics yöntemi çağrısı sırasında içinde olduğu BeginContainer duruma döndürülür ve bu belirli GraphicsContaineröğesini döndürür. Bu yöntem çağrısı tarafından BeginContainer yığına yerleştirilen bilgi bloğu yığından kaldırılır ve bu yöntem çağrısından sonra BeginContainer bu yığına yerleştirilen tüm bilgi blokları da kaldırılır.
yöntemine yapılan Save çağrılar, yöntem çağrıları ile aynı yığına bilgi blokları BeginContainer yerleştirir. Yöntem çağrısının yöntem BeginContainer çağrısıyla eşlendiği gibiEndContainer, yöntem Restore çağrısı da yöntem Save çağrısıyla eşleştirilir.
yöntemini çağırdığınızda, yönteme EndContainer karşılık gelen çağrıdan BeginContainer sonra yığına yerleştirilen tüm bilgi blokları (Save
yöntemi veya yöntemi tarafındanBeginContainer) yığından kaldırılır. Benzer şekilde, yöntemini çağırdığınızdaRestore, yönteme karşılık gelen çağrıdan Save sonra yığına yerleştirilen tüm bilgi blokları (Saveyöntemi veya BeginContainer yöntemi tarafından) yığından kaldırılır.
Bu yöntem, ve srcrect
parametreleriyle yeni grafik kapsayıcısı için bir ölçek dönüştürmesi dstrect
belirtir. Ölçek, öğesine uygulandığında sonucu dstrect
veren dönüştürmeye srcrect
eşittir.
yöntemi tarafından BeginContainer oluşturulan grafik durumu, varsayılan grafik durumunun işleme özelliklerini içerir; yöntem çağrıldığında var olan işleme kalitesi durumları varsayılan değerlere sıfırlanır.
Şunlara uygulanır
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin