DioDocs for PDF
SplitAndBalanceRef メソッド

GrapeCity.Documents.Imaging アセンブリ > GrapeCity.Documents.Text 名前空間 > TextLayout クラス : SplitAndBalanceRef メソッド
The array of additional page areas that can be used to layout the text.
Options controlling how text is split.
Recipient for the text that did not fit in the current bounds and additional areas. If null, a new instance will be created and assigned to this parameter. If non-null, that TextLayout instance will be filled with the text that did not fit. When rendering large blocks of text, this improves performance by avoiding the need to initialize a new instance of a TextLayout for each split.
Fits all or the first portion of the current text layout into one or more layout areas (such as page columns). If the whole text did not fit into the provided areas, the rest is moved into a new TextLayout instance specified by the output parameter rest.

If the whole text fits in the specified areas (i.e. rest is empty), the content is equally distributed between all areas, which in the case of page columns results in columns of equal height (balanced).

For details on why providing a reference to an existing TextLayout may be beneficial, see the remarks on the SplitRef method.
シンタックス
'宣言
 
Public Function SplitAndBalanceRef( _
   ByVal pageAreas() As PageSplitArea, _
   ByVal splitOptions As TextSplitOptions, _
   ByRef rest As TextLayout _
) As SplitResult
public SplitResult SplitAndBalanceRef( 
   PageSplitArea[] pageAreas,
   TextSplitOptions splitOptions,
   ref TextLayout rest
)

パラメータ

pageAreas
The array of additional page areas that can be used to layout the text.
splitOptions
Options controlling how text is split.
rest
Recipient for the text that did not fit in the current bounds and additional areas. If null, a new instance will be created and assigned to this parameter. If non-null, that TextLayout instance will be filled with the text that did not fit. When rendering large blocks of text, this improves performance by avoiding the need to initialize a new instance of a TextLayout for each split.

戻り値の型

A value indicating the result of splitting the current text layout.
参照

TextLayout クラス
TextLayout メンバ
Split メソッド
SplitAndBalance メソッド
SplitRef メソッド