Share via


Step 7: Add Dialog Components to Your Form

To prepare for setting up the Open File dialog box and Color dialog box (to choose a background color), in this step, you add an OpenFileDialog component and a ColorDialog component to your form.

A component is like a control in some ways. You use the Toolbox to add a component to your form, and you set its properties using the Properties window. But unlike a control, adding a component to your form doesn't add a visible item that the user can see on the form. Instead, it provides certain behaviors that you can trigger with code. It's a component that opens an Open File dialog box.

link to videoFor a video version of this topic, see Tutorial 1: Create a Picture Viewer in Visual Basic - Video 3 or Tutorial 1: Create a Picture Viewer in C# - Video 3.

To add dialog components to your form

  1. Go to Windows Forms Designer and open the Dialogs group in the Toolbox.

    Note

    The Dialogs group in the Toolbox has components that open many useful dialog boxes for you, which can be used for opening and saving files, browsing folders, and choosing fonts and colors. You use two dialog components in this project: OpenFileDialog and ColorDialog.

  2. To add a component called openFileDialog1 to your form, double-click OpenFileDialog. To add a component called colorDialog1 to your form, double-click ColorDialog in the Toolbox. (You use that one in the next tutorial step.) You should see a gray box at the bottom of Windows Forms Designer that has an icon for each of the two dialog components that you added, as shown in the following picture.

    Dialog components

    Dialog components

  3. Go to Windows Forms Designer and click the openFileDialog1 icon in the gray box at the bottom of the designer. Set two properties:

    • Set the Filter property to the following (you can copy and paste it): JPEG Files (*.jpg)|*.jpg|PNG Files (*.png)|*.png|BMP Files (*.bmp)|*.bmp|All files (*.*)|*.*

    • Set the Title property to the following: Select a picture file

    Note

    To see an example of the Open File dialog box in a different application, open Notepad or Paint, and on the File menu, click Open. Notice how there's a Files of type drop-down list at the bottom. You just used the Filter property in the OpenFileDialog component to set that up. Also, notice how the Title and Filter properties are bold in the Properties window. The IDE does that to show you any properties that have been changed from their default values.

To continue or review