DAGetTextBlockCharContentLocation
Direktzugriff, Text, Extraktion, Inhaltsströme, Diagnostik
Beschreibung
Gibt die stabile Content-Stream-Position und den kodierten Quellbyte-Bereich zurück, die einem Direct Access extrahierten Zeichen zugeordnet sind
Syntax
Delphi
Function TPDFlib.DAGetTextBlockCharContentLocation(TextBlockListID, Index,
CharIndex: Integer; Out ContentLayer, StreamObjectNumber,
StreamGeneration, InstructionIndex, OperandIndex, ArrayElementIndex,
SourceByteOffset, SourceByteLength, Flags: Integer): Integer;Parameter
| TextBlockListID | Handle, das von DAExtractPageTextBlocks 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, gemeinsam mit GetTextBlockCharContentLocation |
Rückgabewerte
| 1 | Ein Positionsdatensatz wurde zurückgegeben, einschließlich synthetischer oder schreibgeschützter Datensätze |
|---|---|
| 0 | Handle, Blockindex oder Zeichenindex ist ungültig |
Anmerkungen
Direct-Access-Orte sind diagnostisch und schreibgeschützt, da ReplaceTextBlockCharSourceBytes auf einem ausgewählten bearbeitbaren Dokument arbeitet
Offsets adressieren dekodierte Bytes von Schrift-encodierten Zeichenfolgen statt Unicode-Text
Ortsdaten bleiben nach dem Schließen des Direct-Access-Dateihandles in der Textblockliste verfügbar
Supplementäre Zeichen und Ligaturerweiterungen können für mehr als eine UTF-16-Position denselben Quellbereich zurückgeben