suppressIfBlank

Topic group Related topics

Specifies whether an object is suppressed, or not rendered, if it is blank. For use in Reports only.

Property of

Text

Description

suppressIfBlank has an effect only for visual components that are in a report. If true, it suppresses the rendering of the component if its display value is blank.

For example, suppose you’re printing two-line addresses with the city underneath. If the second address line is blank, you don’t want it to occupy any space. By setting that component’s suppressIfBlank property to true, if it’s blank, nothing gets rendered and all the components below it that have their fixed properties set to false are moved up to fill the space.

Components are rendered in their z-order, the order in which they are defined in the report. suppressIfBlank does not affect the position of components that have already been rendered. The z-order of the components in the report should match their top-to-bottom order; otherwise suppressIfBlank will have no effect.

By default suppressIfBlank is false. You can also use the component’s canRender event to suppress rendering.