GetTextBlockCharContentLocation

Văn bản, Trích xuất, Luồng nội dung, Chẩn đoán

Mô tả

Trả về vị trí content-stream ổn định và vùng byte nguồn đã mã hóa gắn với một ký tự trích xuất

Cú pháp

Delphi

Function TPDFlib.GetTextBlockCharContentLocation(TextBlockListID, Index,
  CharIndex: Integer; Out ContentLayer, StreamObjectNumber,
  StreamGeneration, InstructionIndex, OperandIndex, ArrayElementIndex,
  SourceByteOffset, SourceByteLength, Flags: Integer): Integer;

Tham số

TextBlockListID	Handle được trả về bởi `ExtractPageTextBlocks`
Index	Chỉ số khối văn bản tính từ 1
CharIndex	Vị trí đơn vị mã UTF-16 tính từ 1 bên trong văn bản khối
ContentLayer	Lớp `/Contents` của trang tính từ 1, hoặc 0 cho nội dung lồng nhau
StreamObjectNumber	Số đối tượng của stream chứa nó, hoặc 0 cho stream trực tiếp
StreamGeneration	Số thế hệ của stream chứa nó
InstructionIndex	Chỉ số lệnh tính từ 0 trong chương trình nội dung đã giải mã
OperandIndex	Chỉ số toán hạng chuỗi văn bản tính từ 0
ArrayElementIndex	Phần tử mảng `TJ` tính từ 0, hoặc -1 cho toán hạng chuỗi trực tiếp
SourceByteOffset	Độ dịch tính từ 0 trong giá trị chuỗi đã giải mã, hoặc -1 khi không tồn tại vùng dữ liệu nào có thể định vị an toàn
SourceByteLength	Số byte nguồn đã mã hóa cho glyph nguồn, hoặc 0 khi không tồn tại vùng dữ liệu nào có thể định vị an toàn
Flags	Các cờ vị trí nội dung theo bit được mô tả dưới đây

Giá trị trả về

1	Một bản ghi vị trí đã được trả về, bao gồm cả bản ghi tổng hợp hoặc chỉ đọc
0	Handle, chỉ số khối hoặc chỉ số ký tự không hợp lệ

Cờ

`PDF_TEXT_CHAR_CONTENT_LOCATION_VALID`	Vùng byte nhận diện một chuỗi nội dung, tùy thuộc các cờ chỉ đọc
`PDF_TEXT_CHAR_CONTENT_LOCATION_GENERATED`	Ký tự được sinh ra trong lúc bố cục và không có byte nguồn
`PDF_TEXT_CHAR_CONTENT_LOCATION_LIGATURE`	Nhiều vị trí UTF-16 trích xuất dùng chung một vùng glyph nguồn
`PDF_TEXT_CHAR_CONTENT_LOCATION_ACTUALTEXT`	Ký tự đến từ một phép thay thế `/ActualText` và là chỉ đọc
`PDF_TEXT_CHAR_CONTENT_LOCATION_NESTED`	Ký tự đến từ nội dung Form lồng nhau và là chỉ đọc
`PDF_TEXT_CHAR_CONTENT_LOCATION_CROSS_LAYER`	Toán hạng và toán tử hiển thị văn bản vượt qua các lớp nội dung trang và là chỉ đọc
`PDF_TEXT_CHAR_CONTENT_LOCATION_TRANSCODED`	Chuỗi nguồn đã bị chuyển mã trước khi ánh xạ phông, nên các offset đã giải mã không thể định vị các byte gốc của nó một cách an toàn

Ghi chú

Các offset trỏ tới các byte chuỗi đã giải mã theo mã hóa phông chứ không phải văn bản UnicodeKý tự bổ sung và phần mở rộng ligature có thể trả về cùng một vùng nguồn cho nhiều hơn một vị trí UTF-16Chỉ dùng

Ký tự bổ sung và phần mở rộng ligature có thể trả về cùng một vùng nguồn cho nhiều hơn một vị trí UTF-16

ReplaceTextBlockCharSourceBytes khi cờ hợp lệ được đặt và không có cờ chỉ đọc nào hiện diệnViệc tra cứu vị trí dùng các khoảng ghi nhận tại thời điểm trích xuất và không phân tích lại nội dung trang

Tra vị trí dùng span từ lúc trích xuất và không parse lại nội dung trang