CommonDialog Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Gibt die Basisklasse an, die zum Anzeigen von Dialogfeldern auf dem Bildschirm verwendet wird.

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

Vererbung

Object

MarshalByRefObject

Component

CommonDialog

Abgeleitet

System.Windows.Forms.ColorDialog

System.Windows.Forms.FileDialog

System.Windows.Forms.FolderBrowserDialog

System.Windows.Forms.FontDialog

System.Windows.Forms.PageSetupDialog

System.Windows.Forms.PrintDialog

Beispiele

Das folgende Codebeispiel verwendet die Implementierung und CommonDialog veranschaulicht das ColorDialog Erstellen und Anzeigen eines Dialogfelds. Dieses Beispiel erfordert, dass die Methode innerhalb eines vorhandenen Formulars aufgerufen wird, das über ein TextBox vorhandenes Formular verfügt und Button darauf platziert ist.

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

Hinweise

Geerbte Klassen müssen implementiert RunDialog werden, indem sie zum Erstellen eines bestimmten allgemeinen Dialogfelds aufrufen ShowDialog . Geerbte Klassen können optional außer Kraft gesetzt HookProc werden, um bestimmte Dialogfeld-Hook-Funktionen zu implementieren.

Konstruktoren

Name	Beschreibung
CommonDialog()	Initialisiert eine neue Instanz der CommonDialog-Klasse.

Eigenschaften

Name	Beschreibung
CanRaiseEvents	Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component)
Container	Ruft das, das IContainer die Component. (Geerbt von Component)
DesignMode	Ruft einen Wert ab, der angibt, ob sich der Component Entwurfsmodus derzeit befindet. (Geerbt von Component)
Events	Ruft die Liste der Ereignishandler ab, die an diese Componentangefügt sind. (Geerbt von Component)
Site	Ruft den ISite von Component ab oder legt ihn fest. (Geerbt von Component)
Tag	Dient zum Abrufen oder Festlegen eines Objekts, das Daten zum Steuerelement enthält.

Methoden

Name	Beschreibung
CreateObjRef(Type)	Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird. (Geerbt von MarshalByRefObject)
Dispose()	Veröffentlicht alle ressourcen, die von der Component. (Geerbt von Component)
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die von den Component verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von Component)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetService(Type)	Gibt ein Objekt zurück, das einen Dienst darstellt, der von der Component oder dem zugehörigen ContainerDienst bereitgestellt wird. (Geerbt von Component)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definiert die allgemeine Dialogfeld-Hook-Prozedur, die überschrieben wird, um einem allgemeinen Dialogfeld bestimmte Funktionen hinzuzufügen.
InitializeLifetimeService()	Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject Objekts. (Geerbt von MarshalByRefObject)
OnHelpRequest(EventArgs)	Löst das HelpRequest-Ereignis aus.
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definiert die Besitzerfensterprozedur, die überschrieben wird, um einem allgemeinen Dialogfeld bestimmte Funktionen hinzuzufügen.
Reset()	Wenn sie in einer abgeleiteten Klasse überschrieben werden, werden die Eigenschaften eines allgemeinen Dialogfelds auf ihre Standardwerte zurückgesetzt.
RunDialog(IntPtr)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein allgemeines Dialogfeld angegeben.
ShowDialog()	Führt ein allgemeines Dialogfeld mit einem Standardbesitzer aus.
ShowDialog(IWin32Window)	Führt ein allgemeines Dialogfeld mit dem angegebenen Besitzer aus.
ToString()	Gibt einen String mit dem Namen des Component, falls vorhanden, zurück. Diese Methode sollte nicht außer Kraft gesetzt werden. (Geerbt von Component)

Ereignisse

Name	Beschreibung
Disposed	Tritt auf, wenn die Komponente durch einen Aufruf der Dispose() Methode verworfen wird. (Geerbt von Component)
HelpRequest	Tritt auf, wenn der Benutzer auf die Schaltfläche "Hilfe" in einem allgemeinen Dialogfeld klickt.