XMod Pro Documentation

# <AddButton>

The AddButton tag renders as a push-button at run-time. When clicked, the form executes the <SubmitCommand> associated with the <AddForm>.

# Syntax

<AddButton
  AccessKey="_string_"
  BackColor="_color name_|#dddddd"
  BorderColor="_color name_|#dddddd"  
  BorderStyle="**NotSet**|None|Dotted|Dashed|Solid|Double|Groove|Ridge|Inset|Outset"  
  BorderWidth="_size_"  
  CssClass="_string_"  
  Font-Bold="True|**False**"  
  Font-Italic="True|**False**"  
  Font-Names="_string_"  
  Font-Overline="True|**False**"  
  Font-Size="_string_|Smaller|Larger|XX-Small|X-Small|Small|Medium|Large|X-Large|XX-Large"  
  Font-Strikeout="True|**False**"  
  Font-Underline="True|**False**"  
  ForeColor="_color name_|#dddddd"  
  Height="_size_"  
  OnClientClick="_string_"  
  Redirect="_url_"  
  RedirectMethod="**Get**|Post"  
  Style="_string_"  
  TabIndex="_integer_"  
  Text="_string_"  
  ToolTip="_string_"  
  Visible="**True**|False"  
  Width="_size_"
/>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

# Remarks

  • The Add Button should only be used in <AddForm> tags. It's purpose is to initiate the <SubmitCommand> associated with the <AddForm>.

  • AccessKey: In browsers that support it, this property can be set to a character on the keyboard that can be used to set focus to the control. For instance, setting the value to F allows the user to access the control by pressing Alt+F on their keyboard (for Windows machines).

  • BackColor: Color of the background of the control.

  • BorderColor: Color of the border around the control.

  • BorderStyle: Style of the border around the control.

  • BorderWidth: Width of the border around the control, specified in units.

  • CssClass: Name of the Cascading Style Sheets (CSS) class used to style this control.

  • Font Properties: A series of attributes such as font-bold, font-size, etc. that allow you to control how the text in the control is displayed. More

  • ForeColor: Sets the foreground color (typically the color of the text) of the control.

  • Height: Height of the control, specified in units.

  • OnClientClick: Should you wish to perform some action on the client when the control is clicked, add your Javascript function call or script in this attribute. If your script returns false the control will not perform its normal processing. If you return true then the control will perform its normal processing.

  • Redirect: Enables you to redirect the user to an alternative URL after the button is clicked. The redirection occurs after any form processes initiated by the button click completes. Field tokens may be used in the redirect attribute. However, function tokens such as [[Portal:ID]], [[Join()]], [[User:ID]], etc. cannot be used. When field tokens are used, they are URL Encoded. New to version 4.0: You can use a period (.) for the Redirect property's value. The period acts as shortcut to redirect to the current page.

  • RedirectMethod: Determines the HTTP method by which the user is redirected: "Get" or "Post"
    IMPORTANT: When using "Post", the ID that you supply for your form controls determine the name of the field that is posted to the target URL, not the DataField.

  • Style: Same as the HTML style attribute. It allows you to apply CSS styling to the control (e.g. color: red; border: solid 1px black;).

  • TabIndex: Sets the tab index for the control.

  • Text: The caption that will be displayed on the button.

  • ToolTip: In browsers that support it, sets the text to display when the mouse pointer hovers over the control.

  • Visible: Determines if the control is visible (true) or hidden (false).

  • Width: Width of the control in units.

# Example

<AddForm>  
  <SubmitCommand CommandText="INSERT INTO Users(FirstName, LastName) VALUES(@FirstName, @LastName)" />  
  <table>  
    <tr>  
      <td>  
         <label for="txtFirstName" text="First Name" />  
         <textbox id="txtFirstName" datafield="FirstName" datatype="string" />  
       </td>  
    </tr>  
    <tr>  
      <td>  
        <label for="txtLastName" text="Last Name" />  
        <textbox id="txtLastName" datafield="LastName" datatype="_string_" />  
      </td>  
    </tr>  
    <tr>  
      <td colspan="2">  
        <addbutton text="Add"/> <cancelbutton text="Cancel"/>  
      </td>  
    </tr>  
  </table>  
</AddForm>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

← <AddForm>, <EditForm> →