Purpose
Moves the cursor one column to the left or to the right or at the first or last column.
Class
Type
Method
Syntax
<oBrowser>:SkipToCell(
<symDirection>,
[<symCellMode>],
[<iSelectFlags>],
[<lSkipRecord>],
[<lAutoScroll>],
[<lAutoEdit>]
) Æ lSuccess
Arguments
<symDirection> | The direction in that the cursor on the basis of the current position is to be moved. The following values are supported: |
Value |
Description |
#First |
Moves the cursor at the first column in the current row. |
#Previous |
Moves the cursor at the previous column. |
#Next |
Moves the cursor at the next column. |
#Last |
Moves the cursor at the last column in the current row. |
Data Type: | Symbol |
<symCellMode> | The attribute that must have the new cell. The following values are supported: |
Value |
Description |
#Selectable |
The cell must be selectable. This is the default. |
#Editable |
The cell must be selectable and editable. |
Data Type: | Symbol |
<iSelectFlags> | The flags that indicate, how the selected cells and rows are to be processed. The following values are supported: |
Flag |
Description |
BPF_SELECTCLEAR |
The entire selection is removed. |
BPF_SELECTCLEARSINGLE |
The selection in the current cell is removed. |
BPF_SELECTSINGLE |
The new cell is selected. |
BPF_SELECTNOCHANGE |
The selection is not changed. |
Several flags can be combined. As default the flags BPF_SELECTCLEAR + BPF_SELECTSINGLE are used.
Data Type: | DWord |
<lSkipRecord> | A logical value that indicates whether the cursor is moved automatically to the previous/next row if this is at the first/last cell and the argument <symDirection> is specified by the value #Previous/#Next. As default the value FALSE is used. |
Data Type: | Logic |
<lAutoScroll> | A logical value that indicates whether it is scrolled to the column if this is not visible. As default the value TRUE is used. |
Datentyp: | Logic |
<lAutoEdit> | A logical value that indicates whether an cell edit shall be started in the new cell automatically. This mode is supported only for the AutoEdit mode #Permanent (see also bBrowser:AutoEdit, bDataColumn:AutoEdit). As default the value TRUE is used. |
Datentyp: | Logic |
Return Value
lSuccess | A logical value that indicates whether the cursor was moved. |
TRUE | The cursor was moved. |
FALSE | The cursor could not be moved. |
Data Type: | Logic |
Description
bBrowser:SkipToCell() moves the cursor either forward or backwards.
An active edit is closed before. If here an error appears, also moving the cursor is canceled.
See Also
bBrowser:GetNewEditableColumn()
bBrowser:GetNewSelectableColumn()
Page url: http://www.YOURSERVER.com/index.html?bbrowser_skiptocell.htm