CommonDialog Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

CommonDialog.cs

Určuje základní třídu použitou pro zobrazení dialogových oken na obrazovce.

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

Dědičnost

Object

MarshalByRefObject

Component

CommonDialog

Odvozené

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říklady

Následující příklad kódu používá implementaci ColorDialogCommonDialog a ilustruje vytvoření a zobrazení dialogového okna. Tento příklad vyžaduje, aby metoda byla volána z existujícího formuláře, který má TextBox a Button umístil na něj.

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

Poznámky

Zděděné třídy jsou vyžadovány k implementaci RunDialog vyvoláním ShowDialog konkrétního běžného dialogového okna. Zděděné třídy mohou volitelně přepsat HookProc , aby implementovaly konkrétní funkce háku dialogového okna.

Konstruktory

Name	Description
CommonDialog()	Inicializuje novou instanci CommonDialog třídy.

Vlastnosti

Name	Description
Tag	Získá nebo nastaví objekt, který obsahuje data o ovládacím prvku.

Metody

Name	Description
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definuje běžnou proceduru háku dialogového okna, která se přepíše a přidá do společného dialogového okna konkrétní funkce.
OnHelpRequest(EventArgs)	HelpRequest Vyvolá událost.
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definuje proceduru okna vlastníka, která je přepsána pro přidání konkrétní funkce do společného dialogového okna.
Reset()	Při přepsání v odvozené třídě obnoví vlastnosti společného dialogového okna na výchozí hodnoty.
RunDialog(IntPtr)	Při přepsání v odvozené třídě určuje společné dialogové okno.
ShowDialog()	Spustí společné dialogové okno s výchozím vlastníkem.
ShowDialog(IWin32Window)	Spustí společné dialogové okno se zadaným vlastníkem.

Událost

Name	Description
HelpRequest	Nastane, když uživatel klikne na tlačítko Nápověda v běžném dialogovém okně.