CommonDialog Klasa

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Określa klasę bazową używaną do wyświetlania okien dialogowych na ekranie.

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

Dziedziczenie

Object

MarshalByRefObject

Component

CommonDialog

Pochodne

System.Windows.Forms.ColorDialog

System.Windows.Forms.FileDialog

System.Windows.Forms.FolderBrowserDialog

System.Windows.Forms.FontDialog

System.Windows.Forms.PageSetupDialog

System.Windows.Forms.PrintDialog

Przykłady

Poniższy przykład kodu używa ColorDialog implementacji CommonDialog i ilustruje tworzenie i wyświetlanie okna dialogowego. Ten przykład wymaga, aby metoda została wywołana z poziomu istniejącego formularza, który ma TextBox obiekt i Button umieszczony na nim.

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

Uwagi

Klasy dziedziczone są wymagane do zaimplementowania RunDialog przez wywołanie ShowDialog w celu utworzenia określonego wspólnego okna dialogowego. Dziedziczone klasy mogą opcjonalnie zastąpić HookProc , aby zaimplementować określone funkcje zaczepienia okna dialogowego.

Konstruktory

CommonDialog()

Inicjuje nowe wystąpienie klasy CommonDialog.

Właściwości

CanRaiseEvents	Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component)
Container	Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
DesignMode	Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component)
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component)
Site	Pobiera lub ustawia wartość ISite .Component (Odziedziczone po Component)
Tag	Pobiera lub ustawia obiekt zawierający dane dotyczące kontrolki.

Metody

CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po Component)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetService(Type)	Zwraca obiekt, który reprezentuje usługę dostarczaną przez Component obiekt lub przez element Container. (Odziedziczone po Component)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definiuje typową procedurę podłączania okien dialogowych, która jest zastępowana w celu dodania określonych funkcji do wspólnego okna dialogowego.
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
OnHelpRequest(EventArgs)	HelpRequest Zgłasza zdarzenie.
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definiuje procedurę okna właściciela, która jest zastępowana w celu dodania określonych funkcji do wspólnego okna dialogowego.
Reset()	Po przesłonięciu w klasie pochodnej właściwości wspólnego okna dialogowego są resetowane do ich wartości domyślnych.
RunDialog(IntPtr)	Podczas zastępowania w klasie pochodnej określa wspólne okno dialogowe.
ShowDialog()	Uruchamia typowe okno dialogowe z domyślnym właścicielem.
ShowDialog(IWin32Window)	Uruchamia typowe okno dialogowe z określonym właścicielem.
ToString()	Zwraca wartość String zawierającą nazwę Componentobiektu , jeśli istnieje. Ta metoda nie powinna być zastępowana. (Odziedziczone po Component)

Zdarzenia

Disposed	Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody . (Odziedziczone po Component)
HelpRequest	Występuje, gdy użytkownik klika przycisk Pomoc w typowym oknie dialogowym.