Graphics.BeginContainer Metode

Definisi

Ruang nama:: System.Drawing

Rakitan:: System.Drawing.Common.dll

Rakitan:: System.Drawing.dll

Paket:: System.Drawing.Common v11.0.0-rc.1.26425.128

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menyimpan kontainer grafis dengan status saat ini Graphics dan membuka dan menggunakan kontainer grafis baru.

Overload

Nama	Deskripsi
BeginContainer()	Menyimpan kontainer grafis dengan status saat ini Graphics dan membuka dan menggunakan kontainer grafis baru.
BeginContainer(Rectangle, Rectangle, GraphicsUnit)	Menyimpan kontainer grafis dengan status saat ini Graphics dan membuka dan menggunakan kontainer grafis baru dengan transformasi skala yang ditentukan.
BeginContainer(RectangleF, RectangleF, GraphicsUnit)	Menyimpan kontainer grafis dengan status saat ini Graphics dan membuka dan menggunakan kontainer grafis baru dengan transformasi skala yang ditentukan.

BeginContainer()

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Menyimpan kontainer grafis dengan status saat ini Graphics dan membuka dan menggunakan kontainer grafis baru.

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

Mengembalikan

GraphicsContainer

Metode ini mengembalikan GraphicsContainer yang mewakili status ini Graphics pada saat panggilan metode.

Contoh

Contoh kode berikut dirancang untuk digunakan dengan Formulir Windows, dan memerlukan PaintEventArgse, yang merupakan parameter penanganan aktivitas Paint. Kode melakukan tindakan berikut:

Membuka kontainer grafis baru dan menyimpan kontainer lama.
Menerjemahkan koordinat dunia dalam kontainer.
Mengisi persegi panjang merah dalam kontainer baru (koordinat yang diterjemahkan).
Menutup kontainer baru dan memulihkan kontainer yang disimpan.
Mengisi persegi panjang hijau (ke koordinat yang tidak diterjemahkan) dari kontainer yang disimpan.

Hasilnya adalah persegi panjang hijau yang melebihi persegi panjang merah dengan ukuran yang sama.

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

Keterangan

Gunakan metode ini dengan EndContainer metode untuk membuat kontainer grafis berlapis. Kontainer grafis mempertahankan status grafik, seperti transformasi, wilayah kliping, dan properti penyajian.

Ketika Anda memanggil BeginContainer metode Graphics, blok informasi yang menyimpan status Graphics diletakkan pada tumpukan. Metode mengembalikan yang BeginContainer mengidentifikasi blok informasi tersebutGraphicsContainer. Ketika Anda meneruskan objek pengidentifikasi ke EndContainer metode , blok informasi dihapus dari tumpukan dan digunakan untuk memulihkan Graphics ke status pada saat BeginContainer panggilan metode.

Kontainer dapat ditumpuk; artinya, Anda dapat memanggil BeginContainer metode beberapa kali sebelum memanggil EndContainer metode . Setiap kali Anda memanggil BeginContainer metode, blok informasi dimasukkan ke tumpukan, dan Anda menerima GraphicsContainer untuk blok informasi. Ketika Anda meneruskan salah satu objek tersebut EndContainer ke metode , Graphics dikembalikan ke statusnya pada saat BeginContainer panggilan metode yang mengembalikan yang khusus GraphicsContainer. Blok informasi yang BeginContainer ditempatkan pada tumpukan oleh panggilan metode tersebut dihapus dari tumpukan, dan semua blok informasi yang ditempatkan pada tumpukan tersebut setelah panggilan metode tersebut BeginContainer juga dihapus.

Panggilan ke Save blok informasi tempat metode pada tumpukan yang sama dengan panggilan ke BeginContainer metode . Sama seperti EndContainer panggilan metode dipasangkan dengan BeginContainer panggilan metode, Restore panggilan metode dipasangkan dengan Save panggilan metode.

Ketika Anda memanggil EndContainer metode , semua blok informasi yang ditempatkan pada tumpukan (dengan Save metode atau dengan BeginContainer metode ) setelah panggilan yang sesuai ke BeginContainer metode dihapus dari tumpukan. Demikian juga, ketika Anda memanggil Restore metode , semua blok informasi yang ditempatkan pada tumpukan (dengan Save metode atau dengan BeginContainer metode ) setelah panggilan yang sesuai ke Save metode dihapus dari tumpukan.

Status grafis yang ditetapkan oleh BeginContainer metode mencakup kualitas penyajian status grafis default; setiap perubahan status kualitas penyajian yang ada ketika metode dipanggil diatur ulang ke nilai default.

Berlaku untuk

BeginContainer(Rectangle, Rectangle, GraphicsUnit)

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Menyimpan kontainer grafis dengan status saat ini Graphics dan membuka dan menggunakan kontainer grafis baru dengan transformasi skala yang ditentukan.

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

Parameter

dstrect: Rectangle

Rectangle struktur yang, bersama dengan srcrect parameter, menentukan transformasi skala untuk kontainer.

srcrect: Rectangle

Rectangle struktur yang, bersama dengan dstrect parameter, menentukan transformasi skala untuk kontainer.

unit: GraphicsUnit

Anggota GraphicsUnit enumerasi yang menentukan unit pengukuran untuk kontainer.

Mengembalikan

GraphicsContainer

Metode ini mengembalikan GraphicsContainer yang mewakili status ini Graphics pada saat panggilan metode.

Contoh

Contoh kode berikut dirancang untuk digunakan dengan Formulir Windows, dan memerlukan PaintEventArgse, yang merupakan parameter penanganan aktivitas Paint. Kode melakukan tindakan berikut:

Membuat dua persegi panjang untuk menentukan transformasi skala untuk kontainer baru.
Membuka kontainer grafis baru dan menyimpan kontainer lama.
Mengisi persegi panjang merah dalam kontainer baru (koordinat berskala).
Menutup kontainer baru dan memulihkan kontainer yang disimpan.
Mengisi persegi panjang hijau (ke koordinat yang tidak diskalakan) dari kontainer yang disimpan.

Hasilnya adalah persegi panjang hijau yang melebihi persegi panjang merah yang lebih kecil.

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

Keterangan

Gunakan metode ini dengan EndContainer metode untuk membuat kontainer grafis berlapis. Kontainer grafis mempertahankan status grafik, seperti transformasi, wilayah kliping, dan properti penyajian.

Metode ini menentukan transformasi skala untuk kontainer grafis baru dengan dstrect parameter dan srcrect . Skalanya sama dengan transformasi yang, ketika diterapkan ke srcrect, menghasilkan dstrect.

Berlaku untuk

BeginContainer(RectangleF, RectangleF, GraphicsUnit)

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Menyimpan kontainer grafis dengan status saat ini Graphics dan membuka dan menggunakan kontainer grafis baru dengan transformasi skala yang ditentukan.

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

Parameter

dstrect: RectangleF

RectangleF struktur yang, bersama dengan srcrect parameter, menentukan transformasi skala untuk kontainer grafis baru.

srcrect: RectangleF

RectangleF struktur yang, bersama dengan dstrect parameter, menentukan transformasi skala untuk kontainer grafis baru.

unit: GraphicsUnit

Anggota GraphicsUnit enumerasi yang menentukan unit pengukuran untuk kontainer.

Mengembalikan

GraphicsContainer

Metode ini mengembalikan GraphicsContainer yang mewakili status ini Graphics pada saat panggilan metode.

Contoh

Contoh kode berikut dirancang untuk digunakan dengan Formulir Windows, dan memerlukan PaintEventArgse, yang merupakan parameter penanganan aktivitas Paint. Kode melakukan tindakan berikut:

Membuat dua persegi panjang untuk menentukan transformasi skala untuk kontainer baru.
Membuka kontainer grafis baru dan menyimpan kontainer lama.
Mengisi persegi panjang merah dalam kontainer baru (koordinat berskala).
Menutup kontainer baru dan memulihkan kontainer yang disimpan.
Mengisi persegi panjang hijau (ke koordinat yang tidak diskalakan) dari kontainer yang disimpan.

Hasilnya adalah persegi panjang hijau yang melebihi persegi panjang merah yang lebih kecil.

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

Keterangan

Gunakan metode ini dengan EndContainer metode untuk membuat kontainer grafis berlapis. Kontainer grafis mempertahankan status grafik, seperti transformasi, wilayah kliping, dan properti penyajian.

Ketika Anda memanggil EndContainer metode , semua blok informasi yang ditempatkan pada tumpukan (dengan Save metode atau dengan BeginContainer metode ) setelah panggilan yang sesuai ke BeginContainer metode dihapus dari tumpukan. Demikian juga, ketika Anda memanggil Restore metode , semua blok informasi yang ditempatkan pada tumpukan (dengan Save metode atau dengan BeginContainer metode ) setelah panggilan yang sesuai ke Save metode dihapus dari tumpukan.

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?