Edit

Rows.AllowBreakAcrossPages property (Word)

  • Article

True if the text in a table row or rows are allowed to split across a page break. Read/write Long.

Syntax

expression. AllowBreakAcrossPages

expression Required. A variable that represents a Rows object.

Remarks

This property can be True, False or wdUndefined (only some of the specified text is allowed to split).

Example

This example creates a new document with a 5x5 table and prevents the third row of the table from being split during pagination.

Dim docNew As Document 
Dim tableNew As Table 
 
Set docNew = Documents.Add 
Set tableNew = docNew.Tables.Add(Range:=Selection.Range, _ 
 NumRows:=5, NumColumns:=5) 
 
tableNew.Rows(3).AllowBreakAcrossPages = False

This example determines whether the rows in the current table can be split across pages. If the insertion point isn't in a table, a message box is displayed.

Dim lngAllowBreak as Long 
 
Selection.Collapse Direction:=wdCollapseStart 
If Selection.Tables.Count = 0 Then 
 MsgBox "The insertion point is not in a table." 
Else 
 lngAllowBreak = Selection.Rows.AllowBreakAcrossPages 
End If

See also

Rows Collection Object

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.