1. Open the design element to which you want to add the button (a page, view, frameset, form, folder, or navigator), or edit a document.

2. Click where you want to add the button and choose Create - Hotspot - Button.

3. On the Button Info tab of the Button Properties box, you can set the following properties:

• Label: Enter the text you want to appear in the button.

If you enter text that is wider than the button and you want it to wrap automatically, check "Wrap label text as needed."
• Width: Specify a value, in inches, for the width of the button.

You can also choose one of the following width options:

Maximum width -- specifies that the value in the Width field is the maximum width for the button. The width may be less if the width of the button text is less.

Minimum width -- specifies that the value in the Width field is at least the width specified. The button may be wider if the button text is wider.

Fixed width -- specifies that the value in the Width field is the actual width of the button. If you checked "Wrap label text as needed," any text wider than the fixed button width wraps automatically. If you have not checked "Wrap label text as needed," any text wider that the fixed button width may disappear.

Fit Content -- sets the width of the button to fit the width of the text you specified in the Label field. If you choose this option, you cannot set the width manually.

• Style: Specify a color for the button background. You can also choose to have a button with square edges or rounded edges.
• Type: Use this setting if you are creating a hotspot button for a template dialog box and you want the button to behave in a certain way (such as closing the dialog box after the button is pressed). You can create the following types of buttons:

  Type of button	Description
  Normal	Normal is the default button. Pressing a normal button performs the button action but does not close the dialog box it is part of.
  OK	When clicked in a template dialog box, this button closes the dialog box with an OK operation and displays a standard Windows OK message. This button is not compatible with IBMR LotusR Domino(TM) Designer Release 5 and earlier.
  Cancel	When clicked in a template dialog box, this button closes the dialog box with a cancel operation and displays a standard Windows Cancel message. This button is not compatible with Lotus Domino Designer Release 5 and earlier.
  Help	This button is active on Macintosh platforms only. When clicked, it displays a help message. This button is not compatible with Lotus Domino Designer Release 5 and earlier.
  Default	Check this box for the hotspot button you want to become the default button for the template dialog box. If the user presses Enter when the focus is not on a button, this is the default button that is pressed instead. Note that a dialog box can have only one default button.

The advantage of using the OK, Cancel, and Help buttons is that you can place the buttons anywhere you want. Previously, these buttons could be aligned only vertically on the right or horizontally on the bottom of the dialog box. In addition, you can associate some LotusScript with these buttons; however, the buttons always close the dialog box despite any code.

If you use the OK or Cancel buttons, the template dialog box must be invoked using @DialogBox with the [NOCANCEL] and [NOOKCANCEL] paramaters.

5. In the Info List, click Objects and select the button you just created.

6. To program the button to run one of the client or one of the Web program code types, choose either Client or Web at the Run pull-down list.

Choose Client when the automated task will run in the IBMR LotusR NotesR client. You can then select one of the following Client code options:
• Simple actions
• Formula
• LotusScript
• JavaScript
• Common JavaScript
Choose Web when the automated task will run in a Web browser. You can then select one of the following Web code options:
• JavaScript
• Common JavaScript

Other button tasks

Button task	Steps to perform
To change properties	Click the button and choose Button - Button Properties.
To change automation	In the Info List, click Objects, select the button in the Objects list and edit the programming tasks in the script area.
To delete	Click the button and choose Edit - Delete.
Call an agent	Use the @Command([RunAgent]) or the OpenAgent URL.

Example
See Also

Adding automation to applications

Glossary