Class ImageOrPrintOptions
Nazwa przestrzeń: Aspose.Cells.Rendering Zgromadzenie: Aspose.Cells.dll (25.4.0)
Pozwala określić opcje podczas renderowania arkuszy roboczych do obrazów, drukowania arkuszy roboczych lub renderowania wykresu do obrazu.
public class ImageOrPrintOptionsInheritance
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()
z Ctorem.
public ImageOrPrintOptions()Properties
AllColumnsInOnePagePerSheet
Jeśli AllColumnsInOnePagePerSheet jest prawdziwy, cała zawartość kolumny jednego arkusza wyjdzie na tylko jedną stronę w wyniku.Szerokość rozmiaru papieru strony będzie nieważna, a pozostałe ustawienia stronyBędzie nadal działać.
public bool AllColumnsInOnePagePerSheet { get; set; }Wartość nieruchomości
ChartImageType
Wprowadź typ obrazu podczas konwersji.Wartość zwykła: 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; }Wartość nieruchomości
Remarks
UWAGA: Ten członek jest teraz przestarzały. zamiast tego,Charta i kształt są zawsze renderowane jako elementy wektorowe (np. punkt, linia) w celu renderowania jakości.Ten obiekt zostanie usunięty 12 miesięcy później od czerwca 2022 roku.Aspose przeprasza za wszelkie nieprzyjemności, które możesz doświadczyć.
CheckWorkbookDefaultFont
Kiedy znaky w programie Excel są Unicode i nie są ustawione z prawidłowym czcionką w stylu komórkowym,Mogą one pojawić się jako bloki w PDF, obrazie.Ustaw to na prawdę, aby spróbować użyć czcionki domyślnej książki roboczej, aby najpierw wyświetlić te znaki.
public bool CheckWorkbookDefaultFont { get; set; }Wartość nieruchomości
Remarks
Defekt jest prawdą.
CustomPrintPageEventHandler
Klient może wydrukować specjalne wydruki do drukarki podczas drukowania każdej strony za pomocą tego EventHandler
public PrintPageEventHandler CustomPrintPageEventHandler { get; set; }Wartość nieruchomości
CustomQueryPageSettingsEventHandler
Klient może kontrolować ustawienia strony drukarki podczas drukowania każdej strony za pomocą tego EventHandler
public QueryPageSettingsEventHandler CustomQueryPageSettingsEventHandler { get; set; }Wartość nieruchomości
DefaultEditLanguage
Dostęp lub ustaw język edycji domyślnej.
public DefaultEditLanguage DefaultEditLanguage { get; set; }Wartość nieruchomości
Remarks
Może wyświetlać/przekazywać różne układy dla paragrafów tekstowych, gdy ustawione są różne języki edycji.Standardem jest Aspose.Cells.DefaultEditLanguage.Auto.
DefaultFont
Kiedy znaky w programie Excel są Unicode i nie są ustawione z prawidłowym czcionką w stylu komórkowym,Mogą one pojawić się jako bloki w PDF, obrazie.Ustaw DefaultFont, takie jak MingLiu lub MS Gothic, aby wyświetlić te postacie.Jeśli ta właściwość nie jest ustawiona, Aspose.Cells będzie używać czcionki domyślnej systemu, aby wyświetlić te znaky unicodu.
public string DefaultFont { get; set; }Wartość nieruchomości
DrawObjectEventHandler
Wprowadź tę interfejs, aby uzyskać DrawObject i Bound podczas renderowania.
public DrawObjectEventHandler DrawObjectEventHandler { get; set; }Wartość nieruchomości
EmbededImageNameInSvg
Wprowadź nazwę filem wbudowanego obrazu w svg.Powinno to być pełna ścieżka z katalogami, takimi jak “c:\xpsEmbedded”
[Obsolete("Images are always embedded in Svg with base64 format, please remove this property.")]
[Browsable(false)]
public string EmbededImageNameInSvg { get; set; }Wartość nieruchomości
EmfRenderSetting
Ustawienia do renderowania metafil Emf w pliku źródłowym.
public EmfRenderSetting EmfRenderSetting { get; set; }Wartość nieruchomości
Remarks
Metafisy EMF zidentyfikowane jako „EMF+ Dual” mogą zawierać zarówno rekordy EMF+ jak i rekordy EMF.Niezależnie od tego, czy typ nagrania może być używany do przekazywania obrazu, tylko rekordy EMF+, czy tylko rekordy EMF.Po ustawieniu Aspose.Cells.EmfRenderSetting.EmfPlusPrefer rekordy EMF+ zostaną parsowane podczas renderowania do obrazu, w przeciwnym razie tylko rekordy EMF zostaną parsowane.Wartość domyślna to Aspose.Cells.EmfRenderSetting.EmfOnly.Dla ram, które zależą od .Net System.Drawing.Common, to ustawienie jest ignorowane.
EmfType
Otrzymuje lub ustawia EmfType, który określa format Metafile.
public EmfType EmfType { get; set; }Wartość nieruchomości
GridlineType
Dostęp lub ustawienie typu gridline.
public GridlineType GridlineType { get; set; }Wartość nieruchomości
Remarks
Podstawowy typ jest typowy.
HorizontalResolution
Uzyskuje lub ustawia rozdzielczość horyzontalną dla generowanych obrazów, w punktach na cala.
public int HorizontalResolution { get; set; }Wartość nieruchomości
Examples
Następny kod ustawia rozdzielczość do 192, szerokość i wysokość generowanego obrazu jest dwukrotnie większa niżTen z rozdzielczością pozostaje jako wartość domyślna 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
Wartość zwykła wynosi 96.
Ustawienie Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution i Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution wpływa na szerokość i wysokość obrazu wyjściowego w pikselach.
ImageType
otrzymuje lub ustawia format generowanych obrazów.Wartość zwykła: PNG
public virtual ImageType ImageType { get; set; }Wartość nieruchomości
IsCellAutoFit
Oznacza, czy szerokość i wysokość komórek są automatycznie dostosowane do wartości komórkowej.Wartość domyślna jest fałszywa.
[Obsolete("Use Worksheet.AutoFitColumns(AutoFitterOptions) and Worksheet.AutoFitRows(AutoFitterOptions) instead.")]
[Browsable(false)]
public bool IsCellAutoFit { get; set; }Wartość nieruchomości
Remarks
UWAGA: Ten członek jest teraz przestarzały. zamiast tego,Prosimy o użycie Aspose.Cells.Worksheet.AutoFitColumns(_W L 27.AutofitterOptions) i __ WL 27 _.Trybucja robocza.Ten obiekt zostanie usunięty 12 miesięcy później od sierpnia 2022 roku.Aspose przeprasza za wszelkie nieprzyjemności, które możesz doświadczyć.
IsFontSubstitutionCharGranularity
Oznacza, czy zastąpić czcionkę charakteru tylko wtedy, gdy czcionka komórkowa nie jest dla niej kompatybilna.
public bool IsFontSubstitutionCharGranularity { get; set; }Wartość nieruchomości
Remarks
Będziemy najpierw spróbować podanego czcionki Workbook i PdfSaveOption/system dla czcionki komórkowej.
IsOptimized
Wskazywać, czy optymalizować elementy wyjściowe.
public bool IsOptimized { get; set; }Wartość nieruchomości
Remarks
Podstawowe wartości są fałszywe.W chwili obecnej, gdy ta nieruchomość zostanie ustalona, zostaną wykonane następujące optymalizacje:
- Optymalizacja linii granicznych.
- Optymalizuj rozmiar pliku podczas renderowania do obrazu Svg.
OnePagePerSheet
Jeśli OnePagePerSheet jest prawdziwy, cała zawartość jednego arkusza wyjdzie na tylko jedną stronę w wyniku.Rozmiar papieru strony będzie nieważny, a pozostałe ustawienia stronyBędzie nadal działać.
public bool OnePagePerSheet { get; set; }Wartość nieruchomości
OnlyArea
Jeśli to właściwość jest prawdziwa, jeden obszar będzie produktem, a żadna skalę nie będzie działać.
public bool OnlyArea { get; set; }Wartość nieruchomości
OutputBlankPageWhenNothingToPrint
Oznacza, czy wyprodukować białą stronę, gdy nie ma nic do wydruku.
public bool OutputBlankPageWhenNothingToPrint { get; set; }Wartość nieruchomości
Remarks
Defekt jest fałszywy.
PageCount
Otrzymuje lub ustawia liczbę stron do przechowywania.
public int PageCount { get; set; }Wartość nieruchomości
Remarks
Standardem jest System.Int32.MaxValue, co oznacza, że wszystkie strony zostaną zrealizowane.
PageIndex
Otrzymuje lub ustawia indeks oparty na 0 na pierwszej stronie do zapisywania.
public int PageIndex { get; set; }Wartość nieruchomości
Remarks
Defekt jest 0.
PageSavingCallback
Kontrola / wskazanie postępu procesu oszczędzania stron.
public IPageSavingCallback PageSavingCallback { get; set; }Wartość nieruchomości
PixelFormat
Otrzymuje lub ustawia format piksela dla generowanych obrazów.
public PixelFormat PixelFormat { get; set; }Wartość nieruchomości
Remarks
Wartość domyślna to PixelFormat.Format32bppArgb.
PrintWithStatusDialog
Jeśli PrintWithStatusDialog = prawda, pojawi się dialog, który pokazuje aktualny status drukowania.W przeciwnym razie nie będzie takiego dialogu.
public bool PrintWithStatusDialog { get; set; }Wartość nieruchomości
PrintingPage
Pokaż, które strony nie będą drukowane.
public PrintingPageType PrintingPage { get; set; }Wartość nieruchomości
Quality
Otrzymuje lub ustawia wartość określającą jakość generowanego imagesto stosuje się tylko w przypadku oszczędzania stron w formacie “Jpeg”.
public int Quality { get; set; }Wartość nieruchomości
Remarks
Działa tylko w przypadku oszczędzania na JPEG.Wartość powinna wynosić od 0 do 100.Wartość zwykła wynosi 100.
Wiadomości SVGFitToViewPort
Jeśli ta nieruchomość jest prawdziwa, generowany swg będzie pasuje do widzenia portu.
[Obsolete("Use SvgImageOptions.FitToViewPort property instead.")]
[Browsable(false)]
public bool SVGFitToViewPort { get; set; }Wartość nieruchomości
SaveFormat
otrzymuje lub ustawia typ formatu pliku wyjściowegoObsługa Tiff/XPS
[Obsolete("For Tiff/Svg, use ImageType; For Xps, use Workbook.Save(string, SaveOptions) with XpsSaveOptions")]
[Browsable(false)]
public SaveFormat SaveFormat { get; set; }Wartość nieruchomości
Remarks
UWAGA: Ten członek jest teraz przestarzały. zamiast tego,W przypadku Tiff/Svg, użyj Aspose.Cells.Rendering.ImageOrPrintOptions. ImageType; w przypadku Xps, skorzystaj z W L27.Workbook.Save(System.String,Wl27__.saveOption) z __ WL27.Ten obiekt zostanie usunięty 12 miesięcy później od sierpnia 2022 roku.Aspose przeprasza za wszelkie nieprzyjemności, które możesz doświadczyć.
SheetSet
Podstawowe jest wszystkie widoczne liście w podręczniku: Aspose.Cells.Rendering.SheetSet.Visible.
public SheetSet SheetSet { get; set; }Wartość nieruchomości
Remarks
Zestaw jest ignorowany, gdy jest używany w Aspose.Cells.Rendering.SheetRender
SmoothingMode
Określa, czy nawilżanie (antialiasing) jest stosowane do linii i zakrętów oraz krawędzi wypełnionych obszarów.Wartość domyślna to SmoothingMode.None
public SmoothingMode SmoothingMode { get; set; }Wartość nieruchomości
SvgCssPrefix
Otrzymuje i ustawia prefix nazwy css w svg,wartość domyślna jest pusty pasek.
[Obsolete("Use SvgImageOptions.CssPrefix property instead.")]
[Browsable(false)]
public string SvgCssPrefix { get; set; }Wartość nieruchomości
TextCrossType
Otrzymuje lub ustawia wyświetlający typ tekstu, gdy szerokość tekstu jest większa niż szerokość komórki.
public TextCrossType TextCrossType { get; set; }Wartość nieruchomości
TextRenderingHint
Dotyczy to jakości renderowania tekstu.Wartość domyślna jest TextRenderingHint.SystemDefault
public TextRenderingHint TextRenderingHint { get; set; }Wartość nieruchomości
TiffBinarizationMethod
Uzyskuje lub ustawia metodę używaną podczas konwersji obrazów do formatu 1 bppkiedy Aspose.Cells.Rendering.ImageOrPrintOptions.ImageType jest Tiff i Aspose.Cells.Rendering.ImageOrPrintOptions.TiffCompression jest równy Ccitt3 lub Ccitt4.
public ImageBinarizationMethod TiffBinarizationMethod { get; set; }Wartość nieruchomości
Remarks
Wartość domyślna to FloydSteinbergDithering.
TiffColorDepth
Otrzymuje lub ustawia bit głębokości do zastosowania tylko w przypadku oszczędzania stron w formacie “Tiff”.
public ColorDepth TiffColorDepth { get; set; }Wartość nieruchomości
Remarks
Działa tylko w przypadku oszczędzania na TIFF.Jeśli aplikacja TiffCompression jest ustawiona na CCITT3, CCITT4, to nie będzie działać, bit głębokość generowanego obrazu tiff będzie zawsze 1.
TiffCompression
Otrzymuje lub ustawia typ kompresji do zastosowania tylko w przypadku oszczędzania stron w formacie „Tiff”.
public TiffCompression TiffCompression { get; set; }Wartość nieruchomości
Remarks
Działa tylko w przypadku oszczędzania na TIFF.Wartość domyślna to Lzw.
Transparent
Oznacza, czy tło generowanego obrazu powinno być przejrzyste.
public bool Transparent { get; set; }Wartość nieruchomości
Remarks
Wartość domyślna jest fałszywa, co oznacza, że tło generowanych obrazów jest białe.
VerticalResolution
Otrzymuje lub ustawia rozdzielczość pionową dla generowanych obrazów, w punktach na cala.
public int VerticalResolution { get; set; }Wartość nieruchomości
Examples
Następny kod ustawia rozdzielczość do 192, szerokość i wysokość generowanego obrazu jest dwukrotnie większa niżTen z rozdzielczością pozostaje jako wartość domyślna 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
Wartość zwykła wynosi 96.
Ustawienie Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution i Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution wpływa na szerokość i wysokość obrazu wyjściowego w pikselach.
WarningCallback
Dostęp lub ustaw ostrzeżenie callback.
public IWarningCallback WarningCallback { get; set; }Wartość nieruchomości
Methods
SetDesiredSize(i int, int)
Ustaw pożądany szerokość i wysokość obrazu.
[Obsolete("Use SetDesiredSize(int, int, bool) by setting param keepAspectRatio to false instead.")]
public void SetDesiredSize(int desiredWidth, int desiredHeight)Parameters
desiredWidth int
Pożądana szerokość w pikselach
desiredHeight int
Pożądana wysokość w pikselach
Remarks
UWAGA: Ten członek jest teraz przestarzały. zamiast tego,Proszę użyć Aspose.Cells.Rendering.ImageOrPrintOptions.SetDesiredSize(System.Int32,System.Int32,System.Boolean) poprzez ustawienie parametrów, aby AspectRatio był fałszywy.Ten obiekt zostanie usunięty 12 miesięcy później od maja 2023 roku.Aspose przeprasza za wszelkie nieprzyjemności, które możesz doświadczyć.
SetDesiredSize(Int, int, bool)
Ustaw pożądany szerokość i wysokość obrazu.
public void SetDesiredSize(int desiredWidth, int desiredHeight, bool keepAspectRatio)Parameters
desiredWidth int
Pożądana szerokość w pikselach
desiredHeight int
Pożądana wysokość w pikselach
keepAspectRatio bool
Czy należy zachować stosunek aspektowy obrazu pochodzenia
Remarks
Szerokość i wysokość obrazu wyjściowego w pikselach będzie oparta tylko na pożądanej szerokości i wysokości.
Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution i Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution nie wpłynie na szerokość i wysokość obrazu wyjściowego w tym przypadku.
