Use SelectBegin to begin select (or deselect) mode. (See Selection.)
SelectBegin may also be entered as SelectBeg[in] or SelBeg[in].
Optional Operands
OPER specifies the operation to be performed. Specify "Sel[ect]" to begin select mode. Specify "Desel[ect]" to begin deselect mode. Specify "Tog[gle]" to begin select or deselect mode based upon whether the starting selection point is currently selected. "Tog[gle]" will begin the opposite state. For example, if the starting selection point IS selected, it will begin deselect mode.
Default: Toggle.
TYPE is the type of selection to be created. Specify one of the following:
LINE specifies that entire lines will be selected.
COLUMN specifies that entire columns will be selected, implying that only a portion of any particular line is selected.
GRID specifies that rectangular areas will be selected.
CHAR specifies that portions of lines or paragraphs will be selected, and that selection occurs in a "stream" format, i.e., forward selection proceeds from the last character in the current line to the first character in the following line.
Default: The current session selection mode, identified by the selection icons on the toolbar.
ROW is provided mostly for support of mouse operations. A mouse selection will result in SelectBegin being invoked with the ROW and/or COL operands specified.
Default: Cursor line number.
COL is provided mostly for support of mouse operations. A mouse selection will result in SelectBegin being invoked with the ROW and/or COL operands specified.
Default: Cursor column.
SelectBegin is typically invoked by the Select command rather than directly. The Select command begins OR ends select (or deselect) mode based upon whether select (or deselect) mode is currently active. Where SelectBegin is invoked directly, it is typically from a procedure.
Return Codes
OK Successful.
Examples
Begin selection (or deselection) mode at the cursor location:
=> selbeg
Begin selection mode at the cursor location:
=> selbeg sel
Begin line deselection mode at the cursor location:
=> selbeg desel,line
Begin grid selection mode at the cursor location:
=> selbeg sel,grid