Macro Language Reference > PIs > Tables > <?tbrkeepp>
  
<?tbrkeepp>
Description
This command specifies whether or not the current row will stay with the previous row when the table breaks.
This keep PI is usually applied with a priority parameter - content can be designated to be kept together as long as this doesn't result in an empty column or partial column. When this exception does occur, PTC ALD will attempt to break the page at the lowest priority it can find irrespective of the amount of resulting content that is carried over. Priority value ranges are explained below: note that PTC ALD can only ignore keep instructions with a priority below 210 if a whole column overflows, and can only ignore those below 110 if a partial column overflows, i.e. a column that has been cropped to avoid other frames, such as those containing images at the top of a column.
Priority
Usage
0
No keep applied (default value)
1 and 255
Absolute - always apply keep regardless of effect
2 - 109
Low priority, keep only if something fits in the column or partial column
110 - 209
Medium priority, keep unless this leaves a whole column empty
210 - 254
Reserved for future enhancements
Syntax
<?tbrkeepp code:n>
code
An arbitrary figure may be applied here based on the guidelines given above.
Additional Information
Specifying <?tbrkeepp> at the top of the table specifies the default for the whole table, which would cause the whole table to stay as a lump if code=1 is used. Individual rows can be overridden if <?tbrkeepp> is used at the start of the row.
Keep commands work to slightly different rules when included in a cell in a table, since each cell can be seen as a "mini column" which forms parts of a hierarchy where each cell is a column in itself, each row can contain multiple cells, etc. This <?tbrkeepp> command is superceded by keeps set at table level and will be ignored if it is placed in the first row of a table, i.e. the content of the table will not keep with content in the preceding table. To overcome this, specify a "keep-with-next" setting for the paragraph before the table, e.g. via the <?tpkeep> or <?tpkend> commands.