Class ImageOrPrintOptions

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, который указывает формат Metafile.Стандартная стоимость – 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

Примечание: этот член сейчас устарел. вместо этого,Пожалуйста, используйте Aspose.Cells.Worksheet.AutoFitColumns(W L 27.AutofitterOptions) и __ WL 27 .Toolsheet .AutofitRows ( W L 28_ .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.

SVGFitToViewPort

Если эта собственность истинна, генерируемый 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 _.Эта недвижимость будет удалена через 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

Получается или устанавливается глубина, которая должна применяться только при сохранении страниц в формате «Тифф».

public ColorDepth TiffColorDepth { get; set; }

Стоимость недвижимости

ColorDepth

Remarks

Действует только при сбережении в TIFF.Если TiffCompression настроен на CCITT3, CCITT4, это не вступит в силу, то длина длинности генерируемого изображения тиф всегда будет 1.

TiffCompression

Получается или устанавливается тип компрессии, который должен применяться только при сохранении страниц в формате «Тифф».

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

Получить или установить предупреждение звонка.

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 не окажет воздействия на ширину и высоту выхода изображения в этом случае.

 Русский