PageSet

ImageSaveOptions.PageSet property

Ruft die zu rendernden Seiten ab oder legt diese fest. Standard sind alle Seiten im Dokument.

public PageSet PageSet { get; set; }

Bemerkungen

Diese Eigenschaft hat nur beim Rendern von Dokumentseiten Auswirkungen. Diese Eigenschaft wird beim Rendern von Formen in Bilder ignoriert.

Beispiele

Zeigt, wie Seiten basierend auf genauen Seitenbereichen extrahiert werden.

Document doc = new Document(MyDir + "Images.docx");

ImageSaveOptions imageOptions = new ImageSaveOptions(SaveFormat.Tiff);
PageSet pageSet = new PageSet(new PageRange(1, 1), new PageRange(2, 3), new PageRange(1, 3),
    new PageRange(2, 4), new PageRange(1, 1));

imageOptions.PageSet = pageSet;
doc.Save(ArtifactsDir + "ImageSaveOptions.ExportVariousPageRanges.tiff", imageOptions);

Zeigt, wie Sie angeben, welche Seite in einem Dokument als Bild gerendert werden soll.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.ParagraphFormat.Style = doc.Styles["Heading 1"];
builder.Writeln("Hello world! This is page 1.");
builder.InsertBreak(BreakType.PageBreak);
builder.Writeln("This is page 2.");
builder.InsertBreak(BreakType.PageBreak);
builder.Writeln("This is page 3.");

Assert.AreEqual(3, doc.PageCount);

// Wenn wir das Dokument als Bild speichern, rendert Aspose.Words standardmäßig nur die erste Seite.
// Wir können ein SaveOptions-Objekt übergeben, um eine andere Seite zum Rendern anzugeben.
ImageSaveOptions saveOptions = new ImageSaveOptions(SaveFormat.Gif);

// Jede Seite des Dokuments in eine separate Bilddatei rendern.
for (int i = 1; i <= doc.PageCount; i++)
{
    saveOptions.PageSet = new PageSet(1);

    doc.Save(ArtifactsDir + $"ImageSaveOptions.PageIndex.Page {i}.gif", saveOptions);
}

Zeigt, wie jede Seite eines Dokuments in ein separates TIFF-Bild gerendert wird.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Writeln("Page 1.");
builder.InsertBreak(BreakType.PageBreak);
builder.Writeln("Page 2.");
builder.InsertImage(ImageDir + "Logo.jpg");
builder.InsertBreak(BreakType.PageBreak);
builder.Writeln("Page 3.");

// Erstellen Sie ein „ImageSaveOptions“-Objekt, das wir an die „Save“-Methode des Dokuments übergeben können
// um die Art und Weise zu ändern, wie diese Methode das Dokument in ein Bild rendert.
ImageSaveOptions options = new ImageSaveOptions(SaveFormat.Tiff);

for (int i = 0; i < doc.PageCount; i++)
{
    // Setze die Eigenschaft „PageSet“ auf die Nummer der ersten Seite von
    // von dem aus mit dem Rendern des Dokuments begonnen werden soll.
    options.PageSet = new PageSet(i);
    // Seite mit 2325 x 5325 Pixel und 600 dpi exportieren.
    options.Resolution = 600;
    options.ImageSize = new Size(2325, 5325);

    doc.Save(ArtifactsDir + $"ImageSaveOptions.PageByPage.{i + 1}.tiff", options);
}

Zeigt, wie eine Seite eines Dokuments in ein JPEG-Bild gerendert wird.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Writeln("Page 1.");
builder.InsertBreak(BreakType.PageBreak);
builder.Writeln("Page 2.");
builder.InsertImage(ImageDir + "Logo.jpg");
builder.InsertBreak(BreakType.PageBreak);
builder.Writeln("Page 3.");

// Erstellen Sie ein „ImageSaveOptions“-Objekt, das wir an die „Save“-Methode des Dokuments übergeben können
// um die Art und Weise zu ändern, wie diese Methode das Dokument in ein Bild rendert.
ImageSaveOptions options = new ImageSaveOptions(SaveFormat.Jpeg);

// Setzen Sie „PageSet“ auf „1“, um die zweite Seite auszuwählen
// der nullbasierte Index, von dem aus mit dem Rendern des Dokuments begonnen werden soll.
options.PageSet = new PageSet(1);

// Wenn wir das Dokument im JPEG-Format speichern, rendert Aspose.Words nur eine Seite.
// Dieses Bild enthält eine Seite beginnend mit Seite zwei,
// was nur die zweite Seite des Originaldokuments sein wird.
doc.Save(ArtifactsDir + "ImageSaveOptions.OnePage.jpg", options);

Siehe auch