Purpose
A logical value or a codeblock that indicates whether empty values are to be suspended when drawing.
Class
Type
Access / Assign
Data Type
Logic | String | _Codeblock | Codeblock | bCodeblock
Description
The bBrowser uses this access when drawing the column values.
If the access contains the value TRUE empty values are not drawn. The value FALSE causes that all values are drawn.
If the access contains an expression whose evaluation results in the value TRUE, empty values are not drawn. The value FALSE causes all values to be drawn. Results not equal to TRUE or FALSE are not supported. In the expression, two variables Server and Column can be used. The variable Server specifies the data server of the column and Column the column itself.
If a string is assigned to the access, then this is converted automatically into object of the class _Codeblock. The conversion is made thereby with the following instruction:
&("{|Server, Column| "+cSuspendCondition+"}")
Whether a value is an empty value is checked with the method bDataColumn:IsValueEmpty().
With the access bDataColumn:ViewEmptyValuesAs a text can be defined that is shown instead of the empty value.
So that changes that were made with this access are also shown in the browser, the column data must be re-read with the method bBrowser:Refresh().
Samples
The following sample defines that empty values are not shown.
oColumn := oBrowser:GetColumn(#Percent)
IF !EMPTY(oColumn)
oColumn:SuspendEmptyValues := TRUE
oBrowser:Refresh()
oBrowser:Redraw()
ENDIF
The following sample defines that the text "<NULL>" is shown instead of empty values.
oColumn := oBrowser:GetColumn(#Percent)
IF !EMPTY(oColumn)
oColumn:SuspendEmptyValues := TRUE
oColumn:ViewEmptyValuesAs := "<NULL>"
oBrowser:Refresh()
oBrowser:Redraw()
ENDIF
The following sample defines a expression for the assign bDataColumn:SuspendEmptyValues.
oColumn := oBrowser:GetColumn(#Percent)
IF !EMPTY(oColumn)
oColumn:SuspendEmptyValues := "Server:FIELD1=0 .and. Server:FIELD2=0"
oBrowser:Refresh()
oBrowser:Redraw()
ENDIF
See Also
bDataColumn:IsSuspendEmptyValues()
Page url: http://www.YOURSERVER.com/index.html?bdatacolumn_suspendemptyvalues.htm