Class ImageOrPrintOptions

نام ها : Aspose.Cells.Rendering جمع آوری: WL27_.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

هنگامی که کاراکترها در اکسل 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

هنگامی که کاراکترها در اکسل 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.OutofitRows(Wl 27 .Autophitter Options).این املاک 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 = true باشد، یک گفتگو وجود خواهد داشت که وضعیت چاپ فعلی را نشان می دهد.در غیر این صورت چنین گفتگویی وجود نخواهد داشت.

public bool PrintWithStatusDialog { get; set; }

ارزش املاک

bool

PrintingPage

مشخص کنید که کدام صفحه چاپ نمی شود.

public PrintingPageType PrintingPage { get; set; }

ارزش املاک

PrintingPageType

Quality

دریافت یا تنظیم یک مقدار تعیین کننده کیفیت تصویر تولید شده تنها زمانی اعمال می شود که صفحات را به فرمت “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.ImmageType استفاده کنید؛ برای Xps از Wl27.Workbook.Save(System.String،W L 27 .Savoptions) با گزینه های _www.wl27.این املاک 12 ماه بعد از آگوست 2022 حذف خواهد شد.عذرخواهی برای هر گونه ناراحتی که ممکن است تجربه کرده اید.

SheetSet

به طور پیش فرض تمام ورق های قابل مشاهده در دفتر کار: Aspose.Cells.Rendering.SheetSet.Visible است.

public SheetSet SheetSet { get; set; }

ارزش املاک

SheetSet

Remarks

این مجموعه هنگامی که در Aspose.Cells.Rendering.SheetRender استفاده می شود نادیده گرفته می شود.

SmoothingMode

مشخص می کند که آیا نرم کردن (antialiasing) به خطوط و منحنی ها و لبه های مناطق پر شده اعمال می شود یا خیر.ارزش پیش فرض 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 است.

تنظیمات Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution و Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution بر عرض و ارتفاع تصویر خروجی در پیکسل تاثیر می گذارد.

WarningCallback

دریافت یا تنظیم هشدار callback.

public IWarningCallback WarningCallback { get; set; }

ارزش املاک

IWarningCallback

Methods

SetDesiredSize(int، int)

تنظیم عرض و ارتفاع تصویر مورد نظر.

[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(int، int، bool)

تنظیم عرض و ارتفاع تصویر مورد نظر.

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 در این مورد عرض و ارتفاع تصویر خروجی را تحت تاثیر قرار نمی دهد.