Navigation:  Classes > bBrowser >

bBrowser:SkipToCell()

Print this Topic    Previous pageReturn to chapter overviewNext page

Purpose

Moves the cursor one column to the left or to the right or at the first or last column.

Class

bBrowser

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

lSuccessA logical value that indicates whether the cursor was moved.
TRUEThe cursor was moved.
FALSEThe 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:AutoSkip

bBrowser:GetNewEditableColumn()

bBrowser:GetNewSelectableColumn()

bBrowser:Skip()

 


Page url: http://www.YOURSERVER.com/index.html?bbrowser_skiptocell.htm