CommonDialog.ShowDialog Method ()
.NET Framework (current version)
Runs a common dialog box with a default owner.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Return Value
Type: System.Windows.Forms.DialogResultDialogResult.OK if the user clicks OK in the dialog box; otherwise, DialogResult.Cancel.
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
PrintingPermissionUIPermission
to print from a PrintDialog. Associated enumeration: PrintingPermissionLevel.SafePrinting
for safe subwindows to call this method. Associated enumeration: UIPermissionWindow.SafeSubWindows
.NET Framework
Available since 1.1
Available since 1.1
Show: