GetTextBlockCharContentLocation

النصوص، الاستخراج، تدفقات المحتوى، التشخيص

الوصف

تُرجع موقع تيار المحتوى الثابت ونطاق البايتات المصدرية المرمَّزة المرتبطين بمحرف مستخرج واحد

الصيغة

Delphi

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

المعاملات

TextBlockListIDمقبض أرجعته ExtractPageTextBlocks
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أعلام موقع المحتوى بتّية موصوفة أدناه

القيم المُرجعة

1أُرجع سجل موقع، بما في ذلك السجلات الاصطناعية أو للقراءة فقط
0المقبض أو فهرس الكتلة أو فهرس المحرف غير صالح

الأعلام

PDF_TEXT_CHAR_CONTENT_LOCATION_VALIDيحدد نطاق البايتات سلسلة محتوى، رهينًا بأي أعلام قراءة فقط
PDF_TEXT_CHAR_CONTENT_LOCATION_GENERATEDوُلّد المحرف أثناء التخطيط وليس له بايتات مصدرية
PDF_TEXT_CHAR_CONTENT_LOCATION_LIGATUREتتشارك مواضع UTF-16 مستخرجة متعددة نطاق محرف رسومي مصدر واحد
PDF_TEXT_CHAR_CONTENT_LOCATION_ACTUALTEXTجاء المحرف من استبدال /ActualText وهو للقراءة فقط
PDF_TEXT_CHAR_CONTENT_LOCATION_NESTEDجاء المحرف من محتوى نموذج متداخل وهو للقراءة فقط
PDF_TEXT_CHAR_CONTENT_LOCATION_CROSS_LAYERيعبر المعامل وعامل إظهار النص طبقات محتوى الصفحة وهما للقراءة فقط
PDF_TEXT_CHAR_CONTENT_LOCATION_TRANSCODEDأُعيد ترميز السلسلة المصدرية قبل ربط الخط، فلا تستطيع الإزاحات المفكوكة عنونة بايتاتها الأصلية بأمان

ملاحظات

تعنون الإزاحات بايتات السلاسل المشفرة بترميز الخط بعد فك الترميز لا النص Unicode

المحارف التكميلية وتوسعات الحروف المرتبطة قد تعيد المدى المصدر نفسه لأكثر من موضع UTF-16 واحد

استخدم ReplaceTextBlockCharSourceBytes فقط عندما يكون علم الصلاحية مضبوطًا ولا يوجد أي علم قراءة فقط

يستخدم البحث عن الموقع المدات المسجلة عند الاستخراج ولا يعيد تحليل محتوى الصفحة