VP SET BORDER

4D v19

VP SET BORDER


VP SET BORDER ( rangeObj ; borderStyleObj ; borderPosObj )

引数	型	説明
rangeObj	オブジェクト	レンジオブジェクト
borderStyleObj	オブジェクト	境界線の線スタイルを格納したオブジェクト
borderPosObj	オブジェクト	境界線の位置を格納したオブジェクト

説明

VP SET BORDER コマンドはrangeObj 引数で定義されたレンジにborderStyleObj および borderPosObj 引数で定義される境界線スタイルを適用します。

rangeObj 引数には、境界線スタイルを適用したいセルのレンジを渡します。rangeObj 引数に複数のセルが含まれる場合、VP SET BORDER で適用される境界線は、rangeObj のレンジ全体を一つのセルとして適用されます(これに対し、VP SET CELL STYLE コマンドではrangeObj 引数のレンジの個々のセルに対し境界線が適用されます)。スタイルシートがすでに適用されている場合、VP SET BORDER コマンドはrangeObj のレンジに対してすでに適用されていた境界線設定を上書きします。

borderStyleObj 引数を使用すると、境界線の線のスタイルを定義することができます。borderStyleObj 引数は、以下のプロパティをサポートしています:

プロパティ	型	詳細	取りうる値
color	テキスト	境界線のカラーを定義します。デフォルト = black	CSSカラー"#rrggbb"シンタックス(推奨されるシンタックス)、CSSカラー"rgb(r,g,b)"シンタックス(別シンタックス)、CSSカラー名(別シンタックス)
style	倍長整数	境界線のスタイルを定義します。デフォルト = empty	vk line style dash dot、vk line style dash dot dot、vk line style dashed、vk line style dotted、vk line style double、vk line style empty、vk line style hair、vk line style medium、vk line style medium dash dot、vk line style medium dash dot dot、vk line style medium dashed、vk line style slanted dash dot、vk line style thick、vk line style thick

borderStyleObj 引数の境界線スタイルの位置(つまりどこに境界線が適用されるか)をborderPosObj 引数で定義することができます:

プロパティ	型	詳細
all	ブール	境界線スタイルは全ての境界線に適用されます。
left	ブール	境界線スタイルは左の境界線に適用されます。
top	ブール	境界線スタイルは上の境界線に適用されます。
right	ブール	境界線スタイルは右の境界線に適用されます。
bottom	ブール	境界線スタイルは下の境界線に適用されます。
outline	ブール	境界線スタイルは外側の境界線にのみ適用されます。
inside	ブール	境界線スタイルは内側の境界線にのみ適用されます。
innerHorizontal	ブール	境界線スタイルは内側の縦線の境界線にのみ適用されます。
innerVertical	ブール	境界線スタイルは内側の横線の境界線にのみ適用されます。

例題 1

以下のコードを実行すると:

 $border:=New object("color";"red";"style";vk line style thick)

 $option:=New object("outline";True)

 VP SET BORDER(VP Cells("ViewProArea";1;1;3;3);$border;$option)

レンジ全体の周囲に対して、以下のような境界線を付加します:

例題 2

以下のコードを実行すると:

  // VP SET BORDER を使用して境界線を設定

 $border:=New object("color";"red";"style";vk line style thick)

 $option:=New object("outline";True)

 VP SET BORDER(VP Cells("ViewProArea";1;1;3;3);$border;$option)

 

  // VP SET CELL STYLE を使用して境界線を設定

 $cellStyle:=New object

 $cellStyle.borderBottom:=New object("color";"blue";"style";vk line style thick)

 $cellStyle.borderRight:=New object("color";"blue";"style";vk line style thick)

 VP SET CELL STYLE(VP Cells("ViewProArea";4;4;3;3);$cellStyle)

VP SET BORDER で境界線を設定した場合とVP SET CELL STYLE コマンドで境界線を設定した場合の違いが分かりやすく表示されます。

参照

VP SET CELL STYLE