> For the complete documentation index, see [llms.txt](https://docs.nedyx.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nedyx.com/nedyx/clearlines-functions/widget-functions/switch.md).

# SWITCH

#### Syntax

**SWITCH**(*widget;* *newEntry; type*)

* *widget* - the menu widget to which the new setting should be applied - ***Value type**: widget*
* *newEntry* - the new entry, to which the menu should be switched - ***Value type**: any (depending on parameter “type”)*
* *type* - the type of the parameter *newEntry* - ***Value type**: constant (optional, default value: position)*\
  Possible values are
  * *<mark style="color:red;">value</mark>* - parameter *newEntry* contains the value of the new entry
  * *<mark style="color:red;">position</mark>* - parameter *newEntry* contains the position of the new entry in the list of menu entries

#### Remarks

1. *position* is 1-based, so if the first entry should be selected, *position* must be 1.
2. If *position* is less than 1 or higher than the number of menu entries, the menu selection does not change.
3. The "On switch" action of the menu widget is executed directly after the function is called.

#### Example

The button switches menu1 to position 1:

<figure><img src="/files/JDBeipMAZPTw3ON50d7K" alt=""><figcaption></figcaption></figure>

Here the button switches menu4 to value "Europe":

<figure><img src="/files/vkliq89adQUS8zFfqMHZ" alt=""><figcaption></figcaption></figure>