CommonDialog.ShowDialog Methode

Definition

Zeigt ein Standarddialogfeld an.Displays a common dialog.

Überlädt

ShowDialog()

Zeigt ein Standarddialogfeld an.Displays a common dialog.

ShowDialog(Window)

Zeigt ein Standarddialogfeld an.Displays a common dialog.

Hinweise

ShowDialogführt Initialisierungs Aufgaben für alle gängigen Dialogfelder aus RunDialog, bevor aufgerufen wird.ShowDialog performs initialization tasks for all common dialogs before calling RunDialog. Da RunDialog ein Besitzer Fenster erfordert, ShowDialog versucht, eines in der folgenden Rangfolge zuzuweisen:Since RunDialog requires an owner window, ShowDialog attempts to assign one in the following order of precedence:

  • Das aktive Fensterder aktuellen Anwendung.The current application's active window.

  • Das Fensterfür die aktuelle Anwendung.The current application's parking window.

  • Ein intern generiertes ausgeblendetes Fenster.An internally generated hidden window.

ShowDialog()

Zeigt ein Standarddialogfeld an.Displays a common dialog.

public:
 virtual Nullable<bool> ShowDialog();
[System.Security.SecurityCritical]
public virtual Nullable<bool> ShowDialog ();
abstract member ShowDialog : unit -> Nullable<bool>
override this.ShowDialog : unit -> Nullable<bool>
Public Overridable Function ShowDialog () As Nullable(Of Boolean)

Gibt zurück

Wenn der Benutzer im angezeigten Dialogfeld auf „OK“ klickt (beispielsweise OpenFileDialog, SaveFileDialog), wird true zurückgegeben. Andernfalls lautet der Wert false.If the user clicks the OK button of the dialog that is displayed (e.g. OpenFileDialog, SaveFileDialog), true is returned; otherwise, false.

Attribute

Hinweise

ShowDialogführt Initialisierungs Aufgaben für alle gängigen Dialogfelder aus RunDialog, bevor aufgerufen wird.ShowDialog performs initialization tasks for all common dialogs before calling RunDialog.

In der aktuellen Implementierung geben die abgeleiteten KlassenOpenFileDialog ( SaveFileDialogund) nur oder true falsezurück.In the current implementation, the derived classes (OpenFileDialog and SaveFileDialog) will only return true or false.

Sicherheit

UIPermission
um diese Methode auszuführen, ohne dass eine Ausnahme ausgelöst wird.to execute this method without raising of an exception. Zugehörige Enumeration:AllWindowsAssociated enumeration: AllWindows

ShowDialog(Window)

Zeigt ein Standarddialogfeld an.Displays a common dialog.

public:
 Nullable<bool> ShowDialog(System::Windows::Window ^ owner);
[System.Security.SecurityCritical]
public Nullable<bool> ShowDialog (System.Windows.Window owner);
member this.ShowDialog : System.Windows.Window -> Nullable<bool>
Public Function ShowDialog (owner As Window) As Nullable(Of Boolean)

Parameter

owner
Window

Handle für das Fenster, das das Dialogfeld besitzt.Handle to the window that owns the dialog.

Gibt zurück

Wenn der Benutzer im angezeigten Dialogfeld auf „OK“ klickt (beispielsweise OpenFileDialog, SaveFileDialog), wird true zurückgegeben. Andernfalls lautet der Wert false.If the user clicks the OK button of the dialog that is displayed (e.g. OpenFileDialog, SaveFileDialog), true is returned; otherwise, false.

Attribute

Hinweise

ShowDialogführt Initialisierungs Aufgaben für alle gängigen Dialogfelder aus RunDialog, bevor aufgerufen wird.ShowDialog performs initialization tasks for all common dialogs before calling RunDialog. Außerdem wird dem Dialogfeld, das letztendlich angezeigt wird, ein Besitzer Fenster zugewiesen, das durch den owner -Parameter angegeben wird.Additionally, the dialog that is eventually shown is assigned an owner window, which is specified by the owner parameter.

In der aktuellen Implementierung geben die abgeleiteten KlassenOpenFileDialog ( SaveFileDialogund) nur oder true falsezurück.In the current implementation, the derived classes (OpenFileDialog and SaveFileDialog) will only return true or false.

Sicherheit

UIPermission
um diese Methode auszuführen, ohne dass eine Ausnahme ausgelöst wird.to execute this method without raising of an exception. Zugehörige Enumeration:AllWindowsAssociated enumeration: AllWindows

Siehe auch

Gilt für: