# 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="https://3148043601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL43fiRbeRtPnTjMpbGNO%2Fuploads%2Fgit-blob-a362f44088187233e44915b0e4946529c7c7d51a%2Fgrafik%20(85).png?alt=media" alt=""><figcaption></figcaption></figure>

Here the button switches menu4 to value "Europe":

<figure><img src="https://3148043601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL43fiRbeRtPnTjMpbGNO%2Fuploads%2Fgit-blob-e36364b9dec114040b33d60461153e2ed449c63d%2Fgrafik%20(320).png?alt=media" alt=""><figcaption></figcaption></figure>