API version 1

- ‐

setBorderIndex

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

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

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

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

罫線の色は setBorderColor メソッドで変更できます。

呼出形式一覧

呼出形式

説明

void setBorderIndex(integer borderType[, integer borderFlags])

範囲内のセルの罫線の種類を一括してborderTypeに変更します。

戻り値一覧

戻り値

説明

void

なし

引数一覧

引数

説明

borderType

罫線の種類

定数値

説明

BORDER_NONE

0:罫線なし。描画優先順位:14

BORDER_THIN

1:幅1ピクセルの実線。描画優先順位:8

BORDER_MEDIUM

2:幅2ピクセルの実線。描画優先順位:3

BORDER_DASHED

3:幅1ピクセルの間隔が狭い破線。描画優先順位:9

BORDER_DOTTED

4:幅1ピクセルの間隔が広い破線。描画優先順位:10

BORDER_THICK

5:幅3ピクセルの実線。描画優先順位:2

BORDER_DOUBLE

6:二重線。描画優先順位:1

BORDER_HAIR

7:幅1ピクセルの点線。描画優先順位:13

BORDER_MEDIUMDASHED

8:幅2ピクセルの破線。描画優先順位:4

BORDER_DASHDOT

9:幅1ピクセルの一点鎖線。描画優先順位:11

BORDER_MEDIUMDASHDOT

10:幅2ピクセルの一点鎖線。描画優先順位:5

BORDER_DASHDOTDOT

11:幅1ピクセルの二点鎖線。描画優先順位:12

BORDER_MEDIUMDASHDOTDOT

12:幅2ピクセルの二点鎖線。描画優先順位:7

BORDER_SLANTDASHDOT

13:幅2ピクセルの鎖線。描画優先順位:6

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);
           }
   }
}