メインコンテンツまでスキップ
バージョン: 開発中

WP Get breaks

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

引数型説明
targetObjObject→レンジまたは要素または4D Write Pro ドキュメント
breakTypeInteger→返すブレークのタイプ
戻り値Collection←レンジのコレクション

説明​

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

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

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

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

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

定数値コメント
wk column break3カラムブレーク:カラムブレークを挿入します
wk continuous section break5継続したセクションブレークを定義します(一般的には新しいページに移らずにページ内でカラムの数を変更するために使用されます)
wk line break0(同じ段落内での)改行
wk page break2改ページ：新しいページを定義します。
wk paragraph break4段落ブレーク: 新しい段落を定義します。
wk section break1セクションブレーク:新しいセクションを定義します。

返される値

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

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

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

  1. 本文
  2. セクション1 の最初のページヘッダー(あれば)
  3. セクション1 の最初のページフッター(あれば)
  4. セクション1 の左ページヘッダー(あれば)
  5. セクション1 の左ページフッター(あれば)
  6. セクション1 の右ページヘッダー(あれば)
  7. セクション1 の右ページフッター(あれば)
  8. セクション1 のメインヘッダー(あれば)
  9. セクション1 のメインフッター(あれば)
  10. セクション2、セクション3に対して同様に繰り返し
  11. テキストボックス

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