WP Get section

4D v20 R7

WP Get section


WP Get section ( targetObj ) \| (wpDoc ; sectionIndex ) -> 戻り値

引数	型	説明
targetObj	オブジェクト	レンジまたは要素の参照
wpDoc	オブジェクト	4D Write Pro ドキュメント
sectionIndex	倍長整数	セクションのインデックス
戻り値	オブジェクト	4D Write Pro セクション

WP Get section コマンドは、targetObj 引数のレンジと交差する最初のセクションまたは要素、あるいはwpDoc 引数のドキュメント内でsectionIndex 引数で指定されたセクションを返します。

第1シンタックス(targetObj 引数)を使用する場合、コマンドはレンジまたは要素と交差する最初のセクションを返します。targetObj 引数には以下のものを渡すことができます:
- レンジ
- 要素(表 / 行 / 段落 / 本文 / テキストボックス / ヘッダー / フッター )。サブセクションあるいはアンカーされたピクチャーを渡すことはできません(その場合エラーが返されます)。
レンジまたは要素がヘッダーまたはフッターに所属する場合、WP Get section はヘッダーあるいはフッターが付属するセクションを返します。レンジまたは要素がテキストボックスであるか、テキストボックスに所属している場合、WP Get section は常に最初のセクションを返します(ただしテキストボックスがセクションにアンカーされている場合を除く、その場合はセクションが返されます)。

第2シンタックス(wpDoc 引数)を使用する場合、コマンドはsectionIndex 引数のセクションに対応するセクションを返します(sectionIndex は1以上の値でなければなりません)。
sectionIndex 指定した引数に対して定義されたセクションがなかった場合、コマンドは未定義のオブジェクトを返します(エラーは返されません)。

注: セクションあるはレンジからサブセクションを取得したい場合には、WP Get subsection コマンドを使用してください。

最初のセクションを取得したい場合を考えます:

 C_OBJECT($section)

  // 最初のセクションの参照を取得

 $section:=WP Get section(wpDoc;1)

参照