Adobe 38040334 User Guide - Page 688

DREAMWEAVER CS3 681 User Guide Insert ColdFusion radio buttons You can visually insert a ColdFusion radio button into your form and set its properties. Use radio buttons when you want users to select only one choice from a set of options. Radio buttons are typically used in groups. All radio buttons in a group must have the same name. Note: This enhancement is available only if you have access to a computer running ColdFusion MX 7 or later. 1 Place the insertion point inside the form outline. 2 Select Insert > ColdFusion Objects > CFForm > CFradiobutton. A radio button appears in the ColdFusion form. 3 Select the radio button on the page and set any of the following options in the Property inspector: Cfradiobutton Lets you specify a unique name for the control. Checked Value Lets you specify a value to be returned by the radio button if the user checks it. Initial State Lets you specify whether the radio button is checked when the page first opens in a browser. Validate Specifies the type of validation for the radio button. Validate At Specifies when the radio button is validated: onSubmit, onBlur, or onServer. Label Lets you specify a label for the radio button. Pattern Lets you specify a JavaScript regular expression pattern to validate input. Omit leading and trailing slashes. For more information, see the ColdFusion documentation. Height Lets you specify the height of the control, in pixels. This property is ignored by the ColdFusion server at run time. Width Lets you specify the width of the control, in pixels. This property is ignored by the ColdFusion server at run time. Size Lets you specify the size of the control. This property is ignored by the ColdFusion server at run time. Required Lets you specify whether the radio button must be checked before the form is submitted to the server. Display Tag Editor Lets you edit properties not listed in the Property inspector. 4 To label the radio button, click beside it on the page and enter text for the label. See also "Modify ColdFusion form controls" on page 685 "Validate ColdFusion form data" on page 685 Insert ColdFusion select boxes You can visually insert a ColdFusion select box into your form and set its properties. A select box lets a visitor select one or more items from a list. Select boxes are useful when you have a limited amount of space, but need to display many items. They're also useful when you want to control the values returned to the server. Unlike text fields, where users can type anything they want, including invalid data, with select boxes, you can set the exact values returned by a menu. You can insert two types of select boxes into a form: a menu that "drops down" when the user clicks it, or a menu that displays a scrollable list of items that the user can select. Note: This enhancement is available only if you have access to a computer running ColdFusion MX 7 or later. 1 Place the insertion point inside the form outline. September 4, 2007