Creating a Button Using a Wizard

You create a button by running the Create Button Wizard from the Page Definition. Each button resides in a region. A region is an area on a page that serves as a container for content. How you create a button depends upon whether the Page Definition is in tree or component view. To learn more, see "About Tree and Component View".

Topics:

Creating a Button in Component View
Creating a Button in Tree View

Creating a Button in Component View

To create a button in Component view:

Navigate to the appropriate Page Definition. See "Accessing the Page Definition".
If necessary, create region. See "Understanding Regions".
Under Buttons, click the Create icon.
Select a region to contain the button and click Next.
Select a position for the button and click Next:
- Create a button in a region position - Select this option to place the button in a region position. A region position is a position defined by a region template.
- Create a button displayed among this region's items - Select this option to display the button within or between page items (for example, to add a button directly to the right of a form field).
If you select Create a button in a region position:
1. For Button Attributes:
  - Button Name - Enter a name for this button. Note that the button name becomes the page request value.
  - Label - Enter a label to be displayed for the button.
  - Button Style - Select HTML Button, Image, or Template Based Button
    
    If the button is an image, you will need to supply an image name. If the button is template controlled, you will need select a template name.
  - Button Template - Define which template controls the display of the button. Button templates are defined on the templates page. You must have at least one button template defined to use button templates. If you wish to no longer use a button template, change the button template to the NULL.
  - Button Attributes - Text entered is added to the HTML element definition. The following example sets the class of a text button:
```
class="myclass"
```
    For buttons based on templates your template will need to include the #BUTTON_ATTRIBUTES# substitution string. You can use this to control tab stops. For example:
```
tabindex="3"
```
  - Click Next.
2. For Display Properties, select a position, sequence, and alignment and click Next.
3. For Action When Clicked:
  - Action - Select the action to be performed when button is clicked.
  - Execute Validations - Select Yes or No. See item Help for more details.
If you select Create a button displayed among this region's items:
1. Button Name - Enter a button name.
2. Sequence - Enter the sequence for this button. The sequence determines the order of evaluation amongst the other items in this region.
3. Show - Select Beginning on New Line or Beginning on New Field. See item Help for more details.
4. Label - Enter a label for this button. This will become the HTML alt tag if the button is an image.
5. Request - Enter a Request value to be associated with this button. When the button is pressed the page will be submitted and the page request will be set to this value.
6. Execute Validations - Select Yes or No. See item Help for more details.
7. Button Style - Specify the button style.
8. Image Name - Enter a optional button image name. The button image should be just the image file name, no prefix. The image prefix will be prepended to the image name. This application currently has an image prefix of "/i/".
9. Image Attributes - Enter button image attributes if you have entered a button image name. The button image attributes are not required however identifying the height and width will allow browsers to paint the page faster. For example:
```
width=16 height=14
```
Click Create Button.

Creating a Button in Tree View

To create a button in Tree view, you select a region and then one of two options:

Create Region Button displays a button in a region position (for example, to add a button directly to the right of a form field).
Create Button displays a button within or between button items (for example, to place a button after a page item.

Creating a Region Button

To create a region button in Tree view:

Navigate to the appropriate Page Definition. See "Accessing the Page Definition".
If necessary, create region. See "Understanding Regions".
Right-click the region to contain the button and select Create Region Button.
For Button Attributes, specify the following:
1. Button Name - Enter a name for this button. Note that the button name becomes the page request value.
2. Label - Enter a label to be displayed for the button.
3. Button Style - Select HTML Button, Image, or Template Based Button
  
  If the button is an image, you will need to supply an image name. If the button is template controlled, you will need select a template name.
4. Button Attributes - Text entered is added to the HTML element definition. The following example sets the class of a text button:
```
class="myclass"
```
  For buttons based on templates your template will need to include the #BUTTON_ATTRIBUTES# substitution string. You can use this to control tab stops. For example:
```
tabindex="3"
```
5. Click Next.
For Display Properties, specify the following:
1. Position - Identifies the button position.
2. Sequence - Specify the sequence for this component. The sequence determines the order of evaluation.
3. Button Style - Select HTML Button, Image, or Template Based Button
  
  If the button is an image, you will need to supply an image name. If the button is template controlled, you will need select a template name.
4. Alignment - Choose the button alignment.
5. Click Next.
For Action When Clicked, specify the following:
1. Action - Select action to be performed when button is clicked.
2. Execute Validations - Select Yes or No. See item Help for more details.
3. Click Next.
For Conditional Display, select a condition type from the list that must be met in order for this component to be rendered processed.
Click Create Button.

Creating a Button Among Region Items

To create a button that displays within or between button items:

Navigate to the appropriate Page Definition. See "Accessing the Page Definition".
If necessary, create a region. See "Understanding Regions".
Click the region to contain the button, right-click and select Create Button.
For the button attributes, specify the following:
1. Button Name - Enter a button name.
2. Sequence - Enter the sequence for this button. The sequence determines the order of evaluation amongst the other items in this region.
3. Show - Select Beginning on New Line or Beginning on New Field. See item Help for more details.
4. Label - Enter a label for this button. This will become the HTML alt tag if the button is an image.
5. Request - Enter a Request value to be associated with this button. When the button is pressed the page will be submitted and the page request will be set to this value.
6. Execute Validations - Select Yes or No. See item Help for more details.
7. Button Style - Specify the button style.
8. Image Name - Enter a optional button image name. The button image should be just the image file name, no prefix. The image prefix will be prepended to the image name. This application currently has an image prefix of "/i/".
9. Image Attributes - Enter button image attributes if you have entered a button image name. The button image attributes are not required however identifying the height and width will allow browsers to paint the page faster. For example:
```
width=16 height=14
```
Click Create Button.