DAGetTextBlockCharContentLocation

Bezpośredni dostęp, tekst, wyodrębnianie, strumienie zawartości, diagnostyka

Opis

Zwraca stabilną lokalizację w strumieniu zawartości i zakres zakodowanych bajtów źródłowych powiązany z jednym znakiem wyodrębnionym w trybie Direct Access

Składnia

Delphi

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

Parametry

TextBlockListID	Uchwyt zwrócony przez `DAExtractPageTextBlocks`
Index	Indeks bloku tekstu liczony od 1
CharIndex	Pozycja jednostki kodu UTF-16 licząca od 1 wewnątrz tekstu bloku
ContentLayer	Warstwa `/Contents` strony liczona od 1 albo 0 dla zawartości zagnieżdżonej
StreamObjectNumber	Numer obiektu strumienia zawierającego albo 0 dla strumienia bezpośredniego
StreamGeneration	Numer generacji strumienia zawierającego
InstructionIndex	Indeks instrukcji liczony od 0 w zdekodowanym programie zawartości
OperandIndex	Indeks operandu łańcucha tekstowego liczony od 0
ArrayElementIndex	Element tablicy `TJ` liczony od 0 albo -1 dla bezpośredniego operandu łańcuchowego
SourceByteOffset	Przesunięcie liczone od 0 w zdekodowanej wartości łańcucha albo -1, gdy nie istnieje bezpiecznie adresowalny zakres
SourceByteLength	Liczba zakodowanych bajtów źródłowych dla glifu źródłowego albo 0, gdy nie istnieje bezpiecznie adresowalny zakres
Flags	Flagi lokalizacji zawartości łączone bitowo, wspólne z `GetTextBlockCharContentLocation`

Wartości zwracane

1	Zwrócono rekord lokalizacji, łącznie z rekordami syntetycznymi lub tylko do odczytu
0	Uchwyt, indeks bloku lub indeks znaku jest nieprawidłowy

Uwagi

Lokalizacje Direct Access służą diagnostyce i są tylko do odczytu, bo ReplaceTextBlockCharSourceBytes działa na wybranym dokumencie edytowalnym

Przesunięcia adresują bajty zdekodowanego ciągu zakodowanego fontem, a nie tekst Unicode

Dane lokalizacji pozostają dostępne na liście bloków tekstowych po zamknięciu uchwytu pliku Direct Access

Znaki uzupełniające i rozwinięcia ligatur mogą zwracać ten sam zakres źródłowy dla więcej niż jednej pozycji UTF-16