4D v16

4D Write Pro属性

ホーム

 
4D v16
4D Write Pro属性

4D Write Pro属性  


 

 

4D Write Pro属性を使用するとドキュメント内に保存されているテキストと画像の全てのグラフィックな要素を管理する事ができます。これらの属性は以下のコマンドによって管理されます:

注: 一般的な4DコマンドOB SETOB Get を使っても4D Write Proエリア属性を扱うことはできますが、ピクチャーを直接使用することに関しては制約がつきます(より詳細な情報については、これらのコマンドの説明を参照して下さい)。

背景  

背景属性を使用すると、ドキュメント内の背景画像エフェクトを定義する事ができます。これの適用対応表は以下のようになります:

ドキュメント段落文字ピクチャー
OOO

定数 コメント
wk background clip 背景の塗りエリアを指定します。取り得る値:
  • wk border box (デフォルト): 背景は境界線の外側の端まで塗られます。
  • wk content box: 背景はコンテンツボックスの内部まで塗られます。
  • wk padding box: 背景はパッディングの橋野外側まで塗られます(もしくはあった場合には境界線の内側まで)。
wk background color 要素の背景色を指定します。取り得る値:
  • CSS カラー("#010101" または "#FFFFFF" または "red")
  • 4D カラーの倍長整数値(OBJECT SET COLORコマンドを参照して下さい)
  • R、G、Bコンポーネントそれぞれの要素(0-255)を格納した倍長整数配列

ドキュメントのデフォルトは"#FFFFFF" と wk transparentで、段落と画像に対しては"transparent"がデフォルトです。

wk background image 背景として使用する画像を指定します。設定可能な値は以下の通りです:
  • 画像URL(文字列)。絶対パスまたはストラクチャーファイルあらの相対パスが可能です。
  • ピクチャー変数またはフィールド

(WP GET ATTRIBUTESによって)返された値: URI(ネットワークURLまたはデータURI)。ネットワークURLで参照されない画像については、最初のURLとは同じでないかもしれません(ネットワークURLのみが保持されます)。ローカルファイルのURLについては、画像ストリームそのものがドキュメント内に保存されるので、返されたURLはデータURIとbas64でエンコードされた画像ストリームです。

wk background origin 背景画像どのような位置におかれるかを指定します。取りうる値は以下の通りです:
  • wk padding box (デフォルト): 背景画像はパッディング(または内側の境界線の端)からスタートします。
  • wk border box: 背景画像は境界線(外側の境界線の端)の四角形からスタートします。
  • wk content box: 背景画像はコンテンツ四角形からスタートします。
wk background position h 背景画像の水平方向のスタート位置を指定します。取り得る値は以下の通りです:
  • wk left (デフォルト): 背景画像は水平方向に対して要素の左側からスタートします。
  • wk center: 背景画像は水平方向に対して要素の中央からスタートします。
  • wk right: 背景画像は水平方向に対して要素の右側からスタートします。
wk background position v 背景画像の垂直方向のスタート位置を指定します。取り得る値は以下の通りです:
  • wk top (デフォルト): 背景画像は垂直方向に対して要素の上側からスタートします。
  • wk middle: 背景画像は垂直方向に対して要素の中央からスタートします。
  • wk bottom: 背景画像は垂直方向に対して要素の下側からスタートします。
wk background repeat 背景画像をどのように繰り返すか(あるいは繰り返さないか)を指定します。取り得る値は以下の通りです:
  • wk repeat (デフォルト): 背景画像は垂直方向にも水平方向にも繰り返されます。
  • wk no repeat: 背景画像は繰り返されません。
  • wk repeat x: 背景画像は水平方向にのみ繰り返されます。
  • wk repeat y: 背景画像は垂直方向にのみ繰り返されます。
wk background size h 背景画像の水平方向のサイズを指定します。取り得る値は以下の通りです:
  • wk auto (デフォルト): 背景画像はその幅を保ちます。
  • wk contain: 背景画像のアスペクト比を保ったまま、画像全体が表示される範囲で最大のサイズへと拡大/縮小します。このオプションは他のサイズ属性の値も変更します。
  • wk cover: 背景画像のアスペクト比を保ったまま、背景全体を画像でカバーできる大きさまで拡大/縮小します。このとき背景画像の一部は見切れる可能性があります。このオプションは他のサイズ属性の値も変更します。
  • 定義されたサイズ: 背景画像の水平方向のサイズは実数値あるいは文字列値を使用して表現されます:
    • 実数: サイズはwk layout unitで指定します。
    • 文字列: 連結された値と単位のCSS文字列。例:12ptは12ポイント、1.5cmは1.5センチを意味します。
      最小値: 0pt、最大値: 1000pt。相対値(パーセンテージ、%)はサポートされています。
wk background size v 背景画像の垂直方向のサイズを指定します。取り得る値は以下の通りです:
  • wk auto (デフォルト): 背景画像はその高さを保ちます。
  • wk contain: 背景画像のアスペクト比を保ったまま、画像全体が表示される範囲で最大のサイズへと拡大/縮小します。このオプションは他のサイズ属性の値も変更します。
  • wk cover: 背景画像のアスペクト比を保ったまま、背景全体を画像でカバーできる大きさまで拡大/縮小します。このとき背景画像の一部は見切れる可能性があります。このオプションは他のサイズ属性の値も変更します。
  • 定義されたサイズ: 背景画像の垂直方向のサイズを実数値あるいは文字列値を使用して表現します:
    • 実数: サイズはwk layout unitで指定します。
    • 文字列: 連結された値と単位のCSS文字列。例:12ptは12ポイント、1.5cmは1.5センチを意味します。
      最小値: 0pt、最大値: 1000pt。相対値(パーセンテージ、%)はサポートされています。

境界線属性を使用すると、要素の境界線のスタイル、幅、カラーを指定できます。この属性の適用対応表は以下のようになっています:

ドキュメント段落文字ピクチャー
OOO

定数 コメント
wk border color 境界線4つともにカラーを設定します。取りうる値は以下の通りです:
  • CSSカラー("#010101"または"#FFFFFF"または"red")。
  • 4Dカラーの倍長整数値(OBJECT SET COLORコマンドを参照して下さい)
  • R、G、Bコンポーネントそれぞれの要素(0-255)を格納している倍長整数配列

デフォルト値は"#000000"です(文字列値の場合)。複数のカラーがある場合、WP GET ATTRIBUTESは空の文字列を返します。

wk border color bottom 下の境界線のカラーを設定します。取りうる値は以下の通りです:
  • CSSカラー("#010101"または"#FFFFFF"または"red")。デフォルトは"#000000"です。
  • 4Dカラーの倍長整数値(OBJECT SET COLORコマンドを参照して下さい)
  • R、G、Bコンポーネントそれぞれの要素(0-255)を格納している倍長整数配列
wk border color left 左の境界線のカラーを設定します。取りうる値は以下の通りです:
  • CSSカラー("#010101"または"#FFFFFF"または"red")。デフォルトは"#000000"です。
  • 4Dカラーの倍長整数値(OBJECT SET COLORコマンドを参照して下さい)
  • R、G、Bコンポーネントそれぞれの要素(0-255)を格納している倍長整数配列
wk border color right 右の境界線のカラーを設定します。取りうる値は以下の通りです:
  • CSSカラー("#010101"または"#FFFFFF"または"red")。デフォルトは"#000000"です。
  • 4Dカラーの倍長整数値(OBJECT SET COLORコマンドを参照して下さい)
  • R、G、Bコンポーネントそれぞれの要素(0-255)を格納している倍長整数配列
wk border color top 上の境界線のカラーを設定します。取りうる値は以下の通りです:
  • CSSカラー("#010101"または"#FFFFFF"または"red")。デフォルトは"#000000"です。
  • 4Dカラーの倍長整数値(OBJECT SET COLORコマンドを参照して下さい)
  • R、G、Bコンポーネントそれぞれの要素(0-255)を格納している倍長整数配列
wk border radius 角の丸い境界線を指定します。取り得る値は以下の通りです:
  • wk none (デフォルト): 境界線は丸い角を持ちません。
  • 整数値または文字列値を使用して表現された半径:
    • 整数値: wk layout unitでの半径
    • 文字列値: 値と単位が連結されたCSS文字列。例: 12ptは12ポイント、1.5cmは1.5センチを意味します。
wk border style 境界線の4辺全てを指定します。取り得る値は以下の通りです:
  • wk none (デフォルト): 境界線なし
  • wk hidden: wk noneと同様(境界線の競合解決時を除く)
  • wk solid: 標準の境界線
  • wk dotted: ドットの境界線
  • wk dashed: 破線の境界線
  • wk double: 二重境界線
  • wk groove: 3D くぼみ境界線(実際の効果は境界線カラーによります)
  • wk ridge: 3D 隆起境界線(実際の効果は境界線カラーによります)
  • wk inset: 3D インセット境界線(実際の効果は境界線カラーによります)
wk border style bottom 下部の境界線を指定します。取り得る値は以下の通りです:
  • wk none (デフォルト): 下部境界線なし
  • wk hidden: wk noneと同様(境界線の競合解決時を除く)
  • wk solid: 標準の下部境界線
  • wk dotted: ドットの下部境界線
  • wk dashed: 破線の下部境界線
  • wk double: 二重下部境界線
  • wk groove: 3D くぼみ下部境界線(実際の効果は下部境界線カラーによります)
  • wk ridge: 3D 隆起下部境界線(実際の効果は下部境界線カラーによります)
  • wk inset: 3D インセット下部境界線(実際の効果は下部境界線カラーによります)
wk border style left 左の境界線を指定します。取り得る値は以下の通りです:
  • wk none (デフォルト): 左境界線なし
  • wk hidden: wk noneと同様(境界線の競合解決時を除く)
  • wk solid: 標準の左境界線
  • wk dotted: ドットの左境界線
  • wk dashed: 破線の左境界線
  • wk double: 二重左境界線
  • wk groove: 3D くぼみ左境界線(実際の効果は左境界線カラーによります)
  • wk ridge: 3D 隆起左境界線(実際の効果は左境界線カラーによります)
  • wk inset: 3D インセット左境界線(実際の効果は左境界線カラーによります)
wk border style right 右の境界線を指定します。取り得る値は以下の通りです:
  • wk none (デフォルト): 右境界線なし
  • wk hidden: wk noneと同様(境界線の競合解決時を除く)
  • wk solid: 標準の右境界線
  • wk dotted: ドットの右境界線
  • wk dashed: 破線の右境界線
  • wk double: 二重右境界線
  • wk groove: 3D くぼみ右境界線(実際の効果は右境界線カラーによります)
  • wk ridge: 3D 隆起右境界線(実際の効果は右境界線カラーによります)
  • wk inset: 3D インセット右境界線(実際の効果は右境界線カラーによります)
wk border style top 上部境界線を指定します。取り得る値は以下の通りです:
  • wk none (デフォルト): 上部境界線なし
  • wk hidden: wk noneと同様(境界線の競合解決時を除く)
  • wk solid: 標準の上部境界線
  • wk dotted: ドットの上部境界線
  • wk dashed: 破線の上部境界線
  • wk double: 二重上部境界線
  • wk groove: 3D くぼみ上部境界線(実際の効果は上部境界線カラーによります)
  • wk ridge: 3D 隆起上部境界線(実際の効果は上部境界線カラーによります)
  • wk inset: 3D インセット上部境界線(実際の効果は上部境界線カラーによります)
wk border width 四辺全ての境界線の幅を指定します。境界線幅を指定する前に境界線スタイルを指定する必要があります。取り得る値は以下の通りです:
  • 整数値あるいは文字列値を使用して表現された幅:
    • 整数値: wk layout unitでの幅
    • 文字列値: 値と単位が結合されたCSS文字列。例: 12ptは12 points、1.5cmは1.5センチを意味します。
  • デフォルト値: 2pt
wk border width bottom 下部境界線の幅を指定します。取り得る値は以下の通りです:
  • 整数値あるいは文字列値を使用して表現された幅:
    • 整数値: wk layout unitでの幅
    • 文字列値: 値と単位が結合されたCSS文字列。例: 12ptは12 points、1.5cmは1.5センチを意味します。
  • デフォルト値: 2pt
wk border width left 左境界線の幅を指定します。取り得る値は以下の通りです:
  • 整数値あるいは文字列値を使用して表現された幅:
    • 整数値: wk layout unitでの幅
    • 文字列値: 値と単位が結合されたCSS文字列。例: 12ptは12 points、1.5cmは1.5センチを意味します。
  • デフォルト値: 2pt
wk border width right 右境界線の幅を指定します。取り得る値は以下の通りです:
  • 整数値あるいは文字列値を使用して表現された幅:
    • 整数値: wk layout unitでの幅
    • 文字列値: 値と単位が結合されたCSS文字列。例: 12ptは12 points、1.5cmは1.5センチを意味します。
  • デフォルト値: 2pt
wk border width top 上部境界線の幅を指定します。取り得る値は以下の通りです:
  • 整数値あるいは文字列値を使用して表現された幅:
    • 整数値: wk layout unitでの幅
    • 文字列値: 値と単位が結合されたCSS文字列。例: 12ptは12 points、1.5cmは1.5センチを意味します。
  • デフォルト値: 2pt
wk inside 選択されたエリアに複数の段落が含まれる場合、属性は、対応して被っている段落のプロパティに対してのみ適用することを指定します(範囲の外側は含まれません)。境界線、パッディング、マージン属性に対してのみ適用可能で、指定された属性に追加されなければなりません。WP SET ATTRIBUTESコマンドの例2を参照して下さい。
wk outside 選択されたエリアが複数の段落を含むとき、ある属性が対応する段落の外側のプロパティにのみ適用されることを指定します(内側には適用されません)。これは境界線、パッディング、そしてマージン属性に対してのみ指定可能で、特定の属性に対して追加される必要があります。WP SET ATTRIBUTESコマンドの例2を参照して下さい。

ドキュメント属性を使用すると、ドキュメントの題名、執筆者名、会社名、注記といった標準のドキュメント情報を取得・設定することができます。この適用対応表は以下のようになっています:

ドキュメント段落文字ピクチャー
O

定数 コメント
wk author ドキュメントの著者名を指定(文字列)
wk company ドキュメントに関連づけられる会社を指定します(文字列)
wk date creation ドキュメントの作成日(日付)を返します。この値は読み込みのみで、設定する事はできません。
wk date modified ドキュメントの最終更新日(日付)を返します。この値は読み込みのみであり、設定する事はできません。
wk dpi 内部でのピクセル<->ポイント変換に使用されるDPI(整数)。常に96です(読み込みのみ)
wk layout unit 値が整数あるいは実数として設定・取得された際の一部の属性の次元の単位を指定します。取り得る値は以下の通り:
  • wk unit cm (デフォルト): センチメートル
  • wk unit pt: ポイント
  • wk unit px: ピクセル
  • wk unit percent (wk line heightwk background size h / wk background size vに対してのみ使用可能)
  • wk unit mm: ミリメートル
  • wk unit inch: インチ
wk notes ドキュメントについてのコメントを指定します(文字列)
wk subject ドキュメントの題名を指定します(文字列)
wk title ドキュメントのタイトル(文字列)を指定します。デフォルトは"New 4D Write Pro Document"です。
wk version ドキュメントの内部4DWPバージョンを返します(実数)。この数値はWP GET ATTRIBUTESを使用してのみ読み込み可能です。設定することはできません。

これらの属性を使用するとテキストのフォントファミリー名、サイズ、スタイルを定義する事ができます。適応対応表は以下の通りです:

ドキュメント段落文字ピクチャー
O

定数 コメント
wk font FONT STYLE LISTコマンドによって返される、完全なフォント名とスタイル名を指定します。無効なフォント名を設定した場合、コマンドは何もしません。デフォルト値:"Times New Roman"
wk font bold テキストの太さを指定します(利用可能なフォントスタイルによります)。取り得る値は以下の通りです:
  • wk true を指定すると、選択された文字を太字フォントスタイルへと設定します。WP GET ATTRIBUTESコマンドを使用するとき、選択された文字のうち少なくとも1文字が太字フォントスタイルをサポートする場合、wk trueが返されます。
  • wk false (デフォルト)を指定すると、選択された文字から太字フォントスタイルを除去します。WP GET ATTRIBUTESコマンドを使用するとき、選択された文字がどれも太字フォントスタイルをサポートしない場合、wk falseが返されます。
wk font family wk fontで定義されたフォントファミリー名を指定します。デフォルトの値は"Times New Roman"です。
選択された文字に異なるフォントファミリープロパティが含まれる場合、WP GET ATTRIBUTESコマンドは空の文字列を返します。
wk font italic テキストの、イタリックスタイルを指定します(利用可能なフォントスタイルによります)。取り得る値は以下の通りです:
  • wk true は選択された文字をイタリック体あるいは斜体スタイルに設定します。WP GET ATTRIBUTESコマンドは選択された文字のうち少なくとも一つ以上の文字がイタリック体あるいは斜体フォントスタイルをサポートする場合、wk trueが返されます。
  • wk false (デフォルト)は選択された文字のうちイタリック体あるいは斜体フォントスタイルがある場合にはそれらを除去します。コマンドは選択された文字のうちイタリック体あるいは斜体フォントスタイルをサポートする文字がない場合、wk falseが返されます。
wk font size テキストのフォントサイズを指定します。取り得る値は以下の通りです(単位はポイントのみ):
  • 実際の値(デフォルト = 12)
  • 値と単位が連結されたCSS文字列。例: 12pt (12 ポイントを意味する)
wk text color テキストのカラーを指定します。取り得る値は以下の通りです:
  • CSSカラー("#010101" や "#FFFFFF" または "red")。デフォルトは文字列の場合"#000000"です。
  • 4Dカラー倍長整数値(OBJECT SET COLORコマンドを参照して下さい)
  • R、G、Bコンポーネントそれぞれの要素(0-255)を格納した倍長整数配列
wk text linethrough color テキストの打ち消し線のカラーを指定します。取り得る値は以下の通りです:
  • CSSカラー("#010101"や"#FFFFFF" または "red")
  • 4Dカラー倍長整数値(OBJECT SET COLORコマンドを参照してください)
  • R、G、B、コンポーネントそれぞれの要素(0-255)を格納した倍長整数配列

デフォルトは、文字列なら"currentColor"、あるいは倍長整数ならwk default です。

wk text linethrough style テキストの打ち消し線のスタイルを(あれば)指定します。取り得る値は以下の通りです:
  • wk none (デフォルト): 打ち消し線エフェクトはありません。
  • wk solid: 選択されたテキストに対して実線を描画します。
  • wk dotted: 選択されたテキストに対して点線を描画します。
  • wk dashed: 選択されたテキストに対して破線を描画します。
  • wk double: 選択されたテキストに対して二重線を描画します。
  • wk semi transparent: 選択されたテキストに対してグレーの線を描画します。他のスタイルと組み合わせる事が可能です。
  • wk word: 単語にのみ線を描画します(空白のスペースは描画しません)。他のスタイルと組み合わせる事が可能です。
wk text shadow color 選択されたテキストのシャドウカラーを指定します。取り得る値は以下の通りです:
  • CSSカラー("#010101" や "#FFFFFF" または "red")
  • 4Dカラー倍長整数値(OBJECT SET COLORコマンドを参照して下さい)
  • R、G、Bコンポーネントそれぞれの要素(0-255)を格納した倍長整数配列
  • wk transparent (デフォルト)

wk text shadow offset シャドウエフェクトのオフセットを指定します。取り得る値:
  • ポイント単位で指定されたサイズ。デフォルト値: 1pt
wk text transform テキスト内での大文字と小文字を指定します。取り得る値は以下の通り:
  • wk capitalize: 最初の文字は大文字に設定されます。
  • wk lowercase: 文字は小文字に設定されます。
  • wk uppercase: 文字は大文字に設定されます。
  • wk small uppercase: 文字はスモールキャップスに設定されます。
  • wk none (デフォルト): 変換なし
wk text underline color テキストの下線のカラーを指定します。取り得る値:
  • CSS カラー("#010101" や "#FFFFFF" または "red")
  • 4Dカラー倍長整数値(OBJECT SET COLORコマンドを参照して下さい)
  • R、G、Bコンポーネントそれぞれの要素(0-255)を格納した倍長整数配列

デフォルトは、文字列なら"currentColor"、あるいは倍長整数なら wk default です。

wk text underline style テキストの下線のスタイルを(あれば)指定します。取り得る値は以下の通りです:
  • wk none (デフォルト): 下線エフェクトはありません。
  • wk solid: 実線の下線を描画します。
  • wk dotted: 点線の下線を描画します。
  • wk dashed: 破線の下線を描画します。
  • wk double: 二重線の下線を描画します。
  • wk semi transparent: グレーの下線を描画します。他の線スタイルと組み合わせる事が可能です。
  • wk word: 単語にのみ下線を描画します(空白のスペースは描画しません)。他の線スタイルと組み合わせる事が可能です。
wk vertical align 要素の垂直揃えを設定します。文字、段落、ピクチャーに対して使用可能です。取り得る値は以下の通りです:
  • wk baseline (デフォルト): 要素のベースラインを親要素のベースラインと揃えます。
  • wk top: 要素の上を、行上で最も高い要素の上と揃えます。
  • wk bottom: 要素の下を、行上で最も低い要素の下と揃えます。
  • wk middle: 要素は親要素の中央に配置されます。
  • wk superscript: 要素を上付き文字として配置します。
  • wk subscript: 要素を下付き文字として配置します。
文字においては、wk topwk bottomwk baselineと同じ効果を持ちます。
段落においては、wk baselinewk superscriptwk subscriptwk topと同じ効果を持ちます。

高さ/幅属性を使用すると、段落や画像の高さと幅を設定することができます。適用の対応表は以下の通りです:

ドキュメント段落文字ピクチャー
OO

定数 コメント
wk height 要素の高さを設定します。高さのプロパティには、パッディング、境界線、マージンは含まれません。このプロパティは要素のパッディング、境界線、マージンの内側のエリアの高さを設定します。取り得る値は以下の通りです:
  • wk auto (デフォルト): 高さは要素の中身に基づいて決められます。
  • 定義されたサイズ: 実数値あるいは文字列値を使用して表現されたサイズです:
    • 実数: wk layout unitで設定された単位でのサイズ
    • 文字列: 値と単位が結合されたCSS文字列。例: 12ptは12ポイントを意味し、1.5cmは1.5センチメートルを意味します。最小値: 0pt、最大値: 10000pt

wk height属性は(定義されていれば)wk min heightによって上書きされます。

注: 現行の実装では、wk height定数はピクチャーに対してのみ使用可能です。

wk min height 要素の最小限の高さを設定します。これはwk heightプロパティの値がwk min heightプロパティより小さくなることを防ぎます。取り得る値は以下の通りです:
  • wk auto (デフォルト): 最小限の高さは要素の中身に基づいて決められます。
  • 定義されたサイズ: 実数値あるいは文字列値を使用して表現されたサイズ:
    • 実数: wk layout unitの単位でのサイズ
    • 文字列: 値と単位が連結されたCSS文字列。例:12ptは12ポイントを、1.5cmは1.5センチメートルを意味します。最小値: 0pt、最大値: 1000pt。

wk min heightの値はwk height属性を上書きします。

注: 現行の実装では、これはピクチャーに対してのみ使用可能です。

wk min width 要素の最小限の幅を設定します。これはwk widthプロパティの値がwk min widthプロパティより小さくなることを防ぎます。取り得る値は以下の通りです:
  • wk auto (デフォルト): 最小限の幅は要素の中身に基づいて決められます。
  • 定義されたサイズ: 実数値あるいは文字列値を使用して表現されたサイズ:
    • 実数: wk layout unitの単位でのサイズ
    • 文字列: 値と単位が連結されたCSS文字列。例:12ptは12ポイントを、1.5cmは1.5センチメートルを意味します。最小値: 0pt、最大値: 1000pt。

wk min widthの値はwk width属性を上書きします。

注: 現行の実装では、これはピクチャーに対してのみ使用可能です。

wk width 要素の幅を設定します。取り得る値は以下の通りです:
  • wk auto (デフォルト): 幅は、要素の中身に基づいて設定されます。
  • 定義されたサイズ: サイズは実数値あるいは文字列値を使用して表現されたサイズになります:
    • 実数: wk layout unitの単位でのサイズ。
    • 文字列: 値と単位が連結されたCSS文字列。例: 12ptは12ポイントを、1.5cmは1.5センチメートルを意味します。最小値: 0pt、最大値: 10000pt

wk width 属性は、wk min widthが定義されていればそれによって上書きされます。

注: 現行の実装では、wk width はピクチャーに対してのみ使用可能です。

画像  

画像属性を使用すると、エリア内に挿入されたピクチャーを管理する事ができます。適用の対応表は以下の通りです:

ドキュメント段落文字ピクチャー
O

定数 コメント
wk image 画像を指定します。取り得る値は以下の通りです:
  • 画像URL(文字列)。絶対パス、あるいはストラクチャーからの相対パスを指定できます。
  • ピクチャー変数またはフィールド

返される値(WP GET ATTRIBUTES): URI(ネットワークURLまたはデータURI)。ネットワークURLで参照されていない画像については最初のURLと同一ではないかもしれません(ネットワークURLのみが保存されます)。ローカルファイルのURLに対しては、画像ストリーム自身がドキュメントに保存されるので、返されるURLはデータURIとbase64にエンコードされた画像ストリームです。

wk image alternative text 画像が表示できない際の、画像の代替テキストを指定します。
wk vertical align 要素の垂直揃えを設定します。文字、段落、ピクチャーに対して使用可能です。取り得る値は以下の通りです:
  • wk baseline (デフォルト): 要素のベースラインを親要素のベースラインと揃えます。
  • wk top: 要素の上を、行上で最も高い要素の上と揃えます。
  • wk bottom: 要素の下を、行上で最も低い要素の下と揃えます。
  • wk middle: 要素は親要素の中央に配置されます。
  • wk superscript: 要素を上付き文字として配置します。
  • wk subscript: 要素を下付き文字として配置します。
文字においては、wk topwk bottomwk baselineと同じ効果を持ちます。
段落においては、wk baselinewk superscriptwk subscriptwk topと同じ効果を持ちます。

4D Write Proは主に二つのタイプのリストをサポートしています:

  • 順番付けのないリスト: リスト項目が中点と記されているリスト
  • 順番付けされているリスト: リスト項目が番号あるいは文字で記されているリスト

リスト属性を使用するとリストを設定し、異なるリスト項目フォントあるいはマーカーを設定する事ができます。適用の対応表は以下の通りです:

ドキュメント段落文字ピクチャー
O

定数 コメント
wk list font FONT STYLE LISTコマンドで返される、完全なフォント名を指定してリスト項目マーカーを表示するようにします(しかし段落のテキストは表示しません)。システムがフォント名を認識しない場合、その代理を使用します。無効なフォント名を設定した場合、コマンドは何もしません。デフォルト値: "Times"
wk list font family wk list fontによって定義されたフォントファミリー名を使用してリスト項目マーカーを表示します(しかし段落のテキストは表示しません)。デフォルト値は"Times New Roman"です。
wk list start number 並べられたリストの始まる値を設定します。取り得る値は以下の通りです:
  • wk auto (デフォルト): 始まる値は、前のリスト項目があればそれに応じます。
  • 整数値: 始まる値
wk list string format LTR 左から右への段落方向二対してのリスト項目マーカー文字列フォーマット。定義されると、リストのデフォルトのリスト項目マーカー文字列を上書きします。
  • 順番に並んでいないリスト: 文字列がリスト項目マーカーとして使用されます(通常は単一文字による文字列、例: "-")
  • 順番に並んでいるリスト: "#"文字を含んだ文字列。"#"は計算された数字や文字のプレースホルダーになります。デフォルトは"#."なので、例えばカレントのリスト項目番号が15でリストスタイルタイプが小数だった場合、リスト項目マーカー文字列は"15."になります。
wk list string format RTL 右から左への段落方向に対してのリスト項目マーカー文字列フォーマット。定義されると、リストのデフォルトのリスト項目マーカー文字列を上書きします。
  • 順番に並んでいないリスト: 文字列がリスト項目マーカーとして使用されます(通常は単一文字による文字列、例: "-")
  • 順 番に並んでいるリスト: "#"文字を含んだ文字列。"#"は計算された数字や文字のプレースホルダーになります。デフォルトは"#."なので、例えばカレントのリスト項目番号が 15でリストスタイルタイプが小数だった場合、リスト項目マーカー文字列は"15."になります。
wk list style image 順番に並んでいないリストにおいて、画像をリスト項目マーカーとして指定します。取り得る値は以下の通りです:
  • wk none (デフォルト): リスト項目マーカーは画像によっては定義されていません。
  • ローカルファイルが像URL(文字列)。絶対パスあるいはデータベースのリソースディレクトリからの相対パスが指定可能です。

返される値(WP GET ATTRIBUTES): URI(ネットワークURLまたはデータURI)。ネットワークURLで参照されていない画像については最初のURLと同一ではないかもしれません(ネッ トワークURLのみが保存されます)。ローカルファイルのURLに対しては、画像ストリーム自身がドキュメントに保存されるので、返されるURLはデータ URIとbase64にエンコードされた画像ストリームです。

wk list style image height リスト項目マーカーとして使用される画像の高さを設定します。取り得る値は以下の通りです:
  • wk auto (デフォルト): 高さは画像のサイズに基づいて決められます。
  • 定義されたサイズ: 実数値あるいは文字列値を使用して表現されたサイズ:
    • 実数: wk layout unitの単位でのサイズ
    • 文字列: 値と単位が連結されたCSS文字列。例: 12ptは12ポイントを、1.5cmは1.5センチメートルを意味します。最小値: 0pt、最大値: 1000pt。
wk list style type 順番付けされた、あるいは順番付けされていないリスト項目マーカーのタイプを指定します。取り得る値は以下の通りです:
  • wk disc (デフォルト)
  • wk circle
  • wk square
  • wk decimal: 1 2 3
  • wk decimal leading zero: 01 02 03
  • wk lower latin: a b c
  • wk lower roman: i ii iii iv
  • wk upper latin: A B C
  • wk upper roman: I II III IV
  • wk lower greek: α、β、γ、等
  • wk armenian
  • wk georgian
  • wk hebrew
  • wk hiragana
  • wk katakana
  • wk cjk ideographic
  • wk hollow square
  • wk diamond
  • wk club
  • wk decimal greek
  • wk custom: 順番付けされていないリストで"-"をデフォルトのリスト項目マーカーとして使用します。これは標準のリスト項目マーカーを変更する事なくwk list string format LTR または wk list string format RTLのリスト項目マーカーをカスタマイズするのに便利なスタイルです。
  • wk none

マージンとは、要素の境界線の外側にあるエリアのことで、透明なものです。以下の図は、"ボックス"の要素に対して設定可能な様々な要素の関係性を表しています:

Margin attributes can be applied to:

ドキュメント段落文字ピクチャー
OOO

定数 コメント
wk inside 選択されたエリアに複数の段落が含まれる場合、属性は、対応して被っている段落のプロパティに対してのみ適用することを指定します(範囲の外側は含まれません)。境界線、パッディング、マージン属性に対してのみ適用可能で、指定された属性に追加されなければなりません。WP SET ATTRIBUTESコマンドの例2を参照して下さい。
wk margin 要素の全てのマージンのサイズを指定します。取り得る値は以下の通りです:
  • 整数値あるいは文字列値を使用して表現されたサイズ:
    • 整数: wk layout unitの単位でのサイズ
    • 文字列: 値と単位が連結されたCSS文字列。例: 12ptは12ポイントを、1.5cmは1.5センチメートルを意味します。
  • wk none (デフォルト): 特にマージンを指定しません。
wk margin bottom 要素の下部のマージンのサイズを指定します。取り得る値は以下の通りです:
  • 整数値あるいは文字列値を使用して表現されたサイズ:
    • 整数: wk layout unitの単位でのサイズ
    • 文字列: 値と単位が連結されたCSS文字列。例: 12ptは12ポイントを、1.5cmは1.5センチメートルを意味します。
  • wk none (デフォルト): 特にマージンを指定しません。
wk margin left 要素の左のマージンのサイズを指定します。取り得る値は以下の通りです:
  • 整数値あるいは文字列値を使用して表現されたサイズ:
    • 整数: wk layout unitの単位でのサイズ
    • 文字列: 値と単位が連結されたCSS文字列。例: 12ptは12ポイントを、1.5cmは1.5センチメートルを意味します。
  • wk none (デフォルト): 特にマージンを指定しません。
wk margin right 要素の右のマージンのサイズを指定します。取り得る値は以下の通りです:
  • 整数値あるいは文字列値を使用して表現されたサイズ:
    • 整数: wk layout unitの単位でのサイズ
    • 文字列: 値と単位が連結されたCSS文字列。例: 12ptは12ポイントを、1.5cmは1.5センチメートルを意味します。
  • wk none (デフォルト): 特にマージンを指定しません。
wk margin top 要素の上部のマージンのサイズを指定します。取り得る値は以下の通りです:
  • 整数値あるいは文字列値を使用して表現されたサイズ:
    • 整数: wk layout unitの単位でのサイズ
    • 文字列: 値と単位が連結されたCSS文字列。例: 12ptは12ポイントを、1.5cmは1.5センチメートルを意味します。
  • wk none (デフォルト): 特にマージンを指定しません。
wk outside 選択されたエリアが複数の段落を含むとき、ある属性が対応する段落の外側のプロパティにのみ適用されることを指定します(内側には適用されません)。これは境界線、パッディング、そしてマージン属性に対してのみ指定可能で、特定の属性に対して追加される必要があります。WP SET ATTRIBUTESコマンドの例2を参照して下さい。

パッディングとは、要素の中身と要素の境界線の間の空白のことを指します。パッディングは要素の背景色に影響されます。

以下の図は、"ボックス"の要素に対して設定可能な様々な要素の関係性を表しています:

パッディング属性は、以下のように適用できます:

ドキュメント段落文字ピクチャー
OOO

定数 コメント
wk inside 選択されたエリアに複数の段落が含まれる場合、属性は、対応して被っている段落のプロパティに対してのみ適用することを指定します(範囲の外側は含まれません)。境界線、パッディング、マージン属性に対してのみ適用可能で、指定された属性に追加されなければなりません。WP SET ATTRIBUTESコマンドの例2を参照して下さい。
wk outside 選択されたエリアが複数の段落を含むとき、ある属性が対応する段落の外側のプロパティにのみ適用されることを指定します(内側には適用されません)。これは境界線、パッディング、そしてマージン属性に対してのみ指定可能で、特定の属性に対して追加される必要があります。WP SET ATTRIBUTESコマンドの例2を参照して下さい。
wk padding 要素の全てのサイドのパッディングを指定します。取り得る値は以下の通りです:
  • 整数値あるいは文字列値を使用して表現されるサイズ:
    • 整数: wk layout unitの単位でのサイズ
    • 文字列: 値と単位が連結されたCSS文字列。例:12ptは12ポイントを、1.5cmは1.5センチメートルを意味します。
  • wk none (デフォルト): 特定のパッディングを指定しません。
wk padding bottom 要素の下部のパッディングを指定します。取り得る値は以下の通りです:
  • 整数値あるいは文字列値を使用して表現されるサイズ:
    • 整数: wk layout unitの単位でのサイズ
    • 文字列: 値と単位が連結されたCSS文字列。例:12ptは12ポイントを、1.5cmは1.5センチメートルを意味します。
  • wk none (デフォルト): 特定のパッディングを指定しません。
wk padding left 要素の左側のパッディングを指定します。取り得る値は以下の通りです:
  • 整数値あるいは文字列値を使用して表現されるサイズ:
    • 整数: wk layout unitの単位でのサイズ
    • 文字列: 値と単位が連結されたCSS文字列。例:12ptは12ポイントを、1.5cmは1.5センチメートルを意味します。
  • wk none (デフォルト): 特定のパッディングを指定しません。
wk padding right 要素の右側のパッディングを指定します。取り得る値は以下の通りです:
  • 整数値あるいは文字列値を使用して表現されるサイズ:
    • 整数: wk layout unitの単位でのサイズ
    • 文字列: 値と単位が連結されたCSS文字列。例:12ptは12ポイントを、1.5cmは1.5センチメートルを意味します。
  • wk none (デフォルト): 特定のパッディングを指定しません。
wk padding top 要素の上部のパッディングを指定します。取り得る値は以下の通りです:
  • 整数値あるいは文字列値を使用して表現されるサイズ:
    • 整数: wk layout unitの単位でのサイズ
    • 文字列: 値と単位が連結されたCSS文字列。例:12ptは12ポイントを、1.5cmは1.5センチメートルを意味します。
  • wk none (デフォルト): 特定のパッディングを指定しません。

段落  

段落属性を使用すると段落内でのテキストの配置のためのプロパティを定義する事ができます。適用の対応表は以下の通りです:

ドキュメント段落文字ピクチャー
O

定数 コメント
wk direction 段落のテキストの方向を指定します。取り得る値は以下の通りです:
  • wk left to right (デフォルト)
  • wk right to left
wk line height 行間スペースを指定します。取り得る値は以下の通り:
  • wk normal (デフォルト): テキストサイズに基づいた値を使用
  • 整数値あるいは文字列値で表現された高さを使用:
    • 整数値: wk layout unit の単位での高さ
    • 文字列値:値と単位が結合されたCSS文字列。例: 12ptは12ポイントを、1.5cmは1.5センチメートルを意味します。相対値(パーセンテージ%)はサポートされています。
wk tab stop offsets 段落のタブストップを指定します。取り得る値は以下の通りです:
  • スカラー値(デフォルトは35.45pt): 段落全体のデフォルトのオフセットです。WP GET ATTRIBUTESコマンドは最後に使用されたオフセットを返します(最後の絶対オフセットより前のオフセットについては、デフォルトの相対オフセットになります)。
  • タブ値の配列: 絶対値の順番付けされたリストで、左のマージンから始まります。最後の値によって定義されたタブオフセットは、段落内で入力される追加のタブ文字にて繰り返し使用されます。タブオフセットが段落の幅より大きい場合、テキストは次の行に移行し、最初のタブ値から開始されます。配列内の値が以前の値より小さい場合、それは無視されます。

注: 同じ呼び出しにおいて異なる属性に対して配列とスカラーを同時に使用することはできません。

値はCSS文字列(デフォルト)またはwk layout unitでの単位を使用する実数値で表現されます。最大値は1000ptです。

wk tab stop types 段落でのタブストップタイプを指定します。取り得る値は以下の通りです:
  • wk left (デフォルト): テキストはタブストップから右側に拡張されます。
  • wk right: タブスペースが埋まるまで、テキストはタブストップから左側に拡張されます。
  • wk center: テキストはタブストップにて中央に配置されます。
  • wk decimal: 小数点より前のテキストは左に拡張され、小数点より後のテキストは右に拡張されます。
  • wk bar: 指定された位置に垂直の線がおかれます。
  • タブストップ値の配列(タブストップが配列を通して定義されていた場合)
wk text align 段落内でのテキストの行揃えを指定します。取り得る値は以下の通りです:
  • wk left (デフォルト)
  • wk right
  • wk justify
  • wk center
wk text indent 段落の最初の行のインデントを指定します。取り得る値は以下の通りです:
  • 実数: wk layout unit.の単位でのサイズ。デフォルトは0です。
  • 文字列: 値と単位が連結されたCSS文字列。例: 12ptは12ポイントを、1.5cmは1.5センチメートルを意味します。最小値: 0pt、最大値: 10000pt
wk vertical align 要素の垂直揃えを設定します。文字、段落、ピクチャーに対して使用可能です。取り得る値は以下の通りです:
  • wk baseline (デフォルト): 要素のベースラインを親要素のベースラインと揃えます。
  • wk top: 要素の上を、行上で最も高い要素の上と揃えます。
  • wk bottom: 要素の下を、行上で最も低い要素の下と揃えます。
  • wk middle: 要素は親要素の中央に配置されます。
  • wk superscript: 要素を上付き文字として配置します。
  • wk subscript: 要素を下付き文字として配置します。
文字においては、wk topwk bottomwk baselineと同じ効果を持ちます。
段落においては、wk baselinewk superscriptwk subscriptwk topと同じ効果を持ちます。

スタイルシート属性を使用すると指定されたスタイルシートを管理する事ができます。適用の対応表は以下の通りです:

ドキュメント段落文字ピクチャー
OO

定数 コメント
wk new line style sheet 段落に新たな行を追加する際のスタイルシートを指定します。取り得る値は以下の通りです:
  • 既存のスタイルシート名
  • wk none (デフォルト)
wk style sheet 選択された要素に対してカレントのスタイルシートを指定します。取り得る値は以下の通りです:
  • wk none (デフォルト)
  • 既存のスタイルシート名



参照 

WP GET ATTRIBUTES
WP RESET ATTRIBUTES
WP SET ATTRIBUTES

 
プロパティ 

プロダクト: 4D
テーマ: 4D Write Proランゲージ

 
履歴 

初出: 4D v15 R4

 
ARTICLE USAGE

4D Write Proリファレンス ( 4D v16)