ImageSaveOptions
محتويات
[
يخفي
]ImageSaveOptions class
يسمح بتحديد خيارات إضافية عند تحويل صفحات المستندات أو الأشكال إلى صور.
لمعرفة المزيد، قم بزيارةتحديد خيارات الحفظ مقالة توثيقية.
public class ImageSaveOptions : FixedPageSaveOptions
المنشئون
| اسم | وصف |
|---|---|
| ImageSaveOptions(SaveFormat) | يقوم بتهيئة مثيل جديد لهذه الفئة التي يمكن استخدامها لحفظ الصور المقدمة في Tiff ،Png ،Bmp ، Jpeg ،Emf ،Eps ، WebP أوSvg تنسيق. |
الخصائص
| اسم | وصف |
|---|---|
| AllowEmbeddingPostScriptFonts { get; set; } | يحصل على قيمة منطقية أو يعينها للإشارة إلى ما إذا كان سيتم السماح بتضمين الخطوط مع الخطوط العريضة لـ PostScript عند تضمين خطوط TrueType في مستند عند حفظه. القيمة الافتراضية هيخطأ شنيع . |
| ColorMode { get; set; } | يحصل على قيمة تحدد كيفية عرض الألوان أو يعينها. |
| CustomTimeZoneInfo { get; set; } | يحصل على أو يعين المنطقة الزمنية المحلية المخصصة المستخدمة لحقول التاريخ/الوقت. |
| DefaultTemplate { get; set; } | يحصل على المسار إلى القالب الافتراضي (بما في ذلك اسم الملف) أو يعينه. القيمة الافتراضية لهذه الخاصية هيسلسلة فارغة (Empty ). |
| Dml3DEffectsRenderingMode { get; set; } | يحصل على قيمة تحدد كيفية عرض التأثيرات ثلاثية الأبعاد أو يعينها. |
| virtual DmlEffectsRenderingMode { get; set; } | يحصل على قيمة تحدد كيفية عرض تأثيرات DrawingML أو يعينها. |
| DmlRenderingMode { get; set; } | يحصل على قيمة تحدد كيفية عرض أشكال DrawingML أو يعينها. |
| ExportGeneratorName { get; set; } | عندماحقيقي ، يؤدي إلى تضمين اسم وإصدار Aspose.Words في الملفات المنتجة. القيمة الافتراضية هيحقيقي . |
| GraphicsQualityOptions { get; set; } | يسمح بتحديد وضع العرض والجودة لـGraphics الكائن. |
| HorizontalResolution { get; set; } | يحصل على الدقة الأفقية للصور المولدة أو يعينها، بنقاط لكل بوصة. |
| ImageBrightness { get; set; } | يحصل على سطوع الصور المولدة أو يضبطه. |
| ImageColorMode { get; set; } | يحصل على وضع اللون للصور المولدة أو يعينه. |
| ImageContrast { get; set; } | يحصل على التباين للصور المولدة أو يضبطه. |
| ImageSize { get; set; } | يحصل على حجم الصورة المولدة بالبكسل أو يعينه. |
| ImlRenderingMode { get; set; } | يحصل على قيمة تحدد كيفية عرض كائنات الحبر (InkML) أو يعينها. |
| JpegQuality { get; set; } | يحصل على قيمة تحدد جودة صور JPEG المولدة أو يعينها. |
| MemoryOptimization { get; set; } | يحصل على القيمة أو يعينها لتحديد ما إذا كان يجب إجراء تحسين الذاكرة قبل حفظ المستند. القيمة الافتراضية لهذه الخاصية هيخطأ شنيع . |
| MetafileRenderingOptions { get; } | يسمح بتحديد كيفية التعامل مع الملفات التعريفية في المخرجات المقدمة. |
| NumeralFormat { get; set; } | يحصل أو يعينNumeralFormat تُستخدم لعرض الأرقام. يتم استخدام الأرقام الأوروبية بشكل افتراضي. |
| virtual OptimizeOutput { get; set; } | يشير العلم إلى ما إذا كان مطلوبًا لتحسين الإخراج. إذا تم تعيين هذا العلم، تتم إزالة اللوحات المتداخلة الزائدة واللوحات الفارغة، أيضًا يتم ربط الحروف المجاورة بنفس التنسيق. ملاحظة: قد تتأثر دقة عرض المحتوى إذا تم تعيين هذه الخاصية علىحقيقي . الافتراضي هوخطأ شنيع . |
| PageSavingCallback { get; set; } | يسمح بالتحكم في كيفية حفظ الصفحات المنفصلة عند تصدير مستند إلى تنسيق الصفحة الثابتة. |
| PageSet { get; set; } | يحصل على الصفحات التي سيتم عرضها أو يعينها. الافتراضي هو كل الصفحات الموجودة في المستند. |
| PaperColor { get; set; } | يحصل على لون الخلفية (الورق) للصور المولدة أو يعينه. |
| PixelFormat { get; set; } | يحصل على تنسيق البكسل للصور المولدة أو يعينه. |
| PrettyFormat { get; set; } | عندماحقيقي ، تنسيقات الإخراج الجميلة حيثما ينطبق ذلك. القيمة الافتراضية هيخطأ شنيع . |
| ProgressCallback { get; set; } | يتم استدعاؤها أثناء حفظ المستند وتقبل البيانات حول تقدم الحفظ. |
| Resolution { set; } | يحدد الدقة الأفقية والرأسية للصور المولدة، بنقاط لكل بوصة. |
| override SaveFormat { get; set; } | يحدد التنسيق الذي سيتم به حفظ صفحات المستند أو الأشكال المقدمة إذا تم استخدام كائن خيارات الحفظ هذا. يمكن أن يكون raster Tiff ،Png ،Bmp ، Jpeg أو متجهEmf ،Eps ، WebP ،Svg . |
| Scale { get; set; } | يحصل على عامل التكبير/التصغير للصور المُولدة أو يضبطه. |
| TempFolder { get; set; } | يحدد المجلد للملفات المؤقتة المستخدمة عند الحفظ في ملف DOC أو DOCX. بشكل افتراضي، تكون هذه الخاصيةباطل ولا يتم استخدام أي ملفات مؤقتة. |
| ThresholdForFloydSteinbergDithering { get; set; } | يحصل على أو يعين الحد الذي يحدد قيمة لخطأ التثنية في طريقة Floyd-Steinberg. عندماImageBinarizationMethod يكونFloydSteinbergDithering . |
| TiffBinarizationMethod { get; set; } | يحصل على الطريقة المستخدمة أثناء تحويل الصور إلى تنسيق 1 بت لكل بوصة أو يعينها عندماSaveFormat يكونTiff و TiffCompression يساويCcitt3 أوCcitt4 . |
| TiffCompression { get; set; } | يحصل على نوع الضغط الذي سيتم تطبيقه عند حفظ الصور المولدة بتنسيق TIFF أو يحدده. |
| UpdateAmbiguousTextFont { get; set; } | يحدد ما إذا كانت سمات الخط ستتغير وفقًا لرمز الحرف المستخدم. |
| UpdateCreatedTimeProperty { get; set; } | يحصل على قيمة أو يعينها لتحديد ما إذا كانCreatedTime يتم تحديث الخاصية قبل الحفظ. القيمة الافتراضية هيخطأ شنيع ; |
| UpdateFields { get; set; } | يحصل على قيمة أو يعينها لتحديد ما إذا كان يجب تحديث حقول أنواع معينة قبل حفظ المستند بتنسيق صفحة ثابت. القيمة الافتراضية لهذه الخاصية هيحقيقي . |
| UpdateLastPrintedProperty { get; set; } | يحصل على قيمة أو يعينها لتحديد ما إذا كانLastPrinted يتم تحديث الخاصية قبل الحفظ. |
| UpdateLastSavedTimeProperty { get; set; } | يحصل على قيمة أو يعينها لتحديد ما إذا كانLastSavedTime يتم تحديث الخاصية قبل الحفظ. |
| UseAntiAliasing { get; set; } | يحصل على قيمة أو يعينها لتحديد ما إذا كان سيتم استخدام التنعيم للرسم أم لا. |
| UseGdiEmfRenderer { get; set; } | يحصل على قيمة أو يعينها لتحديد ما إذا كان سيتم استخدام GDI+ أو Aspose.Words metafile renderer عند الحفظ في EMF. |
| UseHighQualityRendering { get; set; } | يحصل على قيمة أو يعينها لتحديد ما إذا كان سيتم استخدام خوارزميات عرض عالية الجودة (أي بطيئة) أم لا. |
| VerticalResolution { get; set; } | يحصل على الدقة الرأسية للصور المولدة أو يضبطها، بنقاط لكل بوصة. |
طُرق
| اسم | وصف |
|---|---|
| Clone() | ينشئ نسخة طبق الأصل عميقة من هذا الكائن. |
| override Equals(object) | يحدد ما إذا كان الكائن المحدد يساوي في القيمة الكائن الحالي. |
أمثلة
يوضح كيفية تحديد الدقة أثناء عرض مستند بتنسيق PNG.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Font.Name = "Times New Roman";
builder.Font.Size = 24;
builder.Writeln("Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");
builder.InsertImage(ImageDir + "Logo.jpg");
// قم بإنشاء كائن "ImageSaveOptions" الذي يمكننا تمريره إلى طريقة "Save" الخاصة بالمستند
// لتعديل الطريقة التي تقوم بها هذه الطريقة بتحويل المستند إلى صورة.
ImageSaveOptions options = new ImageSaveOptions(SaveFormat.Png);
// اضبط خاصية "الدقة" على "72" لعرض المستند بدقة 72 نقطة في البوصة.
options.Resolution = 72;
doc.Save(ArtifactsDir + "ImageSaveOptions.Resolution.72dpi.png", options);
// اضبط خاصية "الدقة" على "300" لعرض المستند بدقة 300 نقطة في البوصة.
options.Resolution = 300;
doc.Save(ArtifactsDir + "ImageSaveOptions.Resolution.300dpi.png", options);
يوضح كيفية تكوين الضغط أثناء حفظ مستند بتنسيق JPEG.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertImage(ImageDir + "Logo.jpg");
// قم بإنشاء كائن "ImageSaveOptions" الذي يمكننا تمريره إلى طريقة "Save" الخاصة بالمستند
// لتعديل الطريقة التي تقوم بها هذه الطريقة بتحويل المستند إلى صورة.
ImageSaveOptions imageOptions = new ImageSaveOptions(SaveFormat.Jpeg);
// قم بضبط خاصية "JpegQuality" على "10" لاستخدام ضغط أقوى عند عرض المستند.
// سيؤدي هذا إلى تقليل حجم ملف المستند، ولكن الصورة ستعرض آثار ضغط أكثر وضوحًا.
imageOptions.JpegQuality = 10;
doc.Save(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighCompression.jpg", imageOptions);
// قم بضبط خاصية "JpegQuality" على "100" لاستخدام ضغط أضعف عند عرض المستند.
// سيؤدي هذا إلى تحسين جودة الصورة على حساب زيادة حجم الملف.
imageOptions.JpegQuality = 100;
doc.Save(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighQuality.jpg", imageOptions);
يقوم بتحويل صفحة من مستند Word إلى صورة ذات خلفية شفافة أو ملونة.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Font.Name = "Times New Roman";
builder.Font.Size = 24;
builder.Writeln("Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");
builder.InsertImage(ImageDir + "Logo.jpg");
// قم بإنشاء كائن "ImageSaveOptions" الذي يمكننا تمريره إلى طريقة "Save" الخاصة بالمستند
// لتعديل الطريقة التي تقوم بها هذه الطريقة بتحويل المستند إلى صورة.
ImageSaveOptions imgOptions = new ImageSaveOptions(SaveFormat.Png);
// اضبط خاصية "PaperColor" على لون شفاف لتطبيق لون شفاف
// خلفية المستند أثناء عرضه على صورة.
imgOptions.PaperColor = Color.Transparent;
doc.Save(ArtifactsDir + "ImageSaveOptions.PaperColor.Transparent.png", imgOptions);
// اضبط خاصية "PaperColor" على لون معتم لتطبيق هذا اللون
// كخلفية للمستند كما نقوم بتحويله إلى صورة.
imgOptions.PaperColor = Color.LightCoral;
doc.Save(ArtifactsDir + "ImageSaveOptions.PaperColor.LightCoral.png", imgOptions);
أنظر أيضا
- class FixedPageSaveOptions
- مساحة الاسم Aspose.Words.Saving
- المجسم Aspose.Words
