Purpose
Moves a column.
Class
Type
Method
Syntax
<oBrowser>:MoveColumn(
<uColumn>,
[<iPositionNew>],
[<iMoveFlags>]
) Æ 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 |
<iMoveFlags> | One or more flags with these the column moving can be influenced. The following flags are supported: |
Flag |
Description |
BMCMF_NONE |
No flags are defined. |
BMCMF_INSERTLEFT |
Moves the column to to the position on the left of the specified new position. |
BMCMF_INSERTRIGHT |
Moves the column to to the position on the right of the specified new position. |
BMCMF_INSERTFIRST |
Moves the column to the first position. |
BMCMF_INSERTLAST |
Moves the column to the last position. |
BMCMF_INSERTINGROUP |
Moves the column inside a group column. |
BMCMF_REMOVEFROMGROUP |
Moves the column outside a group column. |
Serveral flags can be combined. The argument is supported only, when the argument <iPositionNew> is passed.
Data type: | DWord |
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