WP Get footer

4D v17

WP Get footer


WP Get footer ( rangeObj ) \| (wpDoc ; sectionIndex {; sectionSubType} ) -> 戻り値

引数	型	説明
rangeObj	Object	4D Write Pro レンジ
wpDoc	Object	4D Write Pro ドキュメント
sectionIndex	倍長整数	セクションインデックス
sectionSubType	倍長整数	サブセクションのタイプ(wk first page、wk left page、あるいは wk right page)
戻り値	Object	4D Write Pro フッター参照

説明

WP Get footer コマンドはwpDoc 引数で指定したドキュメントの、rangeObj 引数で指定したレンジ、あるいはsectionIndex 引数で指定したインデックスに関連付けられたフッターへの参照を返します。

第一シンタックス(rangeObj 引数を使用)では、コマンドはレンジ内の最初のページのフッターを返します。ページ内においてサブセクションがアクティブになっている場合、コマンドはアクティブなサブセクションのフッターを返します(そのため常に表示されているフッターを返します)。

第二シンタックス(wpDoc 引数)では、sectionIndex コマンドは引数で指定したセクションのフッターを返します(sectionIndex 引数の値は1以上でなければなりません)。
subSectionType 引数が渡された場合、コマンドは指定されたサブセクションタイプに関連付けられたフッターを返します。subSectionType 引数には以下の定数のどれか一つを渡すことができます:

定数	型	値
wk first page	倍長整数	1
wk left page	倍長整数	2
wk right page	倍長整数	3

subSectionType 引数が指定されなかった場合、メインセクションのフッターが返されます。この場合、サブセクションがアクティブになっている場合、メインセクションのフッターオブジェクトはundefined となります(メインセクションフッターはアクティブなwk first page あるいは wk left page サブセクションがない場合にのみ利用可能です)。

例題

ある4D Write Pro ドキュメントの最初のページのフッターを、他の4D Write Pro ドキュメントのすべてのページのフッターにコピーしたい場合を考えます:

 C_OBJECT($footerSource;$rangeSource;$tempoc;$footerTarget;$rangeTarget)

 

 $footerSource:=WP Get footer([TEMPLATES]WPtemplate;1;wk first page) //セクション1の最初のページのフッターを取得

 $rangeSource:=WP Create range($footerSource;wk start text;wk end text)

 $tempoc:=WP New($rangeSource)

 

 $footerTarget:=WP Get footer([Docs]MyWPDoc;1) //セクション1の全てのページ

 $rangeTarget:=WP Create range($footerTarget;wk start text;wk end text)

 

 WP INSERT DOCUMENT($rangeTarget;$tempoc;wk replace)

参照

4D Write Pro エリアを使用する
 WP Get frame
WP Get header