ImageSaveOptions
Inhalt
[
Ausblenden
]ImageSaveOptions class
Ermöglicht die Angabe zusätzlicher Optionen beim Rendern von Dokumentseiten oder Formen in Bilder.
Um mehr zu erfahren, besuchen Sie dieSpeicheroptionen festlegen Dokumentationsartikel.
public class ImageSaveOptions : FixedPageSaveOptions
Konstrukteure
| Name | Beschreibung |
|---|---|
| ImageSaveOptions(SaveFormat) | Initialisiert eine neue Instanz dieser Klasse, die zum Speichern gerenderter Bilder im verwendet werden kann.Tiff ,Png ,Bmp , Jpeg ,Emf ,Eps , WebP oderSvg format. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| AllowEmbeddingPostScriptFonts { get; set; } | Ruft einen booleschen Wert ab oder legt ihn fest, der angibt, ob das Einbetten von Schriftarten mit PostScript-Konturen beim Einbetten von TrueType-Schriftarten in ein Dokument beim Speichern zulässig ist. Der Standardwert istFALSCH . |
| ColorMode { get; set; } | Ruft einen Wert ab oder legt ihn fest, der bestimmt, wie Farben gerendert werden. |
| CustomTimeZoneInfo { get; set; } | Ruft die benutzerdefinierte lokale Zeitzone ab, die für Datums-/Uhrzeitfelder verwendet wird, oder legt diese fest. |
| DefaultTemplate { get; set; } | Ruft den Pfad zur Standardvorlage ab oder legt ihn fest (einschließlich Dateiname). Der Standardwert für diese Eigenschaft istleere Zeichenfolge (Empty ). |
| Dml3DEffectsRenderingMode { get; set; } | Ruft einen Wert ab oder legt ihn fest, der bestimmt, wie 3D-Effekte gerendert werden. |
| virtual DmlEffectsRenderingMode { get; set; } | Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, wie DrawingML-Effekte gerendert werden. |
| DmlRenderingMode { get; set; } | Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, wie DrawingML-Formen gerendert werden. |
| ExportGeneratorName { get; set; } | WannWAHR , bewirkt, dass der Name und die Version von Aspose.Words in die erstellten Dateien eingebettet werden. Der Standardwert istWAHR . |
| GraphicsQualityOptions { get; set; } | Ermöglicht die Angabe von Rendering-Modus und Qualität für dieGraphics Objekt. |
| HorizontalResolution { get; set; } | Ruft die horizontale Auflösung für die generierten Bilder in Punkten pro Zoll ab oder legt sie fest. |
| ImageBrightness { get; set; } | Ruft die Helligkeit für die generierten Bilder ab oder legt sie fest. |
| ImageColorMode { get; set; } | Ruft den Farbmodus für die generierten Bilder ab oder legt ihn fest. |
| ImageContrast { get; set; } | Ruft den Kontrast für die generierten Bilder ab oder legt ihn fest. |
| ImageSize { get; set; } | Ruft die Größe eines generierten Bildes in Pixeln ab oder legt sie fest. |
| ImlRenderingMode { get; set; } | Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, wie InkML-Objekte gerendert werden. |
| JpegQuality { get; set; } | Ruft einen Wert ab oder legt ihn fest, der die Qualität der generierten JPEG-Bilder bestimmt. |
| MemoryOptimization { get; set; } | Ruft einen Wert ab oder legt ihn fest, der bestimmt, ob vor dem Speichern des Dokuments eine Speicheroptimierung durchgeführt werden soll. Der Standardwert für diese Eigenschaft istFALSCH . |
| MetafileRenderingOptions { get; } | Ermöglicht die Angabe, wie Metadateien in der gerenderten Ausgabe behandelt werden. |
| NumeralFormat { get; set; } | Ruft ab oder legt festNumeralFormat Wird zur Darstellung von Ziffern verwendet. Standardmäßig werden europäische Ziffern verwendet. |
| virtual OptimizeOutput { get; set; } | Flag gibt an, ob es zur Optimierung der Ausgabe erforderlich ist. Wenn dieses Flag gesetzt ist, werden redundante verschachtelte Leinwände und leere Leinwände entfernt, auch benachbarte Glyphen mit der gleichen Formatierung werden verkettet. Hinweis: Die Genauigkeit der Inhaltsanzeige kann beeinträchtigt werden, wenn diese Eigenschaft aufWAHR . Standard istFALSCH . |
| PageSavingCallback { get; set; } | Ermöglicht die Steuerung, wie einzelne Seiten gespeichert werden, wenn ein Dokument in ein festes Seitenformat exportiert wird. |
| PageSet { get; set; } | Ruft die zu rendernden Seiten ab oder legt sie fest. Standardmäßig sind alle Seiten im Dokument dargestellt. |
| PaperColor { get; set; } | Ruft die Hintergrundfarbe (Papierfarbe) für die generierten Bilder ab oder legt sie fest. |
| PixelFormat { get; set; } | Ruft das Pixelformat für die generierten Bilder ab oder legt es fest. |
| PrettyFormat { get; set; } | WannWAHR , formatiert die Ausgabe, wo anwendbar. Der Standardwert istFALSCH . |
| ProgressCallback { get; set; } | Wird beim Speichern eines Dokuments aufgerufen und akzeptiert Daten zum Speicherfortschritt. |
| Resolution { set; } | Legt sowohl die horizontale als auch die vertikale Auflösung für die generierten Bilder in Punkten pro Zoll fest. |
| override SaveFormat { get; set; } | Gibt das Format an, in dem die gerenderten Dokumentseiten oder Formen gespeichert werden, wenn dieses Speicheroptionsobjekt verwendet wird. Kann ein Raster sein Tiff ,Png ,Bmp , Jpeg oder VektorEmf ,Eps , WebP ,Svg . |
| Scale { get; set; } | Ruft den Zoomfaktor für die generierten Bilder ab oder legt ihn fest. |
| TempFolder { get; set; } | Gibt den Ordner für temporäre Dateien an, der beim Speichern in eine DOC- oder DOCX-Datei verwendet wird. Standardmäßig ist diese Eigenschaftnull und es werden keine temporären Dateien verwendet. |
| ThresholdForFloydSteinbergDithering { get; set; } | Ruft den Schwellenwert ab oder legt ihn fest, der den Wert des Binärisierungsfehlers in der Floyd-Steinberg-Methode bestimmt. wennImageBinarizationMethod IstFloydSteinbergDithering . |
| TiffBinarizationMethod { get; set; } | Ruft die Methode ab oder legt sie fest, die beim Konvertieren von Bildern in das 1-bpp-Format verwendet wird , wennSaveFormat IstTiff und TiffCompression ist gleichCcitt3 oderCcitt4 . |
| TiffCompression { get; set; } | Ruft den Komprimierungstyp ab, der beim Speichern generierter Bilder im TIFF-Format angewendet werden soll, oder legt diesen fest. |
| UpdateAmbiguousTextFont { get; set; } | Bestimmt, ob die Schriftattribute entsprechend dem verwendeten Zeichencode geändert werden. |
| UpdateCreatedTimeProperty { get; set; } | Ruft einen Wert ab oder legt ihn fest, der bestimmt, ob dieCreatedTime Eigenschaft wird vor dem Speichern aktualisiert. Der Standardwert istFALSCH ; |
| UpdateFields { get; set; } | Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, ob Felder bestimmter Typen aktualisiert werden sollen, bevor das Dokument in einem festen Seitenformat gespeichert wird. Der Standardwert für diese Eigenschaft istWAHR . |
| UpdateLastPrintedProperty { get; set; } | Ruft einen Wert ab oder legt ihn fest, der bestimmt, ob dieLastPrinted Eigenschaft wird vor dem Speichern aktualisiert. |
| UpdateLastSavedTimeProperty { get; set; } | Ruft einen Wert ab oder legt ihn fest, der bestimmt, ob dieLastSavedTime Eigenschaft wird vor dem Speichern aktualisiert. |
| UseAntiAliasing { get; set; } | Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, ob Anti-Aliasing zum Rendern verwendet werden soll oder nicht. |
| UseGdiEmfRenderer { get; set; } | Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, ob beim Speichern in EMF der GDI+- oder Aspose.Words-Metadatei-Renderer verwendet werden soll. |
| UseHighQualityRendering { get; set; } | Ruft einen Wert ab oder legt ihn fest, der bestimmt, ob qualitativ hochwertige (d. h. langsame) Rendering-Algorithmen verwendet werden sollen oder nicht. |
| VerticalResolution { get; set; } | Ruft die vertikale Auflösung für die generierten Bilder in Punkten pro Zoll ab oder legt sie fest. |
Methoden
| Name | Beschreibung |
|---|---|
| Clone() | Erstellt einen tiefen Klon dieses Objekts. |
| override Equals(object) | Bestimmt, ob das angegebene Objekt den gleichen Wert wie das aktuelle Objekt hat. |
Beispiele
Zeigt, wie Sie beim Rendern eines Dokuments in PNG eine Auflösung angeben.
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");
// Erstellen Sie ein "ImageSaveOptions"-Objekt, das wir an die "Save"-Methode des Dokuments übergeben können
// um die Art und Weise zu ändern, in der diese Methode das Dokument in ein Bild umwandelt.
ImageSaveOptions options = new ImageSaveOptions(SaveFormat.Png);
// Setzen Sie die Eigenschaft „Auflösung“ auf „72“, um das Dokument in 72 dpi zu rendern.
options.Resolution = 72;
doc.Save(ArtifactsDir + "ImageSaveOptions.Resolution.72dpi.png", options);
// Setzen Sie die Eigenschaft „Auflösung“ auf „300“, um das Dokument in 300 dpi zu rendern.
options.Resolution = 300;
doc.Save(ArtifactsDir + "ImageSaveOptions.Resolution.300dpi.png", options);
Zeigt, wie die Komprimierung beim Speichern eines Dokuments als JPEG konfiguriert wird.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertImage(ImageDir + "Logo.jpg");
// Erstellen Sie ein "ImageSaveOptions"-Objekt, das wir an die "Save"-Methode des Dokuments übergeben können
// um die Art und Weise zu ändern, in der diese Methode das Dokument in ein Bild umwandelt.
ImageSaveOptions imageOptions = new ImageSaveOptions(SaveFormat.Jpeg);
// Setzen Sie die Eigenschaft „JpegQuality“ auf „10“, um beim Rendern des Dokuments eine stärkere Komprimierung zu verwenden.
// Dadurch wird die Dateigröße des Dokuments reduziert, das Bild weist jedoch deutlichere Komprimierungsartefakte auf.
imageOptions.JpegQuality = 10;
doc.Save(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighCompression.jpg", imageOptions);
// Setzen Sie die Eigenschaft „JpegQuality“ auf „100“, um beim Rendern des Dokuments eine schwächere Komprimierung zu verwenden.
// Dadurch wird die Bildqualität verbessert, allerdings erhöht sich die Dateigröße.
imageOptions.JpegQuality = 100;
doc.Save(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighQuality.jpg", imageOptions);
Rendert eine Seite eines Word-Dokuments in ein Bild mit transparentem oder farbigem Hintergrund.
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");
// Erstellen Sie ein "ImageSaveOptions"-Objekt, das wir an die "Save"-Methode des Dokuments übergeben können
// um die Art und Weise zu ändern, in der diese Methode das Dokument in ein Bild umwandelt.
ImageSaveOptions imgOptions = new ImageSaveOptions(SaveFormat.Png);
// Setzen Sie die Eigenschaft „PaperColor“ auf eine transparente Farbe, um eine transparente
// Hintergrund des Dokuments, während es in ein Bild gerendert wird.
imgOptions.PaperColor = Color.Transparent;
doc.Save(ArtifactsDir + "ImageSaveOptions.PaperColor.Transparent.png", imgOptions);
// Setzen Sie die Eigenschaft „PaperColor“ auf eine undurchsichtige Farbe, um diese Farbe anzuwenden
// als Hintergrund des Dokuments, wenn wir es in ein Bild rendern.
imgOptions.PaperColor = Color.LightCoral;
doc.Save(ArtifactsDir + "ImageSaveOptions.PaperColor.LightCoral.png", imgOptions);
Siehe auch
- class FixedPageSaveOptions
- namensraum Aspose.Words.Saving
- Montage Aspose.Words
