EnumPathElements

擷取, 頁面操作

描述

列舉頁面上跨越所有內容層的每個向量路徑物件。每個路徑建構與繪製序列都會被提取為一筆 Kind 為 ekPath 的 TPDFlibPageElement 記錄,附上涵蓋曲線控制點的邊界方塊、線段數、封閉旗標與繪製運算子名稱。每個元素也會取得 ElementID 快照,供之後的詳細查詢使用

語法

Delphi

Procedure TPDFlib.EnumPathElements(Page: Integer;
  Var Elements: Array Of TPDFlibPageElement;
  Var ElemIndex, TotalCount: Integer);

參數

Page要列舉的一起始頁碼
Elements呼叫端配置的 TPDFlibPageElement 陣列,用來接收記錄;只會儲存陣列容量所能容納的記錄數
ElemIndex輸入輸出索引;進入時傳 0,離開時持有儲存在 Elements 中的記錄數
TotalCount輸入輸出計數器;離開時持有找到的路徑總數,即使超過 Elements 的容量亦然

備註

座標以頁面元素輔助例程所用的左上原點座標系統傳回。比較 ElemIndex 與 TotalCount 可偵測截斷,或呼叫兩次並依第一趟的結果設定陣列大小

如需同時涵蓋文字、影像與著色放置的較高階列舉,請參閱 EnumPageElements

範例

Total:= 0;
SetLength(Elements, 0);
PDF.EnumPathElements(1, Elements, Count, Total);
SetLength(Elements, Total);
Count:= 0; Total:= 0;
PDF.EnumPathElements(1, Elements, Count, Total);