CommonDialog Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Určuje základní třídu, která se používá 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 znázorňuje 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 na něm a Button .

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

Poznámky

Zděděné třídy je nutné implementovat RunDialog vyvoláním ShowDialog vytvoření konkrétního společného dialogového okna. Zděděné třídy můžou volitelně přepsat HookProc , aby implementovaly konkrétní funkce hooku dialogového okna.

Konstruktory

CommonDialog()

Inicializuje novou instanci CommonDialog třídy.

Vlastnosti

CanRaiseEvents	Získá hodnotu označující, zda komponenta může vyvolat událost. (Zděděno od Component)
Container	Získá objekt IContainer , který obsahuje Component. (Zděděno od Component)
DesignMode	Získá hodnotu, která označuje, zda je aktuálně v režimu návrhu Component . (Zděděno od Component)
Events	Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component)
Site	Získá nebo nastaví ISite hodnotu Component. (Zděděno od Component)
Tag	Získá nebo nastaví objekt, který obsahuje data o ovládacím prvku.

Metody

CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy používaného ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané nástrojem Component. (Zděděno od Component)
Dispose(Boolean)	Uvolní nespravované prostředky používané Component nástrojem a volitelně uvolní spravované prostředky. (Zděděno od Component)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou objektem Component nebo jejím Containerobjektem . (Zděděno od Component)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definuje společnou proceduru pro připojení dialogového okna, která je přepsána za účelem přidání konkrétní funkce do běžného dialogového okna.
InitializeLifetimeService()	Získá objekt služby životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
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 běž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.
ToString()	String Vrátí hodnotu obsahující název Component, pokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component)

Událost

Disposed	Nastane, když je komponenta odstraněna voláním Dispose() metody. (Zděděno od Component)
HelpRequest	Nastane, když uživatel klikne na tlačítko Nápověda ve společném dialogovém okně.