ColorDialog Kelas

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mewakili kotak dialog umum yang menampilkan warna yang tersedia bersama dengan kontrol yang memungkinkan pengguna menentukan warna kustom.

public ref class ColorDialog : System::Windows::Forms::CommonDialog

public class ColorDialog : System.Windows.Forms.CommonDialog

type ColorDialog = class
    inherit CommonDialog

Public Class ColorDialog
Inherits CommonDialog

Warisan

Object

MarshalByRefObject

Component

CommonDialog

ColorDialog

Contoh

Contoh berikut mengilustrasikan pembuatan baru ColorDialog. Contoh ini mengharuskan metode dipanggil dari dalam bentuk yang ada yang memiliki TextBox dan Button ditempatkan di atasnya.

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      ColorDialog^ MyDialog = gcnew ColorDialog;
      // Keeps the user from selecting a custom color.
      MyDialog->AllowFullOpen = false;
      // Allows the user to get help. (The default is false.)
      MyDialog->ShowHelp = true;
      // Sets the initial color select to the current text color.
      MyDialog->Color = textBox1->ForeColor;
      
      // Update the text box color if the user clicks OK 
      if ( MyDialog->ShowDialog() == ::System::Windows::Forms::DialogResult::OK )
      {
         textBox1->ForeColor = MyDialog->Color;
      }
   }

private void button1_Click(object sender, System.EventArgs e)
 {
    ColorDialog MyDialog = new ColorDialog();
    // Keeps the user from selecting a custom color.
    MyDialog.AllowFullOpen = false ;
    // Allows the user to get help. (The default is false.)
    MyDialog.ShowHelp = true ;
    // Sets the initial color select to the current text color.
    MyDialog.Color = textBox1.ForeColor ;
    
    // Update the text box color if the user clicks OK 
    if (MyDialog.ShowDialog() == DialogResult.OK)
        textBox1.ForeColor =  MyDialog.Color;
 }

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
    Dim MyDialog As New ColorDialog()
    ' Keeps the user from selecting a custom color.
    MyDialog.AllowFullOpen = False
    ' Allows the user to get help. (The default is false.)
    MyDialog.ShowHelp = True
    ' Sets the initial color select to the current text color,
    MyDialog.Color = TextBox1.ForeColor

    ' Update the text box color if the user clicks OK 
    If (MyDialog.ShowDialog() = Windows.Forms.DialogResult.OK) Then
        TextBox1.ForeColor = MyDialog.Color
    End If
End Sub

Keterangan

Anggota yang diwariskan ShowDialog harus dipanggil untuk membuat kotak dialog umum khusus ini. HookProc dapat ditimpa untuk mengimplementasikan fungsionalitas hook kotak dialog tertentu. Gunakan Color untuk mengambil warna yang dipilih oleh pengguna.

Saat Anda membuat instans ColorDialog, beberapa properti baca/tulis diatur ke nilai awal. Untuk daftar nilai-nilai ini, lihat ColorDialog konstruktor.

Konstruktor

ColorDialog()

Menginisialisasi instans baru kelas ColorDialog.

Properti

AllowFullOpen	Mendapatkan atau mengatur nilai yang menunjukkan apakah pengguna dapat menggunakan kotak dialog untuk menentukan warna kustom.
AnyColor	Mendapatkan atau mengatur nilai yang menunjukkan apakah kotak dialog menampilkan semua warna yang tersedia dalam kumpulan warna dasar.
CanRaiseEvents	Mendapatkan nilai yang menunjukkan apakah komponen dapat menaikkan peristiwa. (Diperoleh dari Component)
Color	Mendapatkan atau mengatur warna yang dipilih oleh pengguna.
Container	IContainer Mendapatkan yang berisi Component. (Diperoleh dari Component)
CustomColors	Mendapatkan atau mengatur kumpulan warna kustom yang diperlihatkan dalam kotak dialog.
DesignMode	Mendapatkan nilai yang menunjukkan apakah Component saat ini dalam mode desain. (Diperoleh dari Component)
Events	Mendapatkan daftar penanganan aktivitas yang dilampirkan ke ini Component. (Diperoleh dari Component)
FullOpen	Mendapatkan atau mengatur nilai yang menunjukkan apakah kontrol yang digunakan untuk membuat warna kustom terlihat saat kotak dialog dibuka.
Instance	Mendapatkan handel instans jendela yang mendasar (HINSTANCE).
Options	Mendapatkan nilai untuk menginisialisasi ColorDialog.
ShowHelp	Mendapatkan atau mengatur nilai yang menunjukkan apakah tombol Bantuan muncul dalam kotak dialog warna.
Site	Mendapatkan atau mengatur ISite dari Component. (Diperoleh dari Component)
SolidColorOnly	Mendapatkan atau mengatur nilai yang menunjukkan apakah kotak dialog akan membatasi pengguna untuk memilih warna solid saja.
Tag	Mendapatkan atau mengatur objek yang berisi data tentang kontrol. (Diperoleh dari CommonDialog)

Metode

CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Merilis semua sumber daya yang Componentdigunakan oleh . (Diperoleh dari Component)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang digunakan oleh Component dan secara opsional merilis sumber daya terkelola. (Diperoleh dari Component)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLifetimeService()	Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetService(Type)	Mengembalikan objek yang mewakili layanan yang disediakan oleh Component atau oleh Container. (Diperoleh dari Component)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Menentukan prosedur kait kotak dialog umum yang ditimpa untuk menambahkan fungsionalitas tertentu ke kotak dialog umum. (Diperoleh dari CommonDialog)
InitializeLifetimeService()	Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
OnHelpRequest(EventArgs)	Memunculkan kejadian HelpRequest. (Diperoleh dari CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Menentukan prosedur jendela pemilik yang ditimpa untuk menambahkan fungsionalitas tertentu ke kotak dialog umum. (Diperoleh dari CommonDialog)
Reset()	Mereset semua opsi ke nilai defaultnya, warna terakhir yang dipilih menjadi hitam, dan warna kustom ke nilai defaultnya.
RunDialog(IntPtr)	Saat ditimpa dalam kelas turunan, menentukan kotak dialog umum.
ShowDialog()	Menjalankan kotak dialog umum dengan pemilik default. (Diperoleh dari CommonDialog)
ShowDialog(IWin32Window)	Menjalankan kotak dialog umum dengan pemilik yang ditentukan. (Diperoleh dari CommonDialog)
ToString()	Mengembalikan string yang mewakili ColorDialog.

Acara

Disposed	Terjadi ketika komponen dibuang oleh panggilan ke Dispose() metode . (Diperoleh dari Component)
HelpRequest	Terjadi ketika pengguna mengklik tombol Bantuan pada kotak dialog umum. (Diperoleh dari CommonDialog)

Lihat juga

• CommonDialog