GetTextBlockCharContentLocation

Tekst, extractie, contentstreams, diagnostiek

Beschrijving

Geeft de stabiele inhoudsstroomlocatie en het gecodeerde bronbytebereik terug die horen bij één geëxtraheerd teken

Syntaxis

Delphi

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

Parameters

TextBlockListID	Handle geretourneerd door `ExtractPageTextBlocks`
Index	Tekstblokindex beginnend bij 1
CharIndex	UTF-16 code-eenheidspositie beginnend bij 1 binnen de bloktekst
ContentLayer	Pagina-`/Contents`-laag beginnend bij 1, of 0 voor geneste inhoud
StreamObjectNumber	Objectnummer van de omvattende stream, of 0 voor een directe stream
StreamGeneration	Generatienummer van de omvattende stream
InstructionIndex	Instructieindex beginnend bij 0 in het gedecodeerde inhoudsprogramma
OperandIndex	Operandindex van de tekststring beginnend bij 0
ArrayElementIndex	`TJ`-arrayelement beginnend bij 0, of -1 voor een directe stringoperand
SourceByteOffset	Offset beginnend bij 0 in de gedecodeerde stringwaarde, of -1 wanneer er geen veilig adresseerbaar bereik bestaat
SourceByteLength	Aantal gecodeerde bronbytes voor de bronglyph, of 0 wanneer er geen veilig adresseerbaar bereik bestaat
Flags	Bitsgewijze contentlocation-vlaggen, hieronder beschreven

Retourwaarden

1	Er is een locatierecord geretourneerd, inclusief synthetische of alleen-lezen records
0	De handle, blokindex of tekenindex is ongeldig

Vlaggen

`PDF_TEXT_CHAR_CONTENT_LOCATION_VALID`	Het bytebereik identificeert een contentstring, behoudens eventuele alleen-lezen vlaggen
`PDF_TEXT_CHAR_CONTENT_LOCATION_GENERATED`	Het teken is gegenereerd tijdens de lay-out en heeft geen bronbytes
`PDF_TEXT_CHAR_CONTENT_LOCATION_LIGATURE`	Meerdere geëxtraheerde UTF-16-posities delen één bronglyphbereik
`PDF_TEXT_CHAR_CONTENT_LOCATION_ACTUALTEXT`	Het teken komt uit een `/ActualText`-vervanging en is alleen-lezen
`PDF_TEXT_CHAR_CONTENT_LOCATION_NESTED`	Het teken komt uit geneste Form-inhoud en is alleen-lezen
`PDF_TEXT_CHAR_CONTENT_LOCATION_CROSS_LAYER`	De operand en de tekstweergave-operator steken pagina-inhoudslagen over en zijn alleen-lezen
`PDF_TEXT_CHAR_CONTENT_LOCATION_TRANSCODED`	De bronstring is vóór fonttoewijzing getranscodeerd, dus gedecodeerde offsets kunnen de oorspronkelijke bytes niet veilig adresseren

Opmerkingen

Offsets adresseren gedecodeerde bytes van fontgecodeerde strings, geen Unicode-tekst

Aanvullende tekens en ligatuuruitbreidingen kunnen voor meer dan één UTF-16-positie hetzelfde bronbereik teruggeven

Gebruik ReplaceTextBlockCharSourceBytes alleen wanneer de geldig-vlag is gezet en geen van de alleen-lezen-vlaggen aanwezig is

Locatie-opzoeking gebruikt extractietijdstroken en repareert pagina-inhoud niet opnieuw