DAGetTextBlockCharContentLocation
الوصول المباشر، النصوص، الاستخراج، تدفقات المحتوى، التشخيص
الوصف
تُرجع موقع تيار المحتوى الثابت ونطاق البايتات المصدرية المرمَّزة المرتبطين بمحرف واحد مستخرج في Direct Access
الصيغة
Delphi
Function TPDFlib.DAGetTextBlockCharContentLocation(TextBlockListID, Index,
CharIndex: Integer; Out ContentLayer, StreamObjectNumber,
StreamGeneration, InstructionIndex, OperandIndex, ArrayElementIndex,
SourceByteOffset, SourceByteLength, Flags: Integer): Integer;المعاملات
| TextBlockListID | مقبض أُرجع من DAExtractPageTextBlocks |
|---|---|
| Index | فهرس كتلة نص يبدأ من 1 |
| CharIndex | موضع وحدة كود UTF-16 داخل نص الكتلة يبدأ من 1 |
| ContentLayer | طبقة /Contents للصفحة يبدأ ترقيمها من 1، أو 0 للمحتوى المتداخل |
| StreamObjectNumber | رقم كائن التيار الحاوي، أو 0 لتيار مباشر |
| StreamGeneration | رقم جيل التيار الحاوي |
| InstructionIndex | فهرس تعليمة في برنامج المحتوى المفكوك يبدأ من 0 |
| OperandIndex | فهرس معامل سلسلة النص يبدأ من 0 |
| ArrayElementIndex | عنصر مصفوفة TJ يبدأ من 0، أو -1 لمعامل سلسلة مباشر |
| SourceByteOffset | إزاحة تبدأ من 0 داخل قيمة السلسلة المفكوكة، أو -1 عندما لا يوجد نطاق يمكن عنونته بأمان |
| SourceByteLength | عدد البايتات المصدرية المرمَّزة للمحرف الرسومي المصدر، أو 0 عندما لا يوجد نطاق يمكن عنونته بأمان |
| Flags | أعلام موقع المحتوى بتّية مشتركة مع GetTextBlockCharContentLocation |
القيم المُرجعة
| 1 | أُرجع سجل موقع، بما في ذلك السجلات الاصطناعية أو للقراءة فقط |
|---|---|
| 0 | المقبض أو فهرس الكتلة أو فهرس المحرف غير صالح |
ملاحظات
مواضع الوصول المباشر تشخيصية وللقراءة فقط لأن ReplaceTextBlockCharSourceBytes تعمل على مستند قابل للتحرير ومحدد
تعنون الإزاحات بايتات السلاسل المشفرة بترميز الخط بعد فك الترميز لا النص Unicode
تبقى بيانات الموقع متاحة في قائمة الكتل النصية بعد إغلاق مقبض ملف الوصول المباشر
المحارف التكميلية وتوسعات الحروف المرتبطة قد تعيد المدى المصدر نفسه لأكثر من موضع UTF-16 واحد