RenderPageToMetafileStream

Rendering and printing

Description

این تابع فقط در نسخه Delphi در دسترس است؛ این متد یک صفحه از سند انتخاب‌شده را در یک TStream به عنوان یک متافایل ویندوز (خروجی برداری) رندر می‌کند، و به جای تبدیل آن به پیکسل، متن و محتوای برداری صفحه را حفظ می‌نماید

فرمت انتخاب‌شده، نوع متافایل را کنترل می‌کند: mfEMF از مسیر کلاسیک GDI enhanced-metafile استفاده می‌کند (سازگاری گسترده برای مصرف‌کنندگان)، mfEMFPlus و mfEMFDual از مسیر ضبط GDI+ استفاده می‌کنند (دقت بهتر برای شفافیت و هموارسازی لبه)، و mfWMF فرمت قدیمی 16 بیتی را تولید می‌کند

فرمت mfEMFDual هر دو دستور GDI و GDI+ را در یک فایل ضبط می‌کند تا مصرف‌کنندگان قدیمی که فقط از GDI پشتیبانی می‌کنند همچنان بتوانند آن را بخوانند، هرچند که این کار حجم فایل را افزایش می‌دهد؛ زمانی که می‌دانید مصرف‌کننده قابلیت پشتیبانی از GDI+ را دارد (Office، Illustrator، نمایشگرهای مدرن)، mfEMFPlus را ترجیح دهید

در داخل، این یک پوشش راحت روی RenderPageToStream است که Format را به یک مقدار عدد صحیح Options نگاشت می‌کند، بنابراین DPI همچنان در مقدار RenderScale به ازای هر نمونه که از طریق SetRenderScale تنظیم شده ضرب می‌شود

Syntax

Delphi

Function TPDFlib.RenderPageToMetafileStream(DPI: Double; Page: Integer; Format: TPDFlibMetafileFormat; Target: TStream): Integer;

Parameters

DPIمقدار DPI مورد استفاده هنگام رندر کردن صفحه؛ ابعاد فریم متافایل را کنترل می‌کند؛ محتوای برداری خود مستقل از DPI است
Pageشماره صفحه جهت رندر کردن
Formatگزینه mfEMF = متافایل کلاسیک GDI EMF;گزینه mfEMFPlus = فقط GDI+ EMF+;گزینه mfEMFDual = دوگانه GDI+ EMF+ Dual (رکوردهای GDI + GDI+، بزرگتر اما با سازگاری گسترده);گزینه mfWMF = متافایل قدیمی 16 بیتی WMF
Targetجریانی که بایت‌های متافایل رندرشده در آن قرار می‌گیرد

Return values

0صفحه رندر نشد
1صفحه به درستی رندر شد و بایت‌های متافایل در جریان نوشته شدند