Microsoft KB Archive/198271

= OL2000: How to Use Option Buttons on an Outlook Form =

PSS ID Number: 198271

Article Last Modified on 10/8/2003

-

The information in this article applies to:


 * Microsoft Outlook 2000

-



This article was previously published under Q198271





SUMMARY
This article provides an overview of how you can use the OptionButton controls on a Microsoft Outlook custom form.

NOTE: This article does not apply to using option buttons on Visual Basic for Applications "Userforms."



MORE INFORMATION
Option buttons provide a way for a user to select one of many options on a form. You can see an example of option buttons if you click the File menu and then click Archive. The two option buttons are at the top of the dialog box.

There are multiple steps to make option buttons fully functional on an Outlook form. This article describes how to properly bind option buttons to a field so that the setting is preserved when the form is eventually saved or sent to someone else.

The key points to remember are:


 * All of the option buttons in a set must be bound to the same field. Outlook does this for you automatically when you bind the first option button. If you do not bind the option button to a field, then when you send or save the form, the option buttons may be blank.
 * The field should typically be a Text field, as the example below illustrates. However, you can use other field types that can store multiple values, such as a Number field. Be sure to set the Value of each control to an appropriate value for that particular type of data, such as 0, 1, or 2 for a Number field. Most importantly, do not use a Yes/No, or Boolean, field. These values should be used for check boxes.
 * The Value of each control should be set to whatever value may be set in the Text field. The Caption of the control typically should match the Value.
 * If you are using more than one set of option buttons on a form page, you must either put the option buttons in a Frame control. If you do not want the frame visible on the form, you can clear the Frame control's Caption property and set the SpecialEffect property to 0 - Flat.

Steps to Use Option Buttons on a Mail Message

 * 1) Open a new mail message.
 * 2) On the Tools menu, point to Forms, and then click Design This Form.
 * 3) Click the (P.2) tab of the form.
 * 4) On the Form menu, click Control Toolbox.
 * 5) Drag two OptionButton controls from the Control Toolbox to the form page.
 * 6) Right-click the first option button and on the shortcut menu, click Properties.
 * 7) On the Value tab of the Properties window, click New. Type My Color as the name of the field and then click OK. Note that the field is a Text field. On the Value tab of the Properties window, the Property to use setting should be set to Value. Change the Value setting to Blue.
 * 8) Click the Display tab of the Properties window and change the Caption to Blue. This is what actually appears on the form. Click OK.
 * 9) Right-click the second option button control on the form and on the shortcut menu, click Properties.
 * 10) On the Value tab of the Properties window, notice that control is automatically bound to the same field that was created for the first option button. Change the Value to Red.
 * 11) Click the Display tab of the Properties window, change the Caption to Red and then click OK.
 * 12) Publish the form to the Personal Form Library for testing purposes. To do this, on the Tools menu, point to Forms and then click Publish Form. Set the Look in to Personal Forms Library, type Optionbuttons as the name of the form and then click Publish. When asked whether to enable the Save Form Definition with Item setting, click Yes.
 * 13) Close and do not save changes to the form.

To use the form, follow these steps:
 * 1) On the File menu, point to New and then click Choose Form. Set the Look in setting to Personal Forms Library, select the Optionbuttons form and then click Open.
 * 2) Address the form to yourself.
 * 3) Click the P.2 page of the form, click the Red option button, and then click Send.
 * 4) Open the form in the Inbox, click the P.2 page of the form, and you see that Red is selected. If you enter form design mode and click the All Fields page of the form, you see that the My Color field contains the value Red.

