ReplacePageRanges
معالجة المستندات
الوصف
تستبدل المحتوى المرئي والعرض على مستوى الصفحة للصفحات الموجودة في المستند المحدد بصفحات مستوردة من مستند آخر مفتوح مع الاحتفاظ بكائنات الصفحات الهدف
الصيغة
Delphi
Function TPDFlib.ReplacePageRanges(DocumentID, TargetStartPage: Integer; Const RangeList: WideString; Options: Integer= 0): Integer;المعاملات
| DocumentID | معرّف المستند المصدر المفتوح، ويجب أن يختلف عن المستند الهدف المحدد |
|---|---|
| TargetStartPage | رقم الصفحة ذا الأساس 1 في المستند الهدف المحدد حيث يبدأ الاستبدال |
| RangeList | تعبير مدى صفحات المصدر، مثل "1-3,5"؛ وتجعل المحارف غير الصالحة أو الصفحات خارج المدى النداء بأكمله فاشلًا |
| Options | 0 يرتب الصفحات ويزيل المكررات؛ و1 يحفظ ترتيب المصدر ويسمح بأرقام صفحات مكررة |
قيم الإرجاع
| 0 | فشل التحقق أو الاستبدال وتُركت الصفحات الهدف دون تغيير |
|---|---|
| 1 | استُبدلت الصفحات الهدف المطلوبة |
ملاحظات
تنقل العملية Contents وResources وصناديق الصفحات الخمسة وRotate وGroup وUserUnit وBoxColorInfo. وتبقى أرقام كائنات الصفحات الهدف والتعليقات التوضيحية وعناصر Widget في النماذج ووجهات الإشارات المرجعية وغيرها من المراجع القائمة مرفقة. ولا تُستورد تعليقات المصدر التوضيحية ولا حقول النماذج ولا المخططات التفصيلية. ويبقى عدد الصفحات دون تغيير، ويُتحقق من جميع مدى المصدر وسعة الهدف قبل التعديل
مثال
var SourceDoc: Integer;
SourceDoc := PDF.LoadFromFile('source.pdf', '');
PDF.SelectDocument(MainDoc);
// Replace page 2 of MainDoc with page 1 of source.pdf
PDF.ReplacePageRanges(SourceDoc, 2, '1', 0);