How To: Add, Edit, or Delete Controls (C++)

Using the Dialog Editor, you can add, resize, edit, and delete controls in dialog boxes. You can also edit the properties of a control, such as its ID, or whether it's initially visible at run time.

The Dialog Editor tab appears in the Toolbox window when you're working in the Dialog Editor. You can also customize the Toolbox window for easier use. For more information, see Using the Toolbox and Show or hide the Toolbox window.

Add Controls

To add a control

1. Ensure that the dialog box tabbed window is the current document in the editor frame. If a dialog isn't the current document, you won't see the Dialog Editor Tab in the Toolbox.

2. On the Dialog Editor tab of the Toolbox window, select the control you want, then either:

   • Select the dialog box at the location where you want to place the control and the control appears where you've selected.

   • Drag and drop the control from the Toolbox window to the location on your dialog box. You can then move the control around, or change its size and shape.

   • Double-click the control in the Toolbox window and it appears on your dialog box. Reposition the control to the location you prefer.

To add multiple controls

1. While holding down the Ctrl key, select a control in the Toolbox window.

2. Release the Ctrl key and select the dialog box as many times as you want to add the particular control.

3. Press Esc to stop placing controls.

To size a control while you add it

1. Select a control in the Toolbox window.

2. Place your cursor that appears as cross hairs, where you want the upper-left corner of the new control to be on your dialog box.

3. Select and hold down the mouse button to anchor the upper-left corner of your control on the dialog box. Then drag the cursor to the right and down, until the control is the size you want.

   Note

   You can anchor any of the four corners of the control you're drawing. This procedure used the upper-left corner as an example.

4. Release the mouse button. The control settles onto the dialog box in the size you specified.

To add a custom control

You can add custom controls to the dialog box. Select the Custom Control icon in the Toolbox and drag it to your dialog box. To add a Syslink control, add a custom control, then change the control's Class property to Syslink. This action will cause the properties to refresh and show the Syslink control properties. For information on the MFC wrapper class, see CLinkCtrl.

Edit Controls

To edit the properties of a control or controls

1. In the dialog box, select the control you want to modify.

   Note

   If you select multiple controls, only the properties common to the selected controls can be edited.

2. In the Properties window, change the properties of your control.

   Note

   When you set the Bitmap property for a button, radio button, or check box control equal to True, the style BS_BITMAP is implemented for your control. For more information, see Button Styles. For an example of associating a bitmap with a control, see CButton::SetBitmap. Bitmaps will not appear on your control while you are in the Dialog Editor.

To undo changes to the properties of a control

1. Make sure the control has focus in the Dialog Editor.

2. Go to menu Edit > Undo. If focus isn't on the control, the Undo command will be unavailable.

To define a member variable for a (non-button) dialog box control

1. In the Dialog Editor, select a control.

2. While pressing the Ctrl key, double-click the dialog box control.

   The Add Member Variable wizard appears.

3. Type the appropriate information in the Add Member Variable wizard. For more information, see Dialog Data Exchange.

4. Select OK to return to the Dialog Editor.

You can also use the Member Variables tab in the MFC Class Wizard to add new member variables for a specified class, and view already-defined member variables.

Delete Controls

In the dialog box, select the control, then press the Delete key, or go to menu Edit > Delete.

Other Issues

Troubleshooting

After you add a common control or rich edit control to a dialog box, it won't appear when you test the dialog box. Or, the dialog itself won't appear. For example:

1. Create a Win32 project, modifying the application settings so you create a Windows application (not a console app).

2. In Resource View, double-click on the .rc file.

3. Under the dialog option, double-click the About box.

4. Add an IP Address Control to the dialog box.

5. Save and Rebuild all.

6. Execute the program.

7. On the dialog box's Help menu, select the About command and observe no dialog box is displayed.

Currently, the Dialog Editor doesn't automatically add code to your project when you drag and drop the following common controls or rich edit controls onto a dialog box. Nor does Visual Studio provide an error or warning when this problem occurs. To fix, add the code for the control manually.

To use common controls on a dialog box, you need to call InitCommonControlsEx or AFXInitCommonControls before you create the dialog box.

To use RichEdit controls, you must call LoadLibrary. For more information, see About Rich Edit Controls in the Windows SDK and Overview of the Rich Edit Control.

Insert ActiveX controls

Visual Studio enables you to insert ActiveX controls into your dialog box. For more information, see MFC ActiveX Controls and ActiveX Control Containers.

The Insert ActiveX Control dialog box enables you to insert ActiveX controls into your dialog box while using the Dialog Editor. This dialog contains the following properties:

To add an ActiveX control

1. Open a dialog box in the Dialog Editor.

2. Right-click anywhere in the body of the dialog box and select Insert ActiveX Control.

   The Insert ActiveX Control dialog box appears, showing all the ActiveX controls on your system. At the bottom of the dialog box, the path to the ActiveX Control file appears.

3. Select the control you want to add to your dialog box and choose OK.

   The control appears in the dialog box, where you can edit it or create handlers for it just as you would any other control.

To edit properties for an ActiveX control

ActiveX controls supplied by independent vendors may come equipped with their own properties and characteristics. These properties are displayed in the Properties window. Any property pages created by the writers of the ActiveX control are displayed in the Properties Pages dialog box. (To view the Property Page for a specific ActiveX control, select the Property Page button in the Properties window).

• Select the ActiveX control and go to menu View > Property Page to view the properties. Make changes as needed in the property page.

  Various tabs are displayed in the property page for an ActiveX control, depending on the property sheets that come as part of the ActiveX control.

Requirements

Win32

See also

Manage Dialog Box Controls
How To: Layout Controls
How to: Define Control Access and Values