WP Get breaks

4D v19

WP Get breaks


WP Get breaks ( targetObj {; breakType} ) -> 戻り値

引数	型	説明
targetObj	オブジェクト	レンジまたは要素または4D Write Pro ドキュメント
breakType	倍長整数	返すブレークのタイプ
戻り値	コレクション	レンジのコレクション

説明

WP Get breaks コマンドはtargetObj 引数のターゲット内に挿入されている全てのブレークを格納したコレクションを返します。

このコマンドはユーザーまたはコードによって入力されたブレークのみを返し、4D Write Pro がレイアウトのために自動的に生成したブレークは返されません。

targetObj 引数には、以下のいずれかを渡すことができます:

レンジ
要素(表 / 行 / 段落 / 本文 / ヘッダー / フッター / セクション / サブセクション)
4D Write Pro ドキュメント

デフォルトでは、あらゆる種類のブレークが返されます。任意のbreakType 引数に以下の定数のいずれか一つを渡すことで、返されるブレークのタイプを選択することができます:

定数	値	コメント
wk column break	3	カラムブレーク:カラムブレークを挿入します
wk line break	0	(同じ段落内での)改行
wk page break	2	改ページ：新しいページを定義します。
wk paragraph break	4	段落ブレーク: 新しい段落を定義します。
wk section break	1	セクションブレーク:新しいセクションを定義します。

返される値

WP Get breaks はレンジオブジェクトのコレクションを返し、それぞれのオブジェクトにはtargetObj 内のブレークの詳細が格納されています。それぞれのレンジオブジェクトには読み出し専用の特定のプロパティが格納されており、ブレークのタイプを表します:

プロパティ	型	定数	詳細
[ ].breakType	数値	wk break type	読出専用: ブレークのタイプ

targetObj 引数がレンジまたは要素の場合、ブレークはそれらが見つかった順に返されます。targetObj が4D Write Pro ドキュメントであった場合、ブレークは以下の順番で返されます:

本文
セクション1 の最初のページヘッダー(あれば)
セクション1 の最初のページフッター(あれば)
セクション1 の左ページヘッダー(あれば)
セクション1 の左ページフッター(あれば)
セクション1 の右ページヘッダー(あれば)
セクション1 の右ページフッター(あれば)
セクション1 のメインヘッダー(あれば)
セクション1 のメインフッター(あれば)
セクション2、セクション3に対して同様に繰り返し

targetObj 引数にブレークが何も含まれない場合(またはbreakType 引数で指定したタイプのブレークが何も含まれない場合)、空のコレクションが返されます。

例題

ドキュメント内のの全ての改行を段落ブレークで置き換えたい場合を考えます:

 var $_filteredBreaks : Collection

 var $break : Object

 $_filteredBreaks:=WP Get breaks(WParea;wk line break)

 For each($break;$_filteredBreaks)

    WP INSERT BREAK($break;wk paragraph break;wk replace)

 End for each

参照

WP Get elements
WP INSERT BREAK