DAGetTextBlockCharContentLocation
Accès direct, texte, extraction, flux de contenu, diagnostic
Description
Renvoie l'emplacement stable dans le flux de contenu et la plage d'octets source encodés associés à un caractère extrait en accès direct
Syntaxe
Delphi
Function TPDFlib.DAGetTextBlockCharContentLocation(TextBlockListID, Index,
CharIndex: Integer; Out ContentLayer, StreamObjectNumber,
StreamGeneration, InstructionIndex, OperandIndex, ArrayElementIndex,
SourceByteOffset, SourceByteLength, Flags: Integer): Integer;Paramètres
| TextBlockListID | Handle renvoyé par DAExtractPageTextBlocks |
|---|---|
| Index | Index de bloc de texte à base 1 |
| CharIndex | Position à base 1 en unités de code UTF-16 dans le texte du bloc |
| ContentLayer | Couche /Contents de la page à base 1, ou 0 pour un contenu imbriqué |
| StreamObjectNumber | Numéro d'objet du flux conteneur, ou 0 pour un flux direct |
| StreamGeneration | Numéro de génération du flux conteneur |
| InstructionIndex | Index d'instruction à base zéro dans le programme de contenu décodé |
| OperandIndex | Index d'opérande de chaîne de texte à base zéro |
| ArrayElementIndex | Élément du tableau TJ à base zéro, ou -1 pour un opérande de chaîne directe |
| SourceByteOffset | Décalage à base zéro dans la valeur de chaîne décodée, ou -1 lorsqu'aucune plage sûrement adressable n'existe |
| SourceByteLength | Nombre d'octets source encodés pour le glyphe source, ou 0 lorsqu'aucune plage sûrement adressable n'existe |
| Flags | Indicateurs binaires d'emplacement de contenu partagés avec GetTextBlockCharContentLocation |
Valeurs de retour
| 1 | Un enregistrement d'emplacement a été renvoyé, y compris les enregistrements synthétiques ou en lecture seule |
|---|---|
| 0 | Le handle, l'index de bloc ou l'index de caractère est invalide |
Remarques
Les emplacements Direct Access sont diagnostiques et en lecture seule car ReplaceTextBlockCharSourceBytes opère sur un document éditable sélectionné
Les décalages adressent les octets de chaîne décodés selon l'encodage de la police, pas le texte Unicode
Les données d'emplacement restent disponibles dans la liste de blocs de texte après la fermeture du handle de fichier Direct Access
Les caractères supplémentaires et les expansions de ligatures peuvent renvoyer la même plage source pour plus d'une position UTF-16