4D v16WP SET ATTRIBUTES |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v16
WP SET ATTRIBUTES
|
WP SET ATTRIBUTES ( rangeObj | wpDoc ; attribName ; attribValue {; attribName2 ; attribValue2 ; ... ; attribNameN ; attribValueN} ) | ||||||||
引数 | 型 | 説明 | ||||||
rangeObj | wpDoc | Object |
![]() |
4D Write Pro レンジまたはドキュメント | |||||
attribName | 文字 |
![]() |
設定する属性名 | |||||
attribValue | 文字, 実数, ブール |
![]() |
新しい属性の値 | |||||
新しいWP SET ATTRIBUTESコマンドを使用すると4D Write Proレンジあるいはドキュメントのあらゆる属性の値を設定する事ができます。このコマンドはあらゆる4D Write Pro内部(文字、段落、ドキュメント、またはピクチャー)の属性にアクセスすることができます。
第一引数には、4D Write Proレンジオブジェクト(rangeObj)または4D Writeドキュメント参照(wpDoc)を渡します。rangeObjは別のコマンドによって作成することのできる4D Write Proドキュメントの一部です。以下の表は以下の表は、ターゲットとなるオブジェクトと属性に応じたWP SET ATTRIBUTESのスコープを表しています:
引数 | 共通の属性("verticalAlign"を除く) | ドキュメントのみの属性 | 段落のみの属性 | 文字のみ(と"verticalAlign")の属性 |
WP Get paragraphsで取得したrangeObj | 段落 | ドキュメント | 段落 | 段落 |
WP Get picturesで取得したrangeObj | ピクチャー | ドキュメント | - | - |
WP Get rangeまたはで取得したrangeObj | レンジの段落 | ドキュメント | レンジの段落(レンジとかぶる段落) | レンジの文字 |
wpDoc | ドキュメント | ドキュメント | ドキュメント全体の段落 | ドキュメント全体の文字 |
共通の属性("margin"や"padding"など)は、ドキュメント、段落、ピクチャーに共通する属性という意味です。
attribName引数に渡す属性の包括的な一覧と、それに対応する値については、4D Write Pro属性の章を参照して下さい。
この4D Write Proエリアにて、以下のように単語を選択した場合を考えます:
以下のコードを実行した場合:
$range:=WP Get selection(*;"WParea") //選択されたレンジを取得
// 選択されたテキストに対して影のオフセットをpt単位で設定
WP SET ATTRIBUTES($range;wk text shadow offset;1)
//段落のパッディングを設定
WP SET ATTRIBUTES($range;wk padding;1)
//10 ptの境界線を定義
WP SET ATTRIBUTES($range;wk border style;wk solid;wk border width;10)
//境界線カラーを設定
WP SET ATTRIBUTES($range;wk border color;"blue";wk border color bottom;"#00FA9A";wk border color right;"#00FA9A")
以下の様な結果が得られます:
以下の例では、wk insideとwk outside定数の使用を説明します:
$wpRange:=WP Get selection(writeProdoc)
WP SET ATTRIBUTES($wpRange;wk border style+wk inside;wk dotted)
WP SET ATTRIBUTES($wpRange;wk border style+wk outside;wk solid)
WP SET ATTRIBUTES($wpRange;wk border color+wk outside;"#00FA9A")
ドキュメント全体が選択されていた場合、結果は以下のようになります:
プロダクト: 4D
テーマ: 4D Write Proランゲージ
初出: 4D v15 R4
4D Write Proリファレンス ( 4D v16)