GetTextBlockCharContentLocation

Tekst, udtrækning, indholdsstreams, diagnostik

Beskrivelse

Returnerer den stabile placering i indholdsstrømmen og det kodede kildebyteområde, der hører til ét udtrukket tegn

Syntaks

Delphi

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

Parametre

TextBlockListID	Handle returneret af `ExtractPageTextBlocks`
Index	Etbaseret tekstblokindeks
CharIndex	Etbaseret UTF-16-kodeenhedsposition i blokteksten
ContentLayer	Etbaseret side-`/Contents`-lag, eller 0 for indlejret indhold
StreamObjectNumber	Objektnummer for den indeholdende stream, eller 0 for en direkte stream
StreamGeneration	Generationsnummer for den indeholdende stream
InstructionIndex	Nulbaseret instruktionsindeks i det afkodede indholdsprogram
OperandIndex	Nulbaseret operandindeks for tekststrengen
ArrayElementIndex	Nulbaseret `TJ`-arrayelement, eller -1 for en direkte strengoperand
SourceByteOffset	Nulbaseret forskydning i den afkodede strengværdi, eller -1, når der ikke findes et sikkert adresserbart område
SourceByteLength	Antal kodede kildebytes for kildeglyffen, eller 0, når der ikke findes et sikkert adresserbart område
Flags	Bitvise flags for indholdsplacering beskrevet nedenfor

Returværdier

1	En placeringspost blev returneret, inklusive syntetiske eller skrivebeskyttede poster
0	Handlet, blokindekset eller tegnindekset er ugyldigt

Flag

`PDF_TEXT_CHAR_CONTENT_LOCATION_VALID`	Byte-området identificerer en indholdsstreng, under hensyn til eventuelle skrivebeskyttede flags
`PDF_TEXT_CHAR_CONTENT_LOCATION_GENERATED`	Tegnet blev genereret under layout og har ingen kildebytes
`PDF_TEXT_CHAR_CONTENT_LOCATION_LIGATURE`	Flere udtrukne UTF-16-positioner deler ét kildeglyfområde
`PDF_TEXT_CHAR_CONTENT_LOCATION_ACTUALTEXT`	Tegnet kom fra en `/ActualText`-erstatning og er skrivebeskyttet
`PDF_TEXT_CHAR_CONTENT_LOCATION_NESTED`	Tegnet kom fra indlejret Form-indhold og er skrivebeskyttet
`PDF_TEXT_CHAR_CONTENT_LOCATION_CROSS_LAYER`	Operanden og den tekstvisende operator krydser sideindholdslag og er skrivebeskyttede
`PDF_TEXT_CHAR_CONTENT_LOCATION_TRANSCODED`	Kildestrengen blev transkodet før skrifttypeafbildning, så afkodede forskydninger ikke sikkert kan adressere dens oprindelige bytes

Bemærkninger

Offsetadresserer afkodede font-kodede strengbytes frem for Unicode-tekst

Supplerende tegn og ligatur-udvidelser kan returnere samme kildeområde for mere end én UTF-16-position

Brug ReplaceTextBlockCharSourceBytes kun, når den gyldige flag er sat, og ingen af de skrivebeskyttede flag er til stede

Placeringsopslag bruger udtræknings-tidsspænd og reparsere ikke sideindhold