4D v15

PV GET BORDER ROW RANGES

ホーム

 
4D v15
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 境界線カラーの配列

説明   

4D v14 R4 から導入

テーマ: PV Borders

新しいPV GET BORDER ROW RANGES コマンドは同じ上側の枠線スタイルを共有するセルの範囲のリストを返します(枠線スタイルは、タイプとカラーの二つの要素からなります)。

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

対応する枠線スタイルは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 Color to index コマンドを参照して下さい。

このコマンドは、新しい PV GET BORDER COLUMN RANGES コマンドと組み合わせることで、エリアの枠線の完全な定義を取得することができます。これは、例えば4D ViewエリアをMSエクセルフォーマットに書き出したいときなどに有効です。

注: コマンドによって返される範囲のリストは、その範囲がどのように定義されたかによって異なってきます。例えば、範囲(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
テーマ: 4D View

 
履歴 

 
ARTICLE USAGE

4D v15 - アップグレードリファレンス(標準版) ( 4D v15)