CommonDialog Osztály

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Megadja a párbeszédpanelek képernyőn való megjelenítéséhez használt alaposztályt.

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

Öröklődés

Object

MarshalByRefObject

Component

CommonDialog

Származtatott

System.Windows.Forms.ColorDialog

System.Windows.Forms.FileDialog

System.Windows.Forms.FolderBrowserDialog

System.Windows.Forms.FontDialog

System.Windows.Forms.PageSetupDialog

System.Windows.Forms.PrintDialog

Példák

Az alábbi példakód egy ColorDialog párbeszédpanel létrehozását és megjelenítését szemlélteti CommonDialog . Ez a példa megköveteli, hogy a metódus egy meglévő űrlapon belülről legyen meghívva, amely rendelkezik egy TextBox és Button rá helyezett formában.

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() = DialogResult.OK) Then
        TextBox1.ForeColor = MyDialog.Color
    End If
End Sub

Megjegyzések

Az örökölt osztályok implementálásához RunDialog egy adott közös párbeszédpanel létrehozásához kell invokálni ShowDialog . Az örökölt osztályok igény szerint felülbírálhatják HookProc a párbeszédpanelek adott horogfunkcióinak implementálásához.

Konstruktorok

Name	Description
CommonDialog()	Inicializálja a CommonDialog osztály új példányát.

Tulajdonságok

Name	Description
CanRaiseEvents	Beolvas egy értéket, amely jelzi, hogy az összetevő képes-e eseményt létrehozni. (Öröklődés forrása Component)
Container	Lekéri a IContainer .Component (Öröklődés forrása Component)
DesignMode	Olyan értéket kap, amely jelzi, hogy az Component aktuálisan tervezési módban van-e. (Öröklődés forrása Component)
Events	Lekéri az ehhez Componentcsatolt eseménykezelők listáját. (Öröklődés forrása Component)
Site	Lekéri vagy megadja a ISite értékét a Component-hez. (Öröklődés forrása Component)
Tag	Lekéri vagy beállít egy objektumot, amely adatokat tartalmaz a vezérlőről.

Metódusok

Name	Description
CreateObjRef(Type)	Létrehoz egy objektumot, amely tartalmazza a távoli objektumokkal való kommunikációhoz használt proxy létrehozásához szükséges összes releváns információt. (Öröklődés forrása MarshalByRefObject)
Dispose()	Felszabadítja a .-hez használt összes erőforrást Component. (Öröklődés forrása Component)
Dispose(Boolean)	Felszabadítja a felügyelt erőforrások által Component használt nem felügyelt erőforrásokat, és opcionálisan felszabadítja a felügyelt erőforrásokat. (Öröklődés forrása Component)
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetLifetimeService()	Lekéri a példány élettartamszabályzatát vezérlő aktuális élettartam-szolgáltatásobjektumot. (Öröklődés forrása MarshalByRefObject)
GetService(Type)	Olyan objektumot ad vissza, amely az általa vagy annak által ComponentContainernyújtott szolgáltatást jelöli. (Öröklődés forrása Component)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Meghatározza a párbeszédpanelek gyakori horog eljárását, amely felül van bírálva, hogy adott funkciókat adjon hozzá egy közös párbeszédpanelhez.
InitializeLifetimeService()	Beolvas egy élettartam-szolgáltatásobjektumot a példány élettartam-szabályzatának szabályozásához. (Öröklődés forrása MarshalByRefObject)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
MemberwiseClone(Boolean)	Az aktuális MarshalByRefObject objektum sekély másolatát hozza létre. (Öröklődés forrása MarshalByRefObject)
OnHelpRequest(EventArgs)	Az eseményt emeli HelpRequest ki.
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Meghatározza azt a tulajdonosi ablak eljárást, amelyet felül kell bírálni, hogy adott funkciókat adjon hozzá egy közös párbeszédpanelhez.
Reset()	Ha egy származtatott osztályban felül van bírálva, egy közös párbeszédpanel tulajdonságait visszaállítja az alapértelmezett értékre.
RunDialog(IntPtr)	Ha felül van bírálva egy származtatott osztályban, egy közös párbeszédpanelt ad meg.
ShowDialog()	Egy általános párbeszédpanelt futtat egy alapértelmezett tulajdonossal.
ShowDialog(IWin32Window)	Futtat egy közös párbeszédpanelt a megadott tulajdonossal.
ToString()	String A ( ha van) nevet tartalmazó értéket Componentad vissza. Ezt a módszert nem szabad felülírni. (Öröklődés forrása Component)

esemény

Name	Description
Disposed	Akkor fordul elő, ha az összetevőt a metódus hívása megsemmisíti Dispose() . (Öröklődés forrása Component)
HelpRequest	Ez akkor fordul elő, ha a felhasználó a Súgó gombra kattint egy közös párbeszédpanelen.