CommonDialog Kelas

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

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.

Menentukan kelas dasar yang digunakan untuk menampilkan kotak dialog pada layar.

public ref class CommonDialog abstract : System::ComponentModel::Component

public abstract class CommonDialog : System.ComponentModel.Component

type CommonDialog = class
    inherit Component

Public MustInherit Class CommonDialog
Inherits Component

Warisan: Object

MarshalByRefObject

Component
CommonDialog

Turunan: System.Windows.Forms.ColorDialog

System.Windows.Forms.FileDialog

System.Windows.Forms.FolderBrowserDialog

System.Windows.Forms.FontDialog

System.Windows.Forms.PageSetupDialog

Lainnya…

Contoh

Contoh kode berikut menggunakan ColorDialog implementasi CommonDialog dan mengilustrasikan pembuatan dan memperlihatkan kotak dialog. 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

Kelas yang diwariskan diperlukan untuk diterapkan RunDialog dengan memanggil ShowDialog untuk membuat kotak dialog umum tertentu. Kelas yang diwariskan dapat secara opsional mengambil alih HookProc untuk mengimplementasikan fungsionalitas hook kotak dialog tertentu.

Konstruktor

CommonDialog()

Menginisialisasi instans baru kelas CommonDialog.

Properti

CanRaiseEvents	Mendapatkan nilai yang menunjukkan apakah komponen dapat menaikkan peristiwa. (Diperoleh dari Component)
Container	IContainer Mendapatkan yang berisi Component. (Diperoleh dari Component)
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)
Site	Mendapatkan atau mengatur ISite dari Component. (Diperoleh dari Component)
Tag	Mendapatkan atau mengatur objek yang berisi data tentang kontrol.

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 Component digunakan oleh 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()	Kedaluwarsa. 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 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.
InitializeLifetimeService()	Kedaluwarsa. Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
OnHelpRequest(EventArgs)	Memunculkan kejadian HelpRequest.
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Menentukan prosedur jendela pemilik yang ditimpa untuk menambahkan fungsionalitas tertentu ke kotak dialog umum.
Reset()	Saat ditimpa di kelas turunan, mengatur ulang properti kotak dialog umum ke nilai defaultnya.
RunDialog(IntPtr)	Saat ditimpa di kelas turunan, menentukan kotak dialog umum.
ShowDialog()	Menjalankan kotak dialog umum dengan pemilik default.
ShowDialog(IWin32Window)	Menjalankan kotak dialog umum dengan pemilik yang ditentukan.
ToString()	Mengembalikan yang String berisi nama Component, jika ada. Metode ini tidak boleh ditimpa. (Diperoleh dari Component)

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.

Berlaku untuk

Share via