PushCutControlToNextPage

Description

Whether to put the control (text in a column) to display on the next page, to avoid improper splitting when there are page breaks in nested reports or Composite DataWindows.

Applies to

DataWindows

Syntax

PowerBuilder dot notation:

dw_control.Object.DataWindow.PushCutControlToNextPage

Describe and Modify argument:

"DataWindow.PushCutControlToNextPage { = value }"

Parameter

Description

value

The value to be assigned to the property.

Values are:

Yes -- The entire column will be moved and displayed in the next page.

No -- (default) The text in the column may be split improperly when there are page breaks. For example, the characters in one line is cut vertically into two parts, and one line displays the upper part of characters on one page and the other line displays the lower part on the next. This issue usually exists in the nested report or Composite DataWindow.


Usage

This property is normally used in the nested report or Composite DataWindow to address the issue where column text is split improperly when there are page breaks (the other DataWindows have no such issue; they will automatically move the column to the next page).

The Edit edit style column supports this property; while the RichText edit style column does not.

Examples

dw1.Modify ('DataWindow.PushCutControlToNextPage=Yes')
dw1.Modify ('DataWindow.Print.Preview=Yes')