VP SET BORDER

VP SET BORDER ( rangeObj : Object ; borderStyleObj : Object ; borderPosObj : Object )

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

説明

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

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

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

プロパティ	型	説明	とりうる値
color	text	境界線のカラーを定義します。 デフォルト = black	CSSカラー "#rrggbb" シンタックス (推奨シンタックス)、CSSカラー "rgb(r,g,b)" シンタックス (代替シンタックス)、CSSカラーネーム (代替シンタックス)
style	Integer	境界線のスタイルを定義します。 デフォルト = 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 thin

borderStyleObj の境界線スタイルの位置 (どこに境界線を引くか) は borderPosObj 引数で定義します:

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

例題 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 と VP SET CELL STYLE で境界線を設定した場合の違いを示します:

// 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 CELL STYLE