Purpose
Redraws the browser or parts of it.
Class
Type
Method
Syntax
<oBrowser>:Redraw(
[<symArea>],
[<lAtOnce>],
[<uData1>],
[<uData2>],
[<uData3>],
[<uData4>],
[<uData5>],
[<uData6>],
[<uData7>]
) Æ lRedraw
Arguments
<symArea> | The area that is to be redrawn. The following values are supported: |
• | #Title Redraws the area of the title. |
• | #Caption Redraws the area of the column captions. |
• | #Footer Redraws the area of the column footers. |
• | #Data Redraws the area of the column data. |
• | #DynamicArea Redraws only the column captions and the column data that is to the right of the frozen columns. If no columns are frozen, the complete area is redrawn. |
• | #FromColumn Redraws the area of the columns captions, column data, and column footer starting from the specified column. |
In uData1 the column number must be specified.
Data type: DWord
• | #FromLine Redraws the data area starting from the specified row. |
In uData1 the row number must be specified.
Data type: DWord
• | #Selection Redraws all selected cells. |
In uData1 it can be specified whether the current selected cell is to be drawn with a focus rectangle. If this argument is not specified, the focus rectangle is drawn, if the browser has the focus.
Data type: Logic
• | #Current Redraws the current cell or the current row dependent on bBrowser:CurrentMode. |
In uData1 it can be specified whether the cell or row is to be drawn in selected state. If this argument is not specified, the cell or row is drawn in selected state.
Data type: Logic
In uData2 it can be specified whether the current selected cell is to be drawn with a focus rectangle. If this argument is not specified, the focus rectangle is drawn, if the browser has the focus.
Data type: Logic
In uData3 it can be specified whether the associated selector cell (if actively) is to be drawn. If this argument is not specified, the selector cell is not drawn.
Data type: Logic
In uData4 it can be specified, how the state of the selector cell is to be drawn. If this argument is not specified, the selector cell is drawn in selected state. The argument becomes considers only if in the argument uData3 the value TRUE is specified.
Data type: Logic
• | #Cell Redraws an single cell. |
In uData1 the column number must be specified.
Data type: DWord
In uData2 the row number must be specified.
Data type: DWord
In uData3 the record number must be specified.
Data type: Integer
In uData4 it can be specified whether the cell is to be drawn in selected state. If this argument is not specified, the cell is drawn in selected state.
Data type: Logic
In uData5 it can be specified whether the cell is to be drawn with a focus rectangle. If this argument is not specified, the focus rectangle is drawn, if the browser has the focus.
Data type: Logic
In uData6 it can be specified whether the associated selector cell (if actively) is to be drawn. If this argument is not specified, the selector cell is not drawn.
Data type: Logic
In uData7 it can be specified, how the state of the selector cell is to be drawn. If this argument is not specified, the selector cell is drawn in selected state. The argument becomes considers only if in the argument uData6 the value TRUE is specified.
Data type: Logic
• | #Line Redraws a complete row. |
In uData1 the row number must be specified.
Data type: DWord
In uData2 the record number must be specified.
Data type: Integer
In uData3 it can be specified whether the row is to be drawn in selected state. If this argument is not specified, the row is only drawn in selected state, if it is the current row.
Data type: Logic
In uData4 it can be specified whether the row is to be drawn with a focus rectangle. If this argument is not specified, the focus rectangle is drawn, if the browser has the focus.
Data type: Logic
In uData5 it can be specified whether the associated selector cell (if actively) is to be drawn. If this argument is not specified, the selector cell is not drawn.
Data type: Logic
In uData6 it can be specified, how the state of the selector cell is to be drawn. If this argument is not specified, the selector cell is drawn in selected state. The argument becomes considers only if in the argument uData5 the value TRUE is specified.
Data type: Logic
• | #Selector Redraws the area of the selector column. |
• | #SelectorState Redraws the status of a selector cell. |
In uData1 the row number must be specified.
Data type: DWord
In uData2 the record number must be specified.
Data type: Integer
In uData3 can be specified in which state the selector cell is to be drawn. If this argument is not specified, the selector cell is drawn in normal state.
Data type: Logic
• | #Info Redraws the info value. |
In uData1 it can be specified whether the info value is to be drawn with a focus rectangle. If this argument is not specified, the focus rectangle is drawn, if the browser has the focus.
Data type: Logic
• | #Focus Redraws a focus rectangle around a single cell. |
In uData1 the column number must be specified.
Data type: DWord
In uData2 the row number must be specified.
Data type: DWord
In uData3 the record number must be specified.
Data type: Integer
If the argument symArea is not specified, the entire browser is redrawn.
Data type: | Symbol |
<lAtOnce> | A logical value that indicates whether redrawing is to be accomplished immediately or whether only the appropriate area is to be marked as invalid. If the area is marked as invalid, the event system of Windows accomplishes the redrawing at a later time. If this argument is not specified, the appropriate area is marked as invalid. |
Data type: | Logic |
Return Value
lRedraw | A logical value that indicates whether the area was redrawn. |
TRUE | The area was redrawn. |
FALSE | The area could not be redrawn. |
Data type: | Logic |
Description
bBrowser:Redraw() redraws the entire browser or parts of it.
As a rule, redrawing should always be made by the event system of Windows. This means that only the areas that need to be redrawn should be marked as invalid (thus, redraw it). The event system of windows then redraws the appropriate areas one at a time.
Page url: http://www.YOURSERVER.com/index.html?bbrowser_redraw.htm