4D View v16

PV GET BORDER ROW RANGES

ホーム

 
4D View v16
PV GET BORDER ROW RANGES

PV GET BORDER ROW RANGES  


 

PV GET BORDER ROW RANGES ( area ; left ; top ; right ; bottom ; borderTypes ; borderColors ) 
引数   説明
area  倍長整数 in 4D View エリア
left  倍長整数配列 in 左端のセルの列番号の配列
top  倍長整数配列 in 上端のセルの行番号の配列
right  倍長整数配列 in 右端のセルの列番号の配列
bottom  倍長整数配列 in 下端のセルの行番号の配列
borderTypes  倍長整数配列 in 境界線型の配列
borderColors  倍長整数配列 in 境界線カラーの配列

説明   

PV GET BORDER ROW RANGES コマンドは、上側の境界線スタイルが同じセルの範囲を表すリストを返します(境界線スタイルは型とカラーから構成されます)。

それぞれの範囲は、lefttopright そしてbottom という4つの同期した配列を通して返されます。各配列の要素は、それぞれ範囲の左端、上端、右端、下端のセル番号を表します。

それぞれに対応する境界線スタイルは、borderTypesborderColors 配列引数に返されます:

  • borderTypes 引数の値は、PV Border style テーマの定数と比較することが可能です:
    定数
    pv border style 1 倍長整数 1
    pv border style 111 倍長整数 7
    pv border style 112 倍長整数 9
    pv border style 2 倍長整数 2
    pv border style 211 倍長整数 8
    pv border style 212 倍長整数 10
    pv border style 222 倍長整数 11
    pv border style 232 倍長整数 12
    pv border style 3 倍長整数 3
    pv border style 4 倍長整数 4
    pv border style 5 倍長整数 5
    pv border style 6 倍長整数 6
    pv border style half 倍長整数 14
    pv border style none 倍長整数 0
    pv border style quarter 倍長整数 13
  • borderColors 引数の値は、BGR型の倍長整数です。詳細な情報に関しては、PV Color to index コマンドを参照して下さい。

このコマンドは、PV GET BORDER COLUMN RANGES コマンドと合わせて使用する事でエリア内の境界線の完全な定義を取得することができます。これは、4D Viewエリアを例えばMS Excelフォーマットなどに書き出すときに便利です。

注: コマンドによって返される範囲のリストは、その範囲がどのように定義されたかによって異なってきます。例えば、範囲(4A;4E)を選択している状態で水平な線を描画した場合、コマンドはその範囲(4A;4E)に対応した単一の値のみを返します。それに対し、行4に対して水平な線を描画し、それを列A~E に対してループさせた場合、コマンドはそれぞれの描画に対応して5つの値を返します。描画の結果は見た目上では全く同じですが、内部で保存されている情報 は異なるという事です。

例題  

エリア内に、以下の様に枠線が配置されていたとします:



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

 PV GET BORDER ROW RANGES(myArea;LeftArray;TopArray;RightArray;BottomArray;BorderTypeArray;BorderColorArray)


四つの範囲が検出され、その結果配列内には以下の様な値が格納されて返されます:

LeftArrayTopArrayRightArrayBottomArrayBorderTypeArrayBorderColorArray
2333315597568
2535315597568
3848939168
29492255



参照 

PV GET BORDER COLUMN RANGES

 
プロパティ 

プロダクト: 4D View
テーマ: PV罫線
番号: 705089

 
履歴 

初出: 4D View v14 R4

 
ARTICLE USAGE

4D View ( 4D View v16)