CommonDialog.ShowDialog Method ()

 

Runs a common dialog box with a default owner.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

Public Function ShowDialog As DialogResult

Return Value

Type: System.Windows.Forms.DialogResult

DialogResult.OK if the user clicks OK in the dialog box; otherwise, DialogResult.Cancel.

This method implements RunDialog.

The following code example uses the ColorDialog implementation of CommonDialog and illustrates creating and showing a dialog box. This example requires that the method is called from within an existing form, which has a TextBox and Button placed on it.

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

PrintingPermission

to print from a PrintDialog. Associated enumeration: PrintingPermissionLevel.SafePrinting

UIPermission

for safe subwindows to call this method. Associated enumeration: UIPermissionWindow.SafeSubWindows

.NET Framework
Available since 1.1
Return to top
Show: