StitchPageOverlay
Page manipulation
Description
يقوم بتراكب محتوى صفحة واحدة على صفحة أخرى موجودة في الموضع المحدد؛ يتم التقاط الصفحة المصدر في متجه Form XObject ورسمها على الصفحة المستهدفة، مما يحافظ على دقة المتجه الكاملة (يظل النص قابلاً للتحديد، وتظل المسارات واضحة) بدلاً من تحويلها إلى نقطية
يتم استهلاك الصفحة المصدر في هذه العملية: حيث يتم التقاطها وإخفاؤها، تماما مثل ImposePagesNUp؛ وإذا كان رقم الصفحة المستهدفة أكبر من رقم الصفحة المصدر، فسيتم تعديله تلقائيا لأن إخفاء المصدر يزيح الصفحات اللاحقة إلى الأسفل بمقدار صفحة واحدة
يتحكم Width و Height في حجم الموضع؛ وإذا اختلفت نسبة العرض إلى الارتفاع الخاصة بهما عن الصفحة المصدر، فسيتم تمديد المحتوى；استخدم أبعاد الصفحة الخاصة للحصول على تراكب بنسبة 1:1；يتراوح Opacity من 0 (شفاف تمامًا) إلى 1 (معتم تمامًا)
Syntax
Delphi
Function TPDFlib.StitchPageOverlay(SourcePage, TargetPage: Integer; Left, Top, Width, Height, Opacity: Double): Integer;Parameters
| SourcePage | رقم الصفحة المستند إلى 1 whose content will be captured and overlaid (consumed and hidden afterwards) |
|---|---|
| TargetPage | رقم الصفحة المستند إلى 1 that receives the overlay; must differ from SourcePage |
| Left, Top | الموضع العلوي الأيسر للمحتوى المتراكب على الصفحة المستهدفة، بوحدات القياس الحالية (نقطة الأصل في الأعلى واليسار) |
| Width, Height | حجم الموضع؛ مرر أبعاد الصفحة المصدر للتراكب غير المقاس |
| Opacity | قيمة ألفا بين 0..1 للمحتوى المتراكب (1 = معتم، القيم الأقل من 1 تمكن الشفافية عبر ExtGState ca/CA) |
Return values
| 0 | تعذر إجراء التراكب (أرقام صفحات غير صالحة، أو تطابق المصدر والهدف، أو فشل الالتقاط) |
|---|---|
| 1 | تم التقاط الصفحة المصدر ووضعها فوق الصفحة المستهدفة |