---
title: "Create form control - Button"
slug: "create-form-control-button"
description: "Learn how to add and configure button controls in forms, including event procedures, properties, and positioning for optimal user interaction."
tags: ["Anywhere Mobility Studio"]
updated: 2026-03-20T12:45:58Z
published: 2026-03-20T17:46:51Z
canonical: "docs.staedean.com/create-form-control-button"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.staedean.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create form control - Button

You can add a control of type **Button** to a form.

For the button, also define the control event procedure. A control event procedure has one or more actions that are done when the button is clicked.

### Steps

1. Click **Mobility design**.
2. Click the **Forms** tab.
3. In the list, find and select the desired record.
4. Click **Edit**.
5. In general, if you add a button control, it is positioned before the selected control on the form.

On the preview, select the desired control.

> [!NOTE]
> **Note**
> 
> If the control list is shown instead of the preview, in the list, find and select the desired control.
6. On the **Properties** tab, click **Add**.
7. Click **Button**.
8. Sub-task: Define control properties.
  1. In the **Control** field, type the control name.

> [!NOTE]
> **Note**
> 
> Only use letters and numbers, no spaces.
  2. You can use a label for the display name of the button.

If you use a label, do not define a Text.

In the **Label** field, enter or select a value.
  3. In the **Text** field, you can enter a free text as display name.

If you use a text, do not define a Label.

In the **Text** field, type a value.
  4. You can define a hotkey for the button.

In the **Hotkeys** field, select an option.
  5. By default, the hotkey is shown on the button.

If you do not want the hotkey to be shown, select **No** in the **Include hotkey in caption** field.
  6. By default, the caption is shown for the button. However, if you use for example a list button, you do not want the caption to be shown.

If you do not want to have the button caption shown, select **No** in the **Show caption** field.
  7. By default, the button is shown on the form.

If you want to hide the button on the form, select **No** in the **Visible** field.
  8. By default, the button can be used on the form.

If the button must be unavailable on the form, select **Yes** in the **Read-only** field.

> [!NOTE]
> **Note**
> 
> If the button is read-only, it appears dimmed.
  9. By default, the next control is positioned on the same line.

If the next control must be positioned on a new line, select **Yes** in the **Append new line** field.
  10. For controls of type **Text box**, the **Required property** can be set to **Yes**. This means, the text box must be filled on validation. By default, no validation is done if the button is clicked.

If the validation must be done when the button is clicked, select **Yes** in the **Validate text box** field
  11. If a data grid or configurable grid is available on the form, a record can be selected in the grid. The values of this record can be copied to the variables as defined for the related columns. By default, when the button is clicked, the values are not copied to the related variables.

If you want the values of the selected record in the grid to be copied to the related variables, select **Yes** in the **Validate grid** field.
  12. In general, if you add a button control, it is positioned before the selected control on the form. You can also position a button at the footer of the form.

If you want to position the button at the footer of the form, select **Yes** in the **Stick to footer** field.

> [!NOTE]
> **Note**
> 
> You can only stick a button to the footer if **Append new line** is set to **Yes**.
9. In the **Documentation** section, write the button control documentation. For example, describe the purpose and characteristics of the button control.
10. To show the added control on the preview, on the **Design** tab, click **Refresh**.

> [!NOTE]
> **Notes**
> 
> - On the preview, you can use a button form control in these ways:
>   - Click the control to show the related properties.
>   - Double-click the control to navigate to another form, as defined for the button.
> - In general, if you add a button control, it is positioned before the selected control on the form. An exception are button controls for which the **Stick to footer property** is set to **Yes**. These are always positioned at the footer of the form.
> - Where the control is exactly positioned on the preview, also depends on:
>   - The Append new line property of the previous control and of the added control.
>   - The preview style sheet.
> - You can use the **Up** and **Down** buttons on the **Properties** tab to move a form control to another position on the form.