BeginPageUpdate

페이지 레이아웃

설명

현재 선택한 페이지에서 일괄 그리기 트랜잭션을 시작합니다. 이후 그리기 호출(텍스트, 경로, 이미지, 주석)은 하나의 배치로 버퍼링되고 일치하는 EndPageUpdate 호출 시 페이지의 콘텐츠 스트림으로 플러시됩니다

많은 작은 그리기 기본 요소로 복잡한 페이지를 구성할 때, 특히 이전에 저장한 페이지를 다시 열어 편집할 때 사용합니다. 일괄 처리는 호출마다 발생하는 콘텐츠 스트림 직렬화 오버헤드를 피하고 결과 페이지 콘텐츠 스트림을 간결하고 올바른 형식으로 유지합니다

구문

Delphi

Function TPDFlib.BeginPageUpdate: Integer;

ActiveX

Function PDFlib::BeginPageUpdate() As Long

DLL

int DLBeginPageUpdate(int InstanceID);

반환 값

비고

모든 BeginPageUpdate 호출은 같은 페이지에서 EndPageUpdate 호출 하나와 짝을 이루어야 합니다. NewPage로 방금 만든 새 페이지에 콘텐츠를 추가할 때는 페이지가 이미 "open for writing" 상태이므로 이 쌍이 반드시 필요하지는 않습니다. 이 쌍은 이전에 닫힌 페이지를 다시 열어 수정할 때 반드시 필요합니다(EndPage 이후 또는 문서 로드 이후)

중첩 호출은 지원되지 않습니다 — 편집할 다른 페이지를 열기 전에 EndPageUpdate를 호출합니다

예제

// Add a stamp on an existing page of a loaded document
PDF.LoadFromFile('contract.pdf', '');
PDF.SelectPage(1);
PDF.BeginPageUpdate;
  PDF.SetTextColor(0.8, 0, 0);
  PDF.SetFontSize(48);
  PDF.PrintText(150, 400, 'DRAFT');
PDF.EndPageUpdate;
PDF.SaveToFile('contract-stamped.pdf');

참고 항목

EndPageUpdate, SelectPage, NewPage, EndPage