CommonDialog Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Ekranda iletişim kutularını görüntülemek için kullanılan temel sınıfı belirtir.

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

Devralma

Object

MarshalByRefObject

Component

CommonDialog

Türetilmiş

System.Windows.Forms.ColorDialog

System.Windows.Forms.FileDialog

System.Windows.Forms.FolderBrowserDialog

System.Windows.Forms.FontDialog

System.Windows.Forms.PageSetupDialog

System.Windows.Forms.PrintDialog

Örnekler

Aşağıdaki kod örneği uygulamasını kullanır ColorDialogCommonDialog ve bir iletişim kutusu oluşturup göstermeyi gösterir. Bu örnek, yönteminin üzerinde ve Button bulunan mevcut bir formun TextBox içinden çağrılmış olmasını gerektirir.

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

Açıklamalar

Devralınan sınıfların belirli bir ortak iletişim kutusu oluşturmak için çağrılarak ShowDialog uygulanması RunDialog gerekir. Devralınan sınıflar isteğe bağlı olarak belirli iletişim kutusu kanca işlevselliğini uygulamak için geçersiz kılabilir HookProc .

Oluşturucular

CommonDialog()

CommonDialog sınıfının yeni bir örneğini başlatır.

Özellikler

CanRaiseEvents	Bileşenin olay oluşturup oluşturamayacağını belirten bir değer alır. (Devralındığı yer: Component)
Container	öğesini IContainer içeren öğesini Componentalır. (Devralındığı yer: Component)
DesignMode	öğesinin şu anda tasarım modunda olup olmadığını Component gösteren bir değer alır. (Devralındığı yer: Component)
Events	Bu Componentöğesine eklenen olay işleyicilerinin listesini alır. (Devralındığı yer: Component)
Site	öğesini alır veya ayarlar ISiteComponent. (Devralındığı yer: Component)
Tag	Denetim hakkındaki verileri içeren bir nesneyi alır veya ayarlar.

Yöntemler

CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
Dispose()	Component tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Component)
Dispose(Boolean)	Component tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır. (Devralındığı yer: Component)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetService(Type)	veya tarafından ComponentContainersağlanan bir hizmeti temsil eden bir nesnesi döndürür. (Devralındığı yer: Component)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Ortak bir iletişim kutusuna belirli işlevler eklemek için geçersiz kılınan ortak iletişim kutusu kanca yordamını tanımlar.
InitializeLifetimeService()	Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
OnHelpRequest(EventArgs)	Olayı tetikler HelpRequest .
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Ortak bir iletişim kutusuna belirli işlevler eklemek için geçersiz kılınan sahip penceresi yordamını tanımlar.
Reset()	Türetilmiş bir sınıfta geçersiz kılındığında, ortak bir iletişim kutusunun özelliklerini varsayılan değerlerine sıfırlar.
RunDialog(IntPtr)	Türetilmiş bir sınıfta geçersiz kılındığında, ortak bir iletişim kutusu belirtir.
ShowDialog()	Varsayılan sahibi olan ortak bir iletişim kutusu çalıştırır.
ShowDialog(IWin32Window)	Belirtilen sahiple ortak bir iletişim kutusu çalıştırır.
ToString()	Varsa, adını Componentiçeren bir String döndürür. Bu yöntem geçersiz kılınmamalıdır. (Devralındığı yer: Component)

Ekinlikler

Disposed	Bileşen yöntemine Dispose() yapılan bir çağrı tarafından atıldığında gerçekleşir. (Devralındığı yer: Component)
HelpRequest	Kullanıcı ortak bir iletişim kutusundaki Yardım düğmesine tıkladığında gerçekleşir.