CommonDialog.ShowDialog Méthode

Définition

Ouvre une boîte de dialogue commune.Displays a common dialog.

Surcharges

ShowDialog()

Ouvre une boîte de dialogue commune.Displays a common dialog.

ShowDialog(Window)

Ouvre une boîte de dialogue commune.Displays a common dialog.

Remarques

ShowDialogeffectue des tâches d’initialisation pour toutes les boîtes de dialogue RunDialogcourantes avant d’appeler.ShowDialog performs initialization tasks for all common dialogs before calling RunDialog. Étant RunDialog donné que requiert une fenêtre ShowDialog propriétaire, tente d’en assigner un dans l’ordre de priorité suivant:Since RunDialog requires an owner window, ShowDialog attempts to assign one in the following order of precedence:

  • Fenêtre activede l’application actuelle.The current application's active window.

  • Fenêtred’attente de l’application actuelle.The current application's parking window.

  • Fenêtre masquée générée en interne.An internally generated hidden window.

ShowDialog()

Ouvre une boîte de dialogue commune.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)

Retours

Si l’utilisateur clique sur le bouton OK de la boîte de dialogue affichée (OpenFileDialog ou SaveFileDialog, par exemple), true est retourné ; sinon, false.If the user clicks the OK button of the dialog that is displayed (e.g. OpenFileDialog, SaveFileDialog), true is returned; otherwise, false.

Attributs

Remarques

ShowDialogeffectue des tâches d’initialisation pour toutes les boîtes de dialogue RunDialogcourantes avant d’appeler.ShowDialog performs initialization tasks for all common dialogs before calling RunDialog.

Dans l’implémentation actuelle, les classes dérivéesOpenFileDialog ( SaveFileDialoget) retournent false true uniquement ou.In the current implementation, the derived classes (OpenFileDialog and SaveFileDialog) will only return true or false.

Sécurité

UIPermission
pour exécuter cette méthode sans lever d’exception.to execute this method without raising of an exception. Énumération associée:AllWindowsAssociated enumeration: AllWindows

ShowDialog(Window)

Ouvre une boîte de dialogue commune.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)

Paramètres

owner
Window

Handle de la fenêtre propriétaire de la boîte de dialogue.Handle to the window that owns the dialog.

Retours

Si l’utilisateur clique sur le bouton OK de la boîte de dialogue affichée (OpenFileDialog ou SaveFileDialog, par exemple), true est retourné ; sinon, false.If the user clicks the OK button of the dialog that is displayed (e.g. OpenFileDialog, SaveFileDialog), true is returned; otherwise, false.

Attributs

Remarques

ShowDialogeffectue des tâches d’initialisation pour toutes les boîtes de dialogue RunDialogcourantes avant d’appeler.ShowDialog performs initialization tasks for all common dialogs before calling RunDialog. En outre, la boîte de dialogue qui s’affiche finalement est assignée à une fenêtre propriétaire, owner qui est spécifiée par le paramètre.Additionally, the dialog that is eventually shown is assigned an owner window, which is specified by the owner parameter.

Dans l’implémentation actuelle, les classes dérivéesOpenFileDialog ( SaveFileDialoget) retournent false true uniquement ou.In the current implementation, the derived classes (OpenFileDialog and SaveFileDialog) will only return true or false.

Sécurité

UIPermission
pour exécuter cette méthode sans lever d’exception.to execute this method without raising of an exception. Énumération associée:AllWindowsAssociated enumeration: AllWindows

Voir aussi

S’applique à