PdfSaveOptions

PdfSaveOptions class

يمكن استخدامه لتحديد خيارات إضافية عند حفظ مستند فيPdf تنسيق.

لمعرفة المزيد، قم بزيارةتحديد خيارات الحفظ مقالة توثيقية.

public class PdfSaveOptions : FixedPageSaveOptions

المنشئون

اسموصف
PdfSaveOptions()يقوم بتهيئة مثيل جديد لهذه الفئة التي يمكن استخدامها لحفظ مستند في Pdf تنسيق.

الخصائص

اسموصف
AdditionalTextPositioning { get; set; }علم يحدد ما إذا كان سيتم كتابة عوامل تحديد موضع نص إضافية أم لا.
AllowEmbeddingPostScriptFonts { get; set; }يحصل على قيمة منطقية أو يعينها للإشارة إلى ما إذا كان سيتم السماح بتضمين الخطوط مع الخطوط العريضة لـ PostScript عند تضمين خطوط TrueType في مستند عند حفظه. القيمة الافتراضية هيخطأ شنيع .
AttachmentsEmbeddingMode { get; set; }يحصل على قيمة تحدد كيفية تضمين المرفقات في مستند PDF أو يعينها.
CacheBackgroundGraphics { get; set; }يحصل على قيمة تحدد ما إذا كان سيتم تخزين الرسومات الموضوعة في خلفية المستند أم لا.
ColorMode { get; set; }يحصل على قيمة تحدد كيفية عرض الألوان أو يعينها.
Compliance { get; set; }يحدد مستوى التوافق مع معايير PDF للمستندات الناتجة.
CreateNoteHyperlinks { get; set; }يحدد ما إذا كان سيتم تحويل مراجع الحواشي السفلية/الحواشي النهائية في القصة النصية الرئيسية إلى ارتباطات تشعبية نشطة. عند النقر فوق الارتباط التشعبي، سيقودك إلى الحاشية السفلية/الحواشي النهائية المقابلة. الإعداد الافتراضي هوخطأ شنيع .
CustomPropertiesExport { get; set; }يحصل على قيمة تحدد الطريقة أو يعينهاCustomDocumentProperties يتم تصديرها إلى ملف PDF.
CustomTimeZoneInfo { get; set; }يحصل على أو يعين المنطقة الزمنية المحلية المخصصة المستخدمة لحقول التاريخ/الوقت.
DefaultTemplate { get; set; }يحصل على المسار إلى القالب الافتراضي (بما في ذلك اسم الملف) أو يعينه. القيمة الافتراضية لهذه الخاصية هيسلسلة فارغة (Empty ).
DigitalSignatureDetails { get; set; }يحصل على تفاصيل توقيع مستند PDF الناتج أو يعينها.
DisplayDocTitle { get; set; }علم يحدد ما إذا كان شريط عنوان النافذة يجب أن يعرض عنوان المستند المأخوذ من إدخال العنوان في قاموس معلومات المستند.
Dml3DEffectsRenderingMode { get; set; }يحصل على قيمة تحدد كيفية عرض التأثيرات ثلاثية الأبعاد أو يعينها.
override DmlEffectsRenderingMode { get; set; }يحصل على قيمة تحدد كيفية عرض تأثيرات DrawingML أو يعينها.
DmlRenderingMode { get; set; }يحصل على قيمة تحدد كيفية عرض أشكال DrawingML أو يعينها.
DownsampleOptions { get; set; }يسمح بتحديد خيارات تقليل العينة.
EmbedFullFonts { get; set; }يتحكم في كيفية تضمين الخطوط في مستندات PDF الناتجة.
EncryptionDetails { get; set; }يحصل على تفاصيل تشفير مستند PDF الناتج أو يعينها.
ExportDocumentStructure { get; set; }يحصل على قيمة أو يعينها لتحديد ما إذا كان سيتم تصدير بنية المستند أم لا.
ExportGeneratorName { get; set; }عندماحقيقي ، يؤدي إلى تضمين اسم وإصدار Aspose.Words في الملفات المنتجة. القيمة الافتراضية هيحقيقي .
ExportLanguageToSpanTag { get; set; }يحصل على قيمة أو يعينها لتحديد ما إذا كان سيتم إنشاء علامة “Span” في بنية المستند لتصدير لغة النص أم لا.
ExportParagraphGraphicsToArtifact { get; set; }يحصل على قيمة أو يعينها لتحديد ما إذا كان يجب وضع علامة على رسم فقرة كقطعة أثرية.
FontEmbeddingMode { get; set; }يحدد وضع تضمين الخط.
HeaderFooterBookmarksExportMode { get; set; }يحدد كيفية تصدير الإشارات المرجعية في الرؤوس/التذييلات.
ImageColorSpaceExportMode { get; set; }يحدد كيفية تحديد مساحة اللون للصور في مستند PDF.
ImageCompression { get; set; }يحدد نوع الضغط الذي سيتم استخدامه لجميع الصور في المستند.
ImlRenderingMode { get; set; }يحصل على قيمة تحدد كيفية عرض كائنات الحبر (InkML) أو يعينها.
InterpolateImages { get; set; }علم يشير إلى ما إذا كان سيتم تنفيذ استيفاء الصورة بواسطة قارئ متوافق. عندماخطأ شنيع إذا تم تحديد ذلك، فلن تتم كتابة العلم في مستند الإخراج وسيتم استخدام السلوك الافتراضي للقارئ بدلاً من ذلك.
JpegQuality { get; set; }يحصل على قيمة تحدد جودة صور JPEG داخل مستند PDF أو يعينها.
MemoryOptimization { get; set; }يحصل على القيمة أو يعينها لتحديد ما إذا كان يجب إجراء تحسين الذاكرة قبل حفظ المستند. القيمة الافتراضية لهذه الخاصية هيخطأ شنيع .
MetafileRenderingOptions { get; set; }يسمح بتحديد خيارات عرض الملف التعريفي.
NumeralFormat { get; set; }يحصل أو يعينNumeralFormat تُستخدم لعرض الأرقام. يتم استخدام الأرقام الأوروبية بشكل افتراضي.
OpenHyperlinksInNewWindow { get; set; }يحصل على قيمة أو يعينها لتحديد ما إذا كانت الروابط التشعبية في مستند Pdf الناتج يجب فتحها في نافذة جديدة (أو علامة تبويب) للمتصفح.
virtual OptimizeOutput { get; set; }يشير العلم إلى ما إذا كان مطلوبًا لتحسين الإخراج. إذا تم تعيين هذا العلم، تتم إزالة اللوحات المتداخلة الزائدة واللوحات الفارغة، أيضًا يتم ربط الحروف المجاورة بنفس التنسيق. ملاحظة: قد تتأثر دقة عرض المحتوى إذا تم تعيين هذه الخاصية علىحقيقي . الافتراضي هوخطأ شنيع .
OutlineOptions { get; }يسمح بتحديد خيارات المخطط التفصيلي.
PageLayout { get; set; }يحدد تخطيط الصفحة الذي سيتم استخدامه عند فتح المستند في قارئ PDF.
PageMode { get; set; }يحدد كيفية عرض مستند PDF عند فتحه في قارئ PDF.
PageSavingCallback { get; set; }يسمح بالتحكم في كيفية حفظ الصفحات المنفصلة عند تصدير مستند إلى تنسيق الصفحة الثابتة.
PageSet { get; set; }يحصل على الصفحات التي سيتم عرضها أو يعينها. الافتراضي هو كل الصفحات الموجودة في المستند.
PreblendImages { get; set; }يحصل على قيمة أو يعينها لتحديد ما إذا كان سيتم مزج الصور الشفافة مسبقًا مع لون الخلفية الأسود أم لا.
PreserveFormFields { get; set; }يحدد ما إذا كان سيتم الحفاظ على حقول نموذج Microsoft Word كحقول نموذج في PDF أو تحويلها إلى نص. الافتراضي هوخطأ شنيع .
PrettyFormat { get; set; }عندماحقيقي ، تنسيقات الإخراج الجميلة حيثما ينطبق ذلك. القيمة الافتراضية هيخطأ شنيع .
ProgressCallback { get; set; }يتم استدعاؤها أثناء حفظ المستند وتقبل البيانات حول تقدم الحفظ.
RenderChoiceFormFieldBorder { get; set; }يحدد ما إذا كان سيتم عرض حدود حقل نموذج اختيار PDF.
override SaveFormat { get; set; }يحدد التنسيق الذي سيتم حفظ المستند به إذا تم استخدام كائن خيارات الحفظ هذا. لا يمكن أن يكون إلاPdf .
TempFolder { get; set; }يحدد المجلد للملفات المؤقتة المستخدمة عند الحفظ في ملف DOC أو DOCX. بشكل افتراضي، تكون هذه الخاصيةباطل ولا يتم استخدام أي ملفات مؤقتة.
TextCompression { get; set; }يحدد نوع الضغط الذي سيتم استخدامه لجميع النصوص في المستند.
UpdateAmbiguousTextFont { get; set; }يحدد ما إذا كانت سمات الخط ستتغير وفقًا لرمز الحرف المستخدم.
UpdateCreatedTimeProperty { get; set; }يحصل على قيمة أو يعينها لتحديد ما إذا كانCreatedTime يتم تحديث الخاصية قبل الحفظ. القيمة الافتراضية هيخطأ شنيع ;
UpdateFields { get; set; }يحصل على قيمة أو يعينها لتحديد ما إذا كان يجب تحديث حقول أنواع معينة قبل حفظ المستند بتنسيق صفحة ثابت. القيمة الافتراضية لهذه الخاصية هيحقيقي .
UpdateLastPrintedProperty { get; set; }يحصل على قيمة أو يعينها لتحديد ما إذا كانLastPrinted يتم تحديث الخاصية قبل الحفظ.
UpdateLastSavedTimeProperty { get; set; }يحصل على قيمة أو يعينها لتحديد ما إذا كانLastSavedTime يتم تحديث الخاصية قبل الحفظ.
UseAntiAliasing { get; set; }يحصل على قيمة أو يعينها لتحديد ما إذا كان سيتم استخدام التنعيم للرسم أم لا.
UseBookFoldPrintingSettings { get; set; }يحصل على قيمة منطقية أو يعينها للإشارة إلى ما إذا كان يجب حفظ المستند باستخدام تخطيط طباعة الكتيبات، إذا تم تحديد ذلك عبرMultiplePages .
UseCoreFonts { get; set; }يحصل على قيمة أو يعينها لتحديد ما إذا كان سيتم استبدال خطوط TrueType Arial وTimes New Roman و Courier New وSymbol بخطوط PDF Type 1 الأساسية أم لا.
UseHighQualityRendering { get; set; }يحصل على قيمة أو يعينها لتحديد ما إذا كان سيتم استخدام خوارزميات عرض عالية الجودة (أي بطيئة) أم لا.
UseSdtTagAsFormFieldName { get; set; }يحدد ما إذا كان سيتم استخدام عنصر تحكم SDT Tag أو خاصية Id كاسم لحقل النموذج في PDF.
ZoomBehavior { get; set; }يحصل على قيمة أو يعينها لتحديد نوع التكبير الذي يجب تطبيقه عند فتح مستند باستخدام عارض PDF.
ZoomFactor { get; set; }يحصل على قيمة لتحديد عامل التكبير (بالنسب المئوية) لمستند أو يعينها.

طُرق

اسموصف
Clone()ينشئ نسخة طبق الأصل عميقة من هذا الكائن.
override Equals(object)يحدد ما إذا كان الكائن المحدد يساوي في القيمة الكائن الحالي.

أمثلة

يوضح كيفية تغيير لون الصورة باستخدام خاصية خيارات الحفظ.

Document doc = new Document(MyDir + "Images.docx");

// قم بإنشاء كائن "PdfSaveOptions" الذي يمكننا تمريره إلى طريقة "حفظ" الخاصة بالمستند
// لتعديل كيفية تحويل هذه الطريقة للمستند إلى .PDF.
// قم بضبط خاصية "ColorMode" على "Grayscale" لعرض كافة الصور من المستند باللونين الأبيض والأسود.
//قد يكون حجم المستند الناتج أكبر مع هذا الإعداد.
// اضبط خاصية "ColorMode" على "Normal" لعرض كافة الصور بالألوان.
PdfSaveOptions pdfSaveOptions = new PdfSaveOptions { ColorMode = colorMode };

doc.Save(ArtifactsDir + "PdfSaveOptions.ColorRendering.pdf", pdfSaveOptions);

يوضح كيفية تطبيق ضغط النص عند حفظ مستند بتنسيق PDF.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

for (int i = 0; i < 100; i++)
    builder.Writeln("Lorem ipsum dolor sit amet, consectetur adipiscing elit, " +
                    "sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");

// قم بإنشاء كائن "PdfSaveOptions" الذي يمكننا تمريره إلى طريقة "حفظ" الخاصة بالمستند
// لتعديل كيفية تحويل هذه الطريقة للمستند إلى .PDF.
PdfSaveOptions options = new PdfSaveOptions();

// اضبط خاصية "TextCompression" على "PdfTextCompression.None" لعدم تطبيق أي
// ضغط النص عندما نحفظ المستند بصيغة PDF.
// اضبط خاصية "TextCompression" على "PdfTextCompression.Flate" لتطبيق ضغط ZIP
// إلى نص عند حفظ المستند بصيغة PDF. كلما كان حجم المستند أكبر، كان تأثير ذلك أكبر.
options.TextCompression = pdfTextCompression;

doc.Save(ArtifactsDir + "PdfSaveOptions.TextCompression.pdf", options);

يوضح كيفية تحويل مستند كامل إلى PDF بثلاثة مستويات في مخطط المستند.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// إدراج عناوين المستويات من 1 إلى 5.
builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading1;

Assert.True(builder.ParagraphFormat.IsHeading);

builder.Writeln("Heading 1");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading2;

builder.Writeln("Heading 1.1");
builder.Writeln("Heading 1.2");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading3;

builder.Writeln("Heading 1.2.1");
builder.Writeln("Heading 1.2.2");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading4;

builder.Writeln("Heading 1.2.2.1");
builder.Writeln("Heading 1.2.2.2");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading5;

builder.Writeln("Heading 1.2.2.2.1");
builder.Writeln("Heading 1.2.2.2.2");

// قم بإنشاء كائن "PdfSaveOptions" الذي يمكننا تمريره إلى طريقة "حفظ" الخاصة بالمستند
// لتعديل كيفية تحويل هذه الطريقة للمستند إلى .PDF.
PdfSaveOptions options = new PdfSaveOptions();

// سيحتوي مستند PDF الناتج على مخطط تفصيلي، وهو عبارة عن جدول محتويات يسرد العناوين الموجودة في نص المستند.
// النقر على إدخال في هذا المخطط سيأخذنا إلى موقع العنوان الخاص به.
// قم بضبط خاصية "HeadingsOutlineLevels" على "4" لاستبعاد جميع العناوين التي تكون مستوياتها أعلى من 4 من المخطط التفصيلي.
options.OutlineOptions.HeadingsOutlineLevels = 4;

// إذا كان إدخال المخطط التفصيلي يحتوي على إدخالات لاحقة بمستوى أعلى بينها وبين الإدخال التالي من نفس المستوى أو المستوى الأدنى،
// سيظهر سهم على يسار المُدخلة. هذه المُدخلة هي "مالكة" العديد من هذه "المُدخلات الفرعية".
// في مستندنا، تعتبر إدخالات المخطط التفصيلي من مستوى العنوان الخامس إدخالات فرعية لإدخال المخطط التفصيلي الثاني من المستوى الرابع،
// إدخالات المستوى الرابع والخامس هي إدخالات فرعية للإدخال الثاني على المستوى الثالث، وهكذا.
// في المخطط التفصيلي، يمكننا النقر على سهم إدخال "المالك" لإخفاء/توسيع جميع إدخالاته الفرعية.
// اضبط خاصية "ExpandedOutlineLevels" على "2" لتوسيع جميع عناوين المستوى 2 وإدخالات المخطط التفصيلي السفلية تلقائيًا
// وانهيار جميع الإدخالات من المستوى 3 وما فوق عندما نفتح المستند.
options.OutlineOptions.ExpandedOutlineLevels = 2;

doc.Save(ArtifactsDir + "PdfSaveOptions.ExpandedOutlineLevels.pdf", options);

أنظر أيضا

PdfPermissions Enum PdfTextCompression Enum