ドキュメントのコンテンツにプログラムでアクセスする

4D v16

4D Write Proではドキュメント内でテキストと画像の属性を変更するためのコマンドをフルセット提供しています。これらの機能のおかげで、4Dデベロッパーは4D Write Proドキュメントに対して(ボタン、メニュー、チェックボックス等を使用した)独自のインターフェースをデザインすることができます。コマンドはドキュメント全体、または特定の部分(レンジ)に対して適用可能で、どちらもユーザー選択あるいはカスタムの値に基づきます。利用可能なプロパティには、ドキュメント単位、マージン、パッディング、背景、段落設定、カラー、フォント、フォントスタイル、そして画像プロパティなどが含まれます。

例えば、4D Write Pro エリアライブラリオブジェクトはこれらの機能を存分に活用し、洗練された4D Write Proインターフェースを提供しています。

セレクションレンジコマンド

いくつかのコマンドは、ドキュメント内の選択範囲を管理するために特化しています。選択されたテキストは(不過視の)フォーマットタグを含み得ることから、4D Write Proはレンジというものを使用します。レンジは4D Write ドキュメントの一部を表すオブジェクトです。

WP Get range( wpArea ; startRange ; endRange ) -> rangeObj: 引数として渡した境界に対応する新しい範囲を返します。
( {*;} wpArea ) -> rangeObj: カレントのユーザーセレクションに対応した新しいレンジを返します。
WP Get pictures( rangeObj ) -> rangeObj: ピクチャーのみを含んだ新しいレンジを返します。
WP Get paragraphs( rangeObj ) -> rangeObj: 段落のみを含んだ新しいレンジを返します。
WP SELECT( {*;} wpArea {; rangeObj}{; startRange ; endRange} ): レンジに対応したテキストを選択します。

ブックマークコマンド

4D Write Proではブックマークと呼ばれる、ドキュメントの一部に対して動的な参照を作成し、使用することができます。ブックマークとは、4D Write Proドキュメント内の特定のレンジに関連づけられた名前付き参照です。

ブックマークは動的です。これはつまり、ブックマークに関連付いた文章をユーザーが移動または削除した場合には、紐付いているレンジも自動的に更新され、ブックマークはドキュメント内の同じ内容を引き続き参照し続けるという事です。例えば:

ドキュメント内の20ページ目にある"Hello world"を参照する、"MyBM"というブックマークを作成したとします。
次に、ドキュメントの最初に50ページ挿入したとします。
"MyBM"ブックマークを使用する事で、今度はドキュメント内の70ページ目にある、同じ"Hello world"というテキストに自動的にアクセスすることができます。

ドキュメント内には無制限のブックマークを含める事ができます。複数のブックマークが同じレンジを参照することもできますし、ブックマークのレンジは重複することもできます。しかしながら、それぞれブックマーク名はドキュメント内において固有でなければなりません。ブックマークは、MissingRef あるいは WP Newコマンドを使用した場合にはインポートされません(保存先のドキュメントのブックマークは上書きされません)。

一度作成すると、ブックマークはドキュメント内に保存されています。ブックマークはドキュメントとともに保存され、複数のコマンドによって管理することができます。また、テンプレートドキュメントの一部を参照するのにも使用できます。これらの部分はデータベース内のドキュメントと自動的に組み合わせることもでき、その結果請求書やカタログといった動的な出力ドキュメントを生成することもできます。

複数のコマンドを使用して、ブックマークを作成、削除、使用することができます:

WP CREATE BOOKMARK はレンジから新しいブックマークを作成します。
はドキュメント内で定義されている全てのブックマークを取得します。
WP Get bookmark range は既存のブックマークからレンジを取得します。
WP DELETE BOOKMARK はブックマークを削除します。

属性管理コマンド

以下のコマンドはドキュメントの属性を取得あるいは設定します:

WP SET ATTRIBUTES( rangeObj | wpDoc ; attribName ; attribValue {; attribName2 ; attribValue2 ; ... ; attribNameN ; attribValueN} ): ドキュメントまたはレンジ内の一つ以上の属性/値のペアを設定します。
WP GET ATTRIBUTES( rangeObj | wpDoc ; attribName ; attribValue {; attribName2 ; attribValue2 ; ... ; attribNameN ; attribValueN} ): ドキュメントまたはレンジ内の属性のカレントの値を取得します。
WP RESET ATTRIBUTES( rangeObj ; attribName {; attribName2 ; ... ; attribNameN } ): ドキュメントまたはレンジ内の属性の値を再設定します。

属性は4D Write Pro属性の章に詳細な説明があります。

フォント管理コマンド

このコマンドはレンジのスタイルサポートに関する情報を取得します:

WP Is font style supported( rangeObj ; wpFontStyle ) -> true または false: レンジが特定のスタイルをサポートするかどうかを調べます(インターフェースのデザインに有用です)。

参照