Graphics.Clear(Color) Metode

Definisi

Ruang nama:

System.Drawing

Rakitan:

System.Drawing.Common.dll

Paket:

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

Sumber:

Graphics.cs

Menghapus seluruh permukaan gambar dan mengisinya dengan warna latar belakang yang ditentukan.

public:
 void Clear(System::Drawing::Color color);

public void Clear (System.Drawing.Color color);

member this.Clear : System.Drawing.Color -> unit

Public Sub Clear (color As Color)

Parameter

color

Color

Warna latar belakang permukaan gambar.

Contoh

Contoh kode berikut dirancang untuk digunakan dengan Windows Forms, dan memerlukan PaintEventArgse, yang merupakan parameter penanganan aktivitas Paint. Kode menghapus permukaan gambar Graphics dan mengatur warna latar belakang ke warna teal yang ditentukan sistem.

private:
   void ClearColor( PaintEventArgs^ e )
   {
      // Clear screen with teal background.
      e->Graphics->Clear( Color::Teal );
   }

private void ClearColor(PaintEventArgs e)
{
    // Clear screen with teal background.
    e.Graphics.Clear(Color.Teal);
}

Private Sub ClearColor(ByVal e As PaintEventArgs)

    ' Clear screen with teal background.
    e.Graphics.Clear(Color.Teal)
End Sub

Keterangan

Secara efektif, metode Clear mengisi area dengan kuas warna solid dengan warna yang ditentukan. Transparansi warna yang ditentukan dipertahankan.

Metode ini menghapus status objek grafis dan tidak boleh dipanggil ketika objek grafis tidak dapat diperbarui. Misalnya, jika metode Clear dipanggil pada desktop aman dalam sesi server terminal, ExternalException dapat terjadi, meninggalkan objek Graphics dalam keadaan tidak konsisten.