Purpose
Moves a column.
Class
Type
Method
Syntax
<oBrowser>:MoveColumn(
<uColumn>,
[<iPositionNew>]
) Æ lMoved
Arguments
<uColumn> | The column that is to be moved. Either the column must be contained in the list of the open columns (see also bBrowser:ColumnOpenList) or it must be a group column. The column must be visible (see also bBrowser:IsColumnVisible()) |
Data type: | String | Symbol | Integer | bDataColumn | bGroupColumn |
<iPositionNew> | The position to which the column is to be moved. If the value 0 is specified, then the column is moved behind the last open column. If the argument is not specified, then the browser switches into the move mode. This indicates that the column can be moved with the mouse. |
Data type: | Integer |
Return Value
lMoved | A logical value that indicates whether the column was moved. |
TRUE | The column was moved. |
FALSE | The column could not be moved. |
Data type: | Logic |
Description
bBrowser:MoveColumn() moves a column within the browser. Depending on the argument <iPositionNew> two modes are supported:
1. | Moving to the specified position If the argument <iPositionNew> is specified, then the column is immediately moved to the new position. |
2. | Moving with the mouse If the argument <iPositionNew> is not specified, then the column can be moved with the mouse by the calling the method when the left mouse button is pressed. The column is moved with the mouse as long as the left mouse button is pressed. During moving the visible columns in the browser are scrolled horizontally as soon as the mouse reaches the left or right margin of the browser. If the left mouse button is released, moving is finished and the column is moved to the new position under the mouse. Moving can be canceled through by pressing the Esc key. |
If the column was successfully moved, the callback method bBrowser:ColumnMove() is called.
See Also
Page url: http://www.YOURSERVER.com/index.html?bbrowser_movecolumn.htm