GetTextBlockCharContentLocation

Text, Extraktion, Inhaltsströme, Diagnostik

Beschreibung

Gibt die stabile Content-Stream-Position und den kodierten Quellbyte-Bereich zurück, die einem extrahierten Zeichen zugeordnet sind

Syntax

Delphi

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

Parameter

TextBlockListID	Handle, das von `ExtractPageTextBlocks` zurückgegeben wurde
Index	1-basierter Textblockindex
CharIndex	1-basierte UTF-16-Code-Unit-Position innerhalb des Blocktexts
ContentLayer	1-basierte `/Contents`-Seitenebene, oder 0 für verschachtelten Inhalt
StreamObjectNumber	Objektnummer des umschließenden Streams, oder 0 für einen direkten Stream
StreamGeneration	Generierungsnummer des umschließenden Streams
InstructionIndex	0-basierter Anweisungsindex im dekodierten Inhaltsprogramm
OperandIndex	0-basierter Index des Textstring-Operanden
ArrayElementIndex	0-basiertes `TJ`-Arrayelement, oder -1 für einen direkten String-Operanden
SourceByteOffset	0-basierter Offset im dekodierten Stringwert, oder -1, wenn kein sicher adressierbarer Bereich existiert
SourceByteLength	Anzahl der kodierten Quellbytes für die Quellglyphe, oder 0, wenn kein sicher adressierbarer Bereich existiert
Flags	Bitweise Content-Location-Flags, wie unten beschrieben

Rückgabewerte

1	Ein Positionsdatensatz wurde zurückgegeben, einschließlich synthetischer oder schreibgeschützter Datensätze
0	Handle, Blockindex oder Zeichenindex ist ungültig

Flags

`PDF_TEXT_CHAR_CONTENT_LOCATION_VALID`	Der Bytebereich bezeichnet einen Content-String, vorbehaltlich etwaiger Schreibschutz-Flags
`PDF_TEXT_CHAR_CONTENT_LOCATION_GENERATED`	Das Zeichen wurde beim Layout erzeugt und hat keine Quellbytes
`PDF_TEXT_CHAR_CONTENT_LOCATION_LIGATURE`	Mehrere extrahierte UTF-16-Positionen teilen sich einen Quellglyphenbereich
`PDF_TEXT_CHAR_CONTENT_LOCATION_ACTUALTEXT`	Das Zeichen stammt aus einer `/ActualText`-Ersetzung und ist schreibgeschützt
`PDF_TEXT_CHAR_CONTENT_LOCATION_NESTED`	Das Zeichen stammt aus verschachteltem Form-Inhalt und ist schreibgeschützt
`PDF_TEXT_CHAR_CONTENT_LOCATION_CROSS_LAYER`	Operand und Textanzeige-Operator überschreiten Seiteninhaltsebenen und sind schreibgeschützt
`PDF_TEXT_CHAR_CONTENT_LOCATION_TRANSCODED`	Der Quellstring wurde vor der Schriftzuordnung transkodiert, sodass dekodierte Offsets seine ursprünglichen Bytes nicht sicher adressieren können

Anmerkungen

Offsets adressieren dekodierte Bytes von Schrift-encodierten Zeichenfolgen statt Unicode-Text

Supplementäre Zeichen und Ligaturerweiterungen können für mehr als eine UTF-16-Position denselben Quellbereich zurückgeben

Verwenden Sie ReplaceTextBlockCharSourceBytes nur, wenn das Gültigkeitsflag gesetzt ist und keines der Schreibschutzflags vorliegt

Die Ortssuche verwendet die bei der Extraktion erfassten Spannen und analysiert den Seiteninhalt nicht neu