WP Get sections
WP Get sections ( targetObj ) -> 戻り値
| 引数 | 型 | 説明 | |
|---|---|---|---|
| targetObj | Object | → | レンジまたは4D Write Pro ドキュメント |
| 戻り値 | Collection | ← | targetObj 内で見つかった全ての(メイン)セクションのコレクション |
説明
WP Get sections コマンドはtargetObj 引数内に定義されている全てのセクションのコレクションを返します。targetObj 引数には、以下のいづれかを渡すことができます:
- レンジ
- 要素(表 / 行 / 段落 / 本文 / ヘッダー / フッター / テキストボックス / 画像)
- 4D Write Pro ドキュメント
レンジまたは要 素がヘッダーまたはフッターである、あるいはヘッダーまたはフッターに属している場合、WP Get sections はヘッダーまたはフッターが割り当てられているセクションを返します。
画像にアンカーされたテキストボックスに関しては、WP Get sections は条件によって以下のいづれかを返します:
- 要素があるセクションに対してアンカーされている場合には、単一のセレクションを格納したコレクションを返します。
- 要素が全てのセクションに対してアンカーされている場合には、全てのセクションを格納したコレクションを返します。
- 要素が埋め込みビューまたはページ番号に対してアンカーされている場合には、空のコレクションを返します。
セクションオブジェクトについての詳細な情報については、ヘッダー、フッター、セクションの管理 の章を参照してください。
例題
4D Write Pro エリアの最後のセクションの属性を変えたい場合を考えます:
var $colSections : Collection
$colSections:=WP Get sections(wpDoc)
WP SET ATTRIBUTES($colSections[$colSections.length-1];wk column count;3)