Class ImageOrPrintOptions

اسم الفضاء : Aspose.Cells.Rendering تجميع: Aspose.Cells.dll (25.4.0)

يسمح بتحديد الخيارات عند تسجيل ورقة العمل إلى الصور أو طباعة ورقة العمل أو تسجيل الرسم البياني إلى الصورة.

public class ImageOrPrintOptions

Inheritance

object ← ImageOrPrintOptions

Examples

//Set Image Or Print Options
ImageOrPrintOptions options = new ImageOrPrintOptions();

//Set output image format
options.ImageType = ImageType.Png;

//Set Horizontal resolution
options.HorizontalResolution = 300;

//Set Vertical Resolution
options.VerticalResolution = 300;

//Instantiate Workbook
Workbook book = new Workbook("test.xls");

//Save chart as Image using ImageOrPrint Options
book.Worksheets[0].Charts[0].ToImage("chart.png", options);

'Set Image Or Print Options
Dim options As New ImageOrPrintOptions()

'Set output image format
options.ImageType = ImageType.Png

'Set Horizontal resolution
options.HorizontalResolution = 300

'Set Vertical Resolution
options.VerticalResolution = 300

'Instantiate Workbook
Dim book As New Workbook("test.xls")

'Save chart as Image using ImageOrPrint Options
book.Worksheets(0).Charts(0).ToImage("chart.png", options)

Constructors

ImageOrPrintOptions()

كاتور

public ImageOrPrintOptions()

Properties

AllColumnsInOnePagePerSheet

إذا كانت AllColumnsInOnePagePerSheet صحيحة ، فإن كل محتوى الأعمدة في ورقة واحدة سوف يخرج إلى صفحة واحدة فقط في النتيجة.سيتم إلغاء عرض حجم الورق للصفحات، وسيتم إلغاء الإعدادات الأخرى للصفحاتوستظل لها تأثير.

public bool AllColumnsInOnePagePerSheet { get; set; }

قيمة الممتلكات

bool

ChartImageType

إشارة نموذج الرسم البياني عند التحويل.القيمة الافتراضية: PNG

[Obsolete("Chart and Shape are always rendered as vector elements(e.g. point, line) for rendering quality.")]
[Browsable(false)]
public ImageFormat ChartImageType { get; set; }

قيمة الممتلكات

ImageFormat

Remarks

ملاحظة: هذا العضو قديم الآن، بدلا من ذلك،يتم تسليم الرسم البياني والشكل دائمًا كعنصر فيكتور (على سبيل المثال ، نقطة ، خط) لتسليم الجودة.سيتم إزالة هذا الممتلكات بعد 12 شهرًا من يونيو 2022.أعتذر عن أي اضطراب قد تعاني منه.

CheckWorkbookDefaultFont

عندما تكون الأحرف في Excel Unicode ولا يتم تعيينها مع الخط الصحيح في نمط الخلية ،يمكن أن تظهر على شكل كتلة في pdf، صورة.قم بتعيين هذا لتحاول استخدام الخط الافتراضي في دفتر العمل لإظهار هذه الأحرف أولاً.

public bool CheckWorkbookDefaultFont { get; set; }

قيمة الممتلكات

bool

Remarks

الافتراض صحيح.

CustomPrintPageEventHandler

يمكن للعميل إنتاج خاص للطابعة عند طباعة كل صفحة باستخدام هذا EventHandler

public PrintPageEventHandler CustomPrintPageEventHandler { get; set; }

قيمة الممتلكات

PrintPageEventHandler

CustomQueryPageSettingsEventHandler

يمكن للعميل التحكم في إعدادات الصفحة للطابعة عند طباعة كل صفحة باستخدام هذا EventHandler

public QueryPageSettingsEventHandler CustomQueryPageSettingsEventHandler { get; set; }

قيمة الممتلكات

QueryPageSettingsEventHandler

DefaultEditLanguage

يحصل أو يضع لغة التحرير الافتراضية.

public DefaultEditLanguage DefaultEditLanguage { get; set; }

قيمة الممتلكات

DefaultEditLanguage

Remarks

ويمكن عرض/إرسال ترتيبات مختلفة للفقرة النصية عند إعداد لغات التحرير المختلفة.الافتراضي هو Aspose.Cells.DefaultEditLanguage.Auto.

DefaultFont

عندما تكون الأحرف في Excel Unicode ولا يتم تعيينها مع الخط الصحيح في نمط الخلية ،يمكن أن تظهر على شكل كتلة في pdf، صورة.قم بتعيين DefaultFont مثل MingLiu أو MS Gothic لإظهار هذه الشخصيات.إذا لم يتم تعيين هذا الممتلكات، سوف تستخدم Aspose.Cells الخط الافتراضي للنظام لإظهار هذه الأحرف الوحيدة.

public string DefaultFont { get; set; }

قيمة الممتلكات

string

DrawObjectEventHandler

قم بتنفيذ هذا الواجهة للحصول على DrawObject و Bound عند التصوير.

public DrawObjectEventHandler DrawObjectEventHandler { get; set; }

قيمة الممتلكات

DrawObjectEventHandler

EmbededImageNameInSvg

إشارة اسم الصورة المدمجة في svg.يجب أن يكون هذا المسار الكامل مع دليل مثل “c:\xpsEmbedded”

[Obsolete("Images are always embedded in Svg with base64 format, please remove this property.")]
[Browsable(false)]
public string EmbededImageNameInSvg { get; set; }

قيمة الممتلكات

string

EmfRenderSetting

إعداد لتصنيف الميثافيلات EMF في ملف المصدر.

public EmfRenderSetting EmfRenderSetting { get; set; }

قيمة الممتلكات

EmfRenderSetting

Remarks

ويمكن أن تحتوي الميتافيلات EMF المحددة باسم “EMF+ Dual” على سجلات EMF+ وسجلات EMF.يمكن استخدام أي نوع من السجلات لعرض الصورة ، فقط سجلات EMF + ، أو فقط سجلات EMF.عندما يتم تعيين Aspose.Cells.EmfRenderSetting.EmfPlusPrefer ، سيتم تخصيص سجلات EMF+ أثناء تقديمها إلى الصورة ، وإلا سيتم تخصيص سجلات EMF فقط.القيمة الافتراضية هي Aspose.Cells.EmfRenderSetting.EmfOnly.بالنسبة للإطارات التي تعتمد على .Net System.Drawing.Common ، يتم تجاهل هذا الإعداد.

EmfType

يحصل أو يضع EmfType الذي يحدد تنسيق الميتافيل..القيمة الافتراضية هي EmfPlusDual.

public EmfType EmfType { get; set; }

قيمة الممتلكات

EmfType

GridlineType

يحصل أو يضع نوع الشبكة.

public GridlineType GridlineType { get; set; }

قيمة الممتلكات

GridlineType

Remarks

النوع المحدد هو النوع المحدد.

HorizontalResolution

يحصل أو يضع القرار الأفقي للصور التي تم إنشاؤها، في نقاط لكل بوصة.

public int HorizontalResolution { get; set; }

قيمة الممتلكات

int

Examples

يحدد الرمز التالي دقة 192، ويبلغ عرض وارتفاع الصورة التي تم إنشاؤها مرتين.يترك واحد مع القرار كقيمة افتراضية 96.

Workbook wb = new Workbook("Book1.xlsx");

ImageOrPrintOptions opts = new ImageOrPrintOptions();

//Set output image type: png.
opts.ImageType = ImageType.Png;

//Set resolution to 192.
opts.HorizontalResolution = 192;
opts.VerticalResolution = 192;

//Render worksheet page to image.
SheetRender sr = new SheetRender(wb.Worksheets[0], opts);
sr.ToImage(0, "Sheet_Page1.png");

Remarks

القيمة الافتراضية هي 96.

إعدادات Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution و Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution تؤثر على عرض وارتفاع الصورة الناتجة في بكسل.

ImageType

يحصل أو يضع تنسيق الصور التي تم إنشاؤها.القيمة الافتراضية: PNG

public virtual ImageType ImageType { get; set; }

قيمة الممتلكات

ImageType

IsCellAutoFit

يشير إلى ما إذا كان عرض وارتفاع الخلايا يتم تخصيصها تلقائيًا بقيمة الخلية.القيمة الافتراضية كاذبة.

[Obsolete("Use Worksheet.AutoFitColumns(AutoFitterOptions) and Worksheet.AutoFitRows(AutoFitterOptions) instead.")]
[Browsable(false)]
public bool IsCellAutoFit { get; set; }

قيمة الممتلكات

bool

Remarks

ملاحظة: هذا العضو قديم الآن، بدلا من ذلك،يرجى استخدام WL27_.Worksheet.AutoFitColumns(_W L 27.AutofitterOptions) و _ WL 27 _ .Warksheets.سيتم إزالة هذا الممتلكات بعد 12 شهرًا من أغسطس 2022.أعتذر عن أي اضطراب قد تعاني منه.

IsFontSubstitutionCharGranularity

يشير إلى ما إذا كان يجب استبدال الخط الحرفي فقط عندما لا تكون الخط الخلية متوافقة معها.

public bool IsFontSubstitutionCharGranularity { get; set; }

قيمة الممتلكات

bool

Remarks

سوف نحاول الخط الافتراضي من Workbook و PdfSaveOption/system للخط الخلوي أولا.

IsOptimized

إشارة إلى ما إذا كان لتحسين عناصر الإنتاج.

public bool IsOptimized { get; set; }

قيمة الممتلكات

bool

Remarks

القيمة الافتراضية كاذبة.في الوقت الحالي ، عندما يتم تثبيت هذه الممتلكات ، سيتم إجراء التحسينات التالية:

تحسين خطوط الحدود.
تحسين حجم الملف أثناء إرسال الصورة إلى Svg.

OnePagePerSheet

إذا كان OnePagePerSheet صحيحًا ، فإن كل محتوى ورقة واحدة سوف يخرج إلى صفحة واحدة فقط في النتيجة.سيتم إلغاء حجم الورق للصفحة، وسيتم إلغاء الإعدادات الأخرى للصفحةوستظل لها تأثير.

public bool OnePagePerSheet { get; set; }

قيمة الممتلكات

bool

OnlyArea

إذا كانت هذه الممتلكات صحيحة ، فإن منطقة واحدة ستكون إنتاجًا ، ولن يؤثر أي مقياس.

public bool OnlyArea { get; set; }

قيمة الممتلكات

bool

OutputBlankPageWhenNothingToPrint

إشارة إلى ما إذا كان لإنتاج صفحة فارغة عندما لا يوجد شيء للطباعة.

public bool OutputBlankPageWhenNothingToPrint { get; set; }

قيمة الممتلكات

bool

Remarks

الافتراض هو كاذب.

PageCount

يحصل أو يحدد عدد الصفحات التي يجب حفظها.

public int PageCount { get; set; }

قيمة الممتلكات

int

Remarks

الافتراضي هو System.Int32.MaxValue مما يعني أن جميع الصفحات سيتم تقديمها.

PageIndex

يحصل أو يضع المؤشر القائم على 0 من الصفحة الأولى لتخزين.

public int PageIndex { get; set; }

قيمة الممتلكات

int

Remarks

الافتراض هو 0.

PageSavingCallback

التحكم / إشارة التقدم في عملية حفظ الصفحة.

public IPageSavingCallback PageSavingCallback { get; set; }

قيمة الممتلكات

IPageSavingCallback

PixelFormat

يحصل أو يضع تنسيق البكسل للصور التي تم إنشاؤها.

public PixelFormat PixelFormat { get; set; }

قيمة الممتلكات

PixelFormat

Remarks

القيمة الافتراضية هي PixelFormat.Format32bppArgb.

PrintWithStatusDialog

إذا PrintWithStatusDialog = صحيح ، فسيكون هناك حوار يظهر حالة الطباعة الحالية.وإلا لن يظهر مثل هذا الحوار.

public bool PrintWithStatusDialog { get; set; }

قيمة الممتلكات

bool

PrintingPage

إشارة إلى الصفحات التي لن يتم طباعتها.

public PrintingPageType PrintingPage { get; set; }

قيمة الممتلكات

PrintingPageType

Quality

يحصل أو يحدد قيمة تحدد جودة imagesto التي تم إنشاؤها فقط عند حفظ الصفحات في تنسيق “Jpeg”.

public int Quality { get; set; }

قيمة الممتلكات

int

Remarks

يعمل فقط عند الادخار إلى JPEG.يجب أن يكون القيمة بين 0 و 100.القيمة الافتراضية هي 100.

فيديوهات متعلقة بـ

إذا كانت هذه الممتلكات صحيحة، فإن SVG التي تم إنشاؤها ستكون مناسبة لمشاهدة الميناء.

[Obsolete("Use SvgImageOptions.FitToViewPort property instead.")]
[Browsable(false)]
public bool SVGFitToViewPort { get; set; }

قيمة الممتلكات

bool

SaveFormat

يحصل أو يضع نموذج تنسيق ملف الإخراجدعم Tiff / XPS

[Obsolete("For Tiff/Svg, use ImageType; For Xps, use Workbook.Save(string, SaveOptions) with XpsSaveOptions")]
[Browsable(false)]
public SaveFormat SaveFormat { get; set; }

قيمة الممتلكات

SaveFormat

Remarks

ملاحظة: هذا العضو قديم الآن، بدلا من ذلك،بالنسبة لـ Tiff/Svg، استخدم Aspose.Cells.Rendering.ImageOrPrintOptions. ImageType؛ بالنسبة إلى Xps، قم باستخدام Wl27.Workbook.Save(System.String،W L 27 .SaverOption) مع _ WL27.سيتم إزالة هذا الممتلكات بعد 12 شهرًا من أغسطس 2022.أعتذر عن أي اضطراب قد تعاني منه.

SheetSet

احصل على أو وضع الأوراق لتقديم. الافتراضية هي جميع الأوراق المرئية في ورقة العمل: Aspose.Cells.Rendering.SheetSet.Visible.

public SheetSet SheetSet { get; set; }

قيمة الممتلكات

SheetSet

Remarks

يتم تجاهل المجموعة عند استخدامه في Aspose.Cells.Rendering.SheetRender

SmoothingMode

يحدد ما إذا كان التخفيف (مضاد التخفيف) يتم تطبيقه على الخطوط والمنحنيات وحواف المناطق المملوءة.القيمة الافتراضية هي SmoothingMode.None

public SmoothingMode SmoothingMode { get; set; }

قيمة الممتلكات

SmoothingMode

SvgCssPrefix

يحصل ويضع اسم css في svg،القيمة الافتراضية هي شريط فارغ.

[Obsolete("Use SvgImageOptions.CssPrefix property instead.")]
[Browsable(false)]
public string SvgCssPrefix { get; set; }

قيمة الممتلكات

string

TextCrossType

يحصل أو يضع عرض نوع النص عندما يكون عرض النص أكبر من عرض الخلية.

public TextCrossType TextCrossType { get; set; }

قيمة الممتلكات

TextCrossType

TextRenderingHint

يحدد نوعية تسجيل النص.القيمة الافتراضية هي TextRenderingHint.SystemDefault

public TextRenderingHint TextRenderingHint { get; set; }

قيمة الممتلكات

TextRenderingHint

TiffBinarizationMethod

الحصول على أو إعداد الطريقة المستخدمة أثناء تحويل الصور إلى تنسيق 1 bppعندما Aspose.Cells.Rendering.ImageOrPrintOptions.ImageType هو Tiff و Aspose.Cells.Rendering.ImageOrPrintOptions.TiffCompression يساوي Ccitt3 أو Ccitt4.

public ImageBinarizationMethod TiffBinarizationMethod { get; set; }

قيمة الممتلكات

ImageBinarizationMethod

Remarks

القيمة الافتراضية هي FloydSteinbergDithering.

TiffColorDepth

يحصل أو يحدد عمق قليلا لتطبيق فقط عند حفظ الصفحات في تنسيق “Tiff”.

public ColorDepth TiffColorDepth { get; set; }

قيمة الممتلكات

ColorDepth

Remarks

يعمل فقط عند توفير TIFF.إذا تم تعيين TiffCompression على CCITT3 ، CCITT4 ، فهذا لن يؤثر ، فإن عمق النقطة في صورة النقطة التي تم إنشاؤها سيكون دائمًا 1.

TiffCompression

يحصل أو يحدد نوع الضغط لتطبيقه فقط عند حفظ الصفحات في تنسيق “Tiff”.

public TiffCompression TiffCompression { get; set; }

قيمة الممتلكات

TiffCompression

Remarks

يعمل فقط عند توفير TIFF.القيمة الافتراضية هي Lzw.

Transparent

يشير إلى ما إذا كان خلفية الصورة التي تم إنشاؤها يجب أن تكون شفافة.

public bool Transparent { get; set; }

قيمة الممتلكات

bool

Remarks

القيمة الافتراضية وهمية وهذا يعني أن خلفية الصور التي تم إنشاؤها بيضاء.

VerticalResolution

يحصل أو يضع القرار العمودي للصور التي تم إنشاؤها، في نقاط لكل بوصة.

public int VerticalResolution { get; set; }

قيمة الممتلكات

int

Examples

يحدد الرمز التالي دقة 192، ويبلغ عرض وارتفاع الصورة التي تم إنشاؤها مرتين.يترك واحد مع القرار كقيمة افتراضية 96.

Workbook wb = new Workbook("Book1.xlsx");

ImageOrPrintOptions opts = new ImageOrPrintOptions();

//Set output image type: png.
opts.ImageType = ImageType.Png;

//Set resolution to 192.
opts.HorizontalResolution = 192;
opts.VerticalResolution = 192;

//Render Chart to image.
wb.Worksheets[0].Charts[0].ToImage("Chart.png", opts);

Remarks

القيمة الافتراضية هي 96.

WarningCallback

يحصل أو يضع تحذير استدعاء.

public IWarningCallback WarningCallback { get; set; }

قيمة الممتلكات

IWarningCallback

Methods

SetDesiredSize(إنت، إنت)

إعداد العرض والارتفاع المطلوب للصورة.

[Obsolete("Use SetDesiredSize(int, int, bool) by setting param keepAspectRatio to false instead.")]
public void SetDesiredSize(int desiredWidth, int desiredHeight)

Parameters

desiredWidth int

العرض المطلوب في بكسل

desiredHeight int

الارتفاع المطلوب في بكسل

Remarks

ملاحظة: هذا العضو قديم الآن، بدلا من ذلك،يرجى استخدام Aspose.Cells.Rendering.ImageOrPrintOptions.SetDesiredSize(System.Int32,System.Int32,System.Boolean) من خلال إعداد المعايير للحفاظ علىAspectRatio كاذبة.سيتم إزالة هذا الممتلكات بعد 12 شهرًا من مايو 2023.أعتذر عن أي اضطراب قد تعاني منه.

SetDesiredSize(إنت، إنت، بول)

إعداد العرض والارتفاع المطلوب للصورة.

public void SetDesiredSize(int desiredWidth, int desiredHeight, bool keepAspectRatio)

Parameters

desiredWidth int

العرض المطلوب في بكسل

desiredHeight int

الارتفاع المطلوب في بكسل

keepAspectRatio bool

كيفية الحفاظ على نسبة الجانب من صورة المنشأ

Remarks

عرض وارتفاع الصورة الناتجة في بكسل سوف تعتمد فقط على مجموعة عرض وارتفاع المرغوب فيه.

Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution و Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution لن تؤثر على عرض وارتفاع الصورة الناتجة في هذه الحالة.