API version 1

- ‐

setBorderColor

範囲内のセルの罫線の色を一括して変更します。

SpreadRangeオブジェクトが示す範囲の外枠線(上、下、左、右)と範囲内の横線、縦線のどこの設定するかを指定できます。

SpreadRangeオブジェクトの外側の罫線の色を変更する場合、接しているセルのスタイルの罫線の色はクリアされます。

例:
B2:D4の範囲に対してメソッドを実行した場合
BORDER_TOPが指定されている場合、B1:D1のセルの下罫線の色がクリアされます
BORDER_LEFTが指定されている場合、A2:A4のセルの右罫線の色がクリアされます。
BORDER_RIGHTが指定されている場合、E2:E4のセルの左罫線の色がクリアされます。
BORDER_BOTTOMが指定されている場合、B5:D5のセルの上罫線の色がクリアされます。

罫線の種類は setBorderIndex メソッドで変更できます。

呼出形式一覧

呼出形式

説明

void setBorderColor(borderColor[, integer borderFlags])

範囲内のセルの罫線の色を一括してborderColorに変更します。

戻り値一覧

戻り値

説明

void

なし

引数一覧

引数

説明

borderColor

設定する罫線の色

borderFlags

変更する罫線の場所。省略時はBORDER_TOP+BORDER_BOTTOM+BORDER_LEFT+BORDER_RIGHTとなります。
以下の値の組み合わせを指定します。

定数

説明

BORDER_TOP

1

範囲の上の罫線(外枠線の上辺)

BORDER_BOTTOM

2

範囲の下の罫線(外枠線の下辺)

BORDER_LEFT

4

範囲の左の罫線(外枠線の左辺)

BORDER_RIGHT

8

範囲の右の罫線(外枠線の右辺)

BORDER_HORIZONTAL

16

範囲内のセルの上下の罫線(範囲内の横線)

BORDER_VERTICAL

32

範囲内のセルの左右の罫線(範囲内の縦線)

例外

なし

関連項目



使用例 CRSダウンロード

Form SpreadRange_methods {
   x = 0;
   y = 0;
   width = 800;
   height = 600;

   Spread spread1 {
           x = 8;
           y = 8;
           width = 640;
           height = 440;
           maxColumns = 20;
           maxRows = 20;

           var s = new SpreadStyle;

           s.topBorderIndex = SpreadStyle.BORDER_THIN;
           s.leftBorderIndex = SpreadStyle.BORDER_THIN;
           s.rightBorderIndex = SpreadStyle.BORDER_THIN;
           s.bottomBorderIndex = SpreadStyle.BORDER_THIN;

           range("B2:E5").style = s;

   }

   Button button1 {
           x = 664;
           y = 32;
           width = 112;
           height = 32;
           title = "実行";
           function onTouch(e) {
                   #B2:E5の外枠の罫線の種類を中太線に変更します
                   ^.spread1.range("B2:E5").setBorderIndex( SpreadStyle.BORDER_MEDIUM);

                   #B2:E5の内側の水平罫線の色を赤に変更します
                   ^.spread1.range("B2:E5").setBorderColor(Color.RED, SpreadRange.BORDER_HORIZONTAL);
           }
   }
}