| **Navigation:**  [[introduction.htm|Language Reference]] > 13 - Built-in Functions >====== SELECT (select next control to process) ====== | [[runcode  return program exit code .htm|{{btn_prev_n.gif|Previous page}}]][[introduction.htm|{{btn_home_n.gif|Return to chapter overview}}]][[selected  return control that has received focus .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

{{newc7.jpg|NewC7.jpg}}

**SELECT(** [//control//] [,//position//] [,//endposition//] **)**

{{blk2blue.jpg|blk2blue.jpg}}

| **SELECT** | Sets the next control to receive input focus. |
| //control// | A field number or field equate label of the next control to process. If omitted, the SELECT statement initiates AcceptAll mode. |
| //position// | Specifies a position within the //control// to place the cursor. For an ENTRY or TEXT, SPIN, or COMBO control this is a character position, or a beginning character position for a marked block. For an OPTION structure, this is the selection number within the OPTION. For a LIST control, this is the QUEUE entry number. This parameter can also be specified using property syntax by PROP:Selected or PROP:SelStart. |
| //endposition// | Specifies an ending character position within an ENTRY, TEXT, SPIN, or COMBO //control//. The character position specified by //position// and //endposition// are marked as a block, available for cut and paste operations. This parameter can also be specified using property syntax by PROP:SelEnd. |

**SELECT** overrides the normal TAB key sequence control selection order of an APPLICATION or WINDOW. Its action affects the next ACCEPT statement that executes. The //control// parameter determines which control the ACCEPT loop will process next. If //control// specifies a control which cannot receive focus because a DISABLE or HIDE statement has been issued, focus goes to the next control following it in the window's source code that can receive focus. If //control// specifies a control on a TAB which does not have focus, the TAB is brought to the front before the control receives focus.

**SELECT** with //position// and //endposition// parameters specifies a marked block in the //control// which is available for cut and paste operations. You can use the SELECT statement to force navigation to a specific tab by specifying the TAB control's position number within the sheet as the second parameter: SELECT(?Sheet,TabNumber).

**SELECT** with no parameters initiates AcceptAll mode (also called non-stop mode). This is a field edit mode in which each control in the window is processed in Field Equate sequence by generating EVENT:Accepted for each. This allows data entry validation code to execute for all controls, including those that the user has not touched.

AcceptAll mode terminates when any of the following conditions is met:

·A SELECT(?) statement selects the same control for the user to edit. This code usually indicates the value it contains is invalid and the user must re-enter data.

·The Window{PROP:AcceptAll} property is set to zero (0). This property contains one (1) when AcceptAll mode is active. Assigning values to this property can also be used to initiate and terminate AcceptAll mode.

·A control with the REQ attribute is blank or zero. AcceptAll mode terminates with the control highlighted for user entry, without processing any more fields in the Field Equate key sequence.

When all controls have been processed, PROP:AcceptAll is zero and EVENT:Completed is posted to the window.

**Example:**

**Screen WINDOW,PRE(Scr)**

**        ENTRY(@N3),USE(Ctl:Code)**

**        ENTRY(@S30),USE(Ctl:Name)**

**        LIST,USE(Ctl:Type),From(TypeQue),Drop(5)   **

**        BUTTON('OK'),USE(?OkButton),KEY(EnterKey)**

**        BUTTON('Cancel'),USE(?CanxButton),KEY(EscKey)**

**       END**

** CODE**

** OPEN(Screen)**

** ****SELECT****(?Ctl:Code)                    !Start with Ctl:Code**

** ACCEPT**

**  CASE SELECTED()**

**  OF ?Ctl:Type**

**   GET(TypeQue,Ctl:Type)              !Find type in List**

**   ****SELECT****(?Ctl:Type,POINTER(TypeQue)  !Select list to element**

**  END**

**  CASE ACCEPTED()**

**  OF ?Ctl:Code**

**   IF Ctl:Code > 150                  !If data entered is invalid**

**    BEEP                              !alert the user and**

**   ****SELECT****(?)                         !make them re-enter the data**

**   END**

**  OF ?Ctl:Name**

**   ****SELECT****(?Ctl:Name,1,5)              !Mark first five characters as a block**

**  OF ?OkButton**

**   ****SELECT****                             !Initiate AcceptAll mode**

**  END**

**  IF EVENT() = EVENT:Completed**

**   BREAK                              !AcceptAll mode terminated**

**  END**

** END**

**See Also:**

[[accept  the event processor .htm|ACCEPT]]

[[prop acceptall.htm|PROP:AcceptAll]]