RowsCopy

[설명]

한 DataWindow control (또는 DataStore object)에서 다른 곳으로 특정 범위의 row를 복사하거나, 단일 DataWindow control (또는 DataStore object)내의 한 버퍼에서 다른 버퍼로 특정 범위의 row를 복사한다.

[적용]

DataWindow controls, DataStore objects, child DataWindows

[문법]

dwcontrol.RowsCopy ( startrow, endrow, copybuffer, targetdw, beforerow, targetbuffer )

[Argument]

dwcontrol	row를 복사하려는 DataWindow control, DataStore, 또는 child DataWindow의 이름
startrow	복사하려는 첫 번째 row의 번호 (long 값)
endrow	복사하려는 마지막 row의 번호 (long 값)
copybuffer	row를 복사하려는 버퍼를 명시한 dwBuffer 열거형 데이터 타입의 값: · Primary! · Delete! · Filter!
targetdw	row를 복사하려는 DataWindow control 이나 DataStore의 이름. targetdw는 동일한 DataWindow control (또는 DataStore object)도 가능하고 다른 DataWindow control (또는 DataStore object)도 가능하지만, child DataWindow는 불가능하다.
beforerow	복사된 row가 삽입되기 직전의 row 번호 (long 값). 마지막 row 이후에 삽입하려면, 존재하는 row의 수보다 큰 임의의 값을 사용한다.
targetbuffer	복사된 row에관한 대상 버퍼를 명시하는 dwBuffer 열거형 데이터 타입의 값: · Primary! · Delete! · Filter!

[Return 값]

Integer.

처리에 성공하면 1을 리턴하고 에러가 발생하면 -1을 리턴한다. argument 값중에 NULL이 있으면, RowCopy 함수는 NULL을 리턴한다.

[용법]

RowsCopy 함수를 사용할 때, primary 버퍼로 복사된 row의 상태는 NewModified!이므로, Update를 요청하면 PowerBuilder는 SQL INSERT 문장을 DBMS에 보낼 것이다.

RowsCopy 함수를 사용할 때, DataWindow나 DataStore내의 drop-down DataWindow에 관한 자료는 InsertRow 함수를 호출할 때처럼 자동으로 retrieve 되지 않으므로 반드시 대상 DataWindow내의 child DataWindow에 관하여 Retrieve 함수를 호출하여야 한다.

RowsCopy 함수의 용도는 다음과 같다:

· 기존의 데이터를 바탕으로 새로운 row를 생성할 수 있도록 하나이상의 row을 복사본을 만든다

· 선택한 row들을 다른 DataWindow로 복사하여 특정 범위의 row를 인쇄한다

[예제]

* 다음 문장은 dw_1의 현재 row부터 모든 row를 dw_2의 primary 버퍼에 복사한다.

dw_1.RowsCopy(dw_1.GetRow(), dw_1.RowCount(), Primary!, dw_2, 1, Primary!)