Seiteneinstellungen mit C++

Manchmal ist es notwendig, Seiteneinrichtungseinstellungen für Arbeitsblätter zu konfigurieren, um den Druck zu steuern. Diese Seiteneinrichtungseinstellungen bieten verschiedene Optionen.

Seiteneinstellungen

Seiteneinrichtungsoptionen werden vollständig in Aspose.Cells unterstützt. Dieser Artikel erläutert, wie Seiteneinstellungen mit Aspose.Cells festgelegt werden, und zeigt Codebeispiele für die Einstellung von:

Aspose.Cells stellt eine Klasse, Workbook, bereit, die eine Microsoft Excel-Datei darstellt. Die Klasse Workbook enthält eine Worksheets-Sammlung, die den Zugriff auf jedes Arbeitsblatt in der Excel-Datei ermöglicht. Ein Arbeitsblatt wird durch die Klasse Worksheet repräsentiert.

Die Klasse Worksheet stellt die Eigenschaft PageSetup bereit, mit der die Seitenlayoutsoptionen des Arbeitsblatts eingestellt werden. Tatsächlich ist diese Eigenschaft PageSetup ein Objekt der Klasse PageSetup, das es ermöglicht, verschiedene Seitenlayout-Optionen für ein gedrucktes Arbeitsblatt festzulegen. Die Klasse PageSetup bietet verschiedene Eigenschaften, um die Seiteneinrichtung zu steuern. Einige dieser Eigenschaften werden unten erläutert.

Seitenausrichtung

Die Seitenorientierung kann mit der Eigenschaft GetOrientation() der Klasse PageSetup auf Hochformat oder Querformat eingestellt werden. Die Eigenschaft GetOrientation() akzeptiert einen der vordefinierten Werte im PageOrientationType Enumeration, die unten aufgeführt sind.

Seitenausrichtungstypen	Beschreibung
Landscape	Hochformat-Ausrichtung
Portrait	Porträtmodus

#include <iostream>
#include "Aspose.Cells.h"

using namespace Aspose::Cells;

int main()
{
    Aspose::Cells::Startup();

    // Source directory path
    U16String srcDir(u"..\\Data\\01_SourceDirectory\\");

    // Output directory path
    U16String outDir(u"..\\Data\\02_OutputDirectory\\");

    // Create a new workbook
    Workbook workbook;

    // Access the first worksheet in the workbook
    Worksheet worksheet = workbook.GetWorksheets().Get(0);

    // Set the page orientation to Portrait
    worksheet.GetPageSetup().SetOrientation(PageOrientationType::Portrait);

    // Save the workbook
    workbook.Save(outDir + u"PageOrientation_out.xls");

    std::cout << "Page orientation set successfully!" << std::endl;

    Aspose::Cells::Cleanup();
}

Maßstab

Es ist möglich, die Größe eines Arbeitsblatts zu verkleinern oder zu vergrößern, indem der Skalierungsfaktor mit der Eigenschaft PageSetup.GetZoom() eingestellt wird.

#include <iostream>
#include "Aspose.Cells.h"
using namespace Aspose::Cells;

int main()
{
    Aspose::Cells::Startup();

    // Source directory path
    U16String srcDir(u"..\\Data\\01_SourceDirectory\\");

    // Output directory path
    U16String outDir(u"..\\Data\\02_OutputDirectory\\");

    // Create a new workbook
    Workbook workbook;

    // Access the first worksheet in the workbook
    Worksheet worksheet = workbook.GetWorksheets().Get(0);

    // Set the scaling factor to 100
    worksheet.GetPageSetup().SetZoom(100);

    // Save the workbook
    workbook.Save(outDir + u"ScalingFactor_out.xls");

    std::cout << "Scaling factor set successfully!" << std::endl;

    Aspose::Cells::Cleanup();
}

FitToPages-Optionen

Um den Inhalt des Arbeitsblatts auf eine bestimmte Anzahl von Seiten anzupassen, verwenden Sie die Eigenschaften GetFitToPagesTall() und GetFitToPagesWide() der Klasse PageSetup. Diese Eigenschaften werden auch zum Skalieren von Arbeitsblättern verwendet.

Sie können entweder die Eigenschaften GetFitToPagesTall()/GetFitToPagesWide() oder GetZoom() auswählen, aber nicht beide gleichzeitig.

#include <iostream>
#include "Aspose.Cells.h"

using namespace Aspose::Cells;

int main()
{
    Aspose::Cells::Startup();

    // Source directory path
    U16String srcDir(u"..\\Data\\01_SourceDirectory\\");

    // Output directory path
    U16String outDir(u"..\\Data\\02_OutputDirectory\\");

    // Create a new workbook
    Workbook workbook;

    // Access the first worksheet in the workbook
    Worksheet worksheet = workbook.GetWorksheets().Get(0);

    // Set the number of pages to which the length of the worksheet will be spanned
    worksheet.GetPageSetup().SetFitToPagesTall(1);

    // Set the number of pages to which the width of the worksheet will be spanned
    worksheet.GetPageSetup().SetFitToPagesWide(1);

    // Save the workbook
    workbook.Save(outDir + u"FitToPagesOptions_out.xls");

    std::cout << "Workbook saved successfully with FitToPages options!" << std::endl;

    Aspose::Cells::Cleanup();
}

Papierformat

Legen Sie die Papiergröße fest, auf der die Arbeitsblätter gedruckt werden sollen, mit der Eigenschaft GetPaperSize() der Klasse PageSetup. Die Eigenschaft GetPaperSize() akzeptiert einen der vordefinierten Werte im PaperSizeType Enumeration, unten aufgeführt.

Papierformattypen	Beschreibung
PaperLetter	Letter (8-1/2 in. x 11 in.)
PaperLetterSmall	Letter Small (8-1/2 in. x 11 in.)
PaperTabloid	Tabloid (11 in. x 17 in.)
PaperLedger	Ledger (17 in. x 11 in.)
PaperLegal	Legal (8-1/2 in. x 14 in.)
PaperStatement	Statement (5-1/2 in. x 8-1/2 in.)
PaperExecutive	Executive (7-1/4 in. x 10-1/2 in.)
PaperA3	A3 (297 mm x 420 mm)
PaperA4	A4 (210 mm x 297 mm)
PaperA4Small	A4 Small (210 mm x 297 mm)
PaperA5	A5 (148 mm x 210 mm)
PaperB4	JIS B4 (257 mm x 364 mm)
PaperB5	JIS B5 (182 mm x 257 mm)
PaperFolio	Folio (8-1/2 in. x 13 in.)
PaperQuarto	Quarto (215 mm x 275 mm)
Paper10x14	10 in. x 14 in.
Paper11x17	11 in. x 17 in.
PaperNote	Note (8-1/2 in. x 11 in.)
PaperEnvelope9	Envelope #9 (3-7/8 in. x 8-7/8 in.)
PaperEnvelope10	Envelope #10 (4-1/8 in. x 9-1/2 in.)
PaperEnvelope11	Envelope #11 (4-1/2 in. x 10-3/8 in.)
PaperEnvelope12	Envelope #12 (4-1/2 in. x 11 in.)
PaperEnvelope14	Envelope #14 (5 in. x 11-1/2 in.)
PaperCSheet	C size sheet
PaperDSheet	D size sheet
PaperESheet	E size sheet
PaperEnvelopeDL	Envelope DL (110 mm x 220 mm)
PaperEnvelopeC5	Envelope C5 (162 mm x 229 mm)
PaperEnvelopeC3	Envelope C3 (324 mm x 458 mm)
PaperEnvelopeC4	Envelope C4 (229 mm x 324 mm)
PaperEnvelopeC6	Envelope C6 (114 mm x 162 mm)
PaperEnvelopeC65	Envelope C65 (114 mm x 229 mm)
PaperEnvelopeB4	Envelope B4 (250 mm x 353 mm)
PaperEnvelopeB5	Envelope B5 (176 mm x 250 mm)
PaperEnvelopeB6	Envelope B6 (176 mm x 125 mm)
PaperEnvelopeItaly	Envelope Italy (110 mm x 230 mm)
PaperEnvelopeMonarch	Envelope Monarch (3-7/8 in. x 7-1/2 in.)
PaperEnvelopePersonal	Envelope (3-5/8 in. x 6-1/2 in.)
PaperFanfoldUS	U.S. Standard Fanfold (14-7/8 in. x 11 in.)
PaperFanfoldStdGerman	German Standard Fanfold (8-1/2 in. x 12 in.)
PaperFanfoldLegalGerman	German Legal Fanfold (8-1/2 in. x 13 in.)
PaperISOB4	B4 (ISO) 250 x 353 mm
PaperJapanesePostcard	Japanese Postcard (100mm x 148mm)
Paper9x11	9 in. x 11 in.
Paper10x11	10 in. x 11 in.
Paper15x11	15 in. x 11 in.
PaperEnvelopeInvite	Envelope Invite(220mm x 220mm)
PaperLetterExtra	US Letter Extra 9 \275 x 12 in
PaperLegalExtra	US Legal Extra 9 \275 x 15 in
PaperTabloidExtra	US Tabloid Extra 11.69 x 18 in
PaperA4Extra	A4 Extra 9.27 x 12.69 in
PaperLetterTransverse	Letter Transverse 8 \275 x 11 in
PaperA4Transverse	A4 Transverse 210 x 297 mm
PaperLetterExtraTransverse	Letter Extra Transverse 9\275 x 12 in
PaperSuperA	SuperA/SuperA/A4 227 x 356 mm
PaperSuperB	SuperB/SuperB/A3 305 x 487 mm
PaperLetterPlus	US Letter Plus 8.5 x 12.69 in
PaperA4Plus	A4 Plus 210 x 330 mm
PaperA5Transverse	A5 Transverse 148 x 210 mm
PaperJISB5Transverse	B5 (JIS) Transverse 182 x 257 mm
PaperA3Extra	A3 Extra 322 x 445 mm
PaperA5Extra	A5 Extra 174 x 235 mm
PaperISOB5Extra	B5 (ISO) Extra 201 x 276 mm
PaperA2	A2 420 x 594 mm
PaperA3Transverse	A3 Transverse 297 x 420 mm
PaperA3ExtraTransverse	A3 Extra Transverse 322 x 445 mm
PaperJapaneseDoublePostcard	Japanese Double Postcard 200 x 148 mm
PaperA6	A6 105 x 148 mm
PaperJapaneseEnvelopeKaku2	Japanese Envelope Kaku #2
PaperJapaneseEnvelopeKaku3	Japanese Envelope Kaku #3
PaperJapaneseEnvelopeChou3	Japanese Envelope Chou #3
PaperJapaneseEnvelopeChou4	Japanese Envelope Chou #4
PaperLetterRotated	11in x 8.5in
PaperA3Rotated	420mm x 297mm
PaperA4Rotated	297mm x 210mm
PaperA5Rotated	210mm x 148mm
PaperJISB4Rotated	B4 (JIS) Rotated 364 x 257 mm
PaperJISB5Rotated	B5 (JIS) Rotated 257 x 182 mm
PaperJapanesePostcardRotated	Japanese Postcard Rotated 148 x 100 mm
PaperJapaneseDoublePostcardRotated	Double Japanese Postcard Rotated 148 x 200 mm
PaperA6Rotated	A6 Rotated 148 x 105 mm
PaperJapaneseEnvelopeKaku2Rotated	Japanese Envelope Kaku #2 Rotated
PaperJapaneseEnvelopeKaku3Rotated	Japanese Envelope Kaku #3 Rotated
PaperJapaneseEnvelopeChou3Rotated	Japanese Envelope Chou #3 Rotated
PaperJapaneseEnvelopeChou4Rotated	Japanese Envelope Chou #4 Rotated
PaperJISB6	B6 (JIS) 128 x 182 mm
PaperJISB6Rotated	B6 (JIS) Rotated 182 x 128 mm
Paper12x11	12 x 11 in
PaperJapaneseEnvelopeYou4	Japanese Envelope You #4
PaperJapaneseEnvelopeYou4Rotated	Japanese Envelope You #4 Rotated
PaperPRC16K	PRC 16K 146 x 215 mm
PaperPRC32K	PRC 32K 97 x 151 mm
PaperPRCBig32K	PRC 32K(Big) 97 x 151 mm
PaperPRCEnvelope1	PRC Envelope #1 102 x 165 mm
PaperPRCEnvelope2	PRC Envelope #2 102 x 176 mm
PaperPRCEnvelope3	PRC Envelope #3 125 x 176 mm
PaperPRCEnvelope4	PRC Envelope #4 110 x 208 mm
PaperPRCEnvelope5	PRC Envelope #5 110 x 220 mm
PaperPRCEnvelope6	PRC Envelope #6 120 x 230 mm
PaperPRCEnvelope7	PRC Envelope #7 160 x 230 mm
PaperPRCEnvelope8	PRC Envelope #8 120 x 309 mm
PaperPRCEnvelope9	PRC Envelope #9 229 x 324 mm
PaperPRCEnvelope10	PRC Envelope #10 324 x 458 mm
PaperPRC16KRotated	PRC 16K Rotated
PaperPRC32KRotated	PRC 32K Rotated
PaperPRCBig32KRotated	PRC 32K(Big) Rotated
PaperPRCEnvelope1Rotated	PRC Envelope #1 Rotated 165 x 102 mm
PaperPRCEnvelope2Rotated	PRC Envelope #2 Rotated 176 x 102 mm
PaperPRCEnvelope3Rotated	PRC Envelope #3 Rotated 176 x 125 mm
PaperPRCEnvelope4Rotated	PRC Envelope #4 Rotated 208 x 110 mm
PaperPRCEnvelope5Rotated	PRC Envelope #5 Rotated 220 x 110 mm
PaperPRCEnvelope6Rotated	PRC Envelope #6 Rotated 230 x 120 mm
PaperPRCEnvelope7Rotated	PRC Envelope #7 Rotated 230 x 160 mm
PaperPRCEnvelope8Rotated	PRC Envelope #8 Rotated 309 x 120 mm
PaperPRCEnvelope9Rotated	PRC Envelope #9 Rotated 324 x 229 mm
PaperPRCEnvelope10Rotated	PRC Envelope #10 Rotated 458 x 324 mm
PaperB3	usual B3(13.9 x 19.7 in)
PaperBusinessCard	Business Card(90mm x 55 mm)
PaperThermal	Thermal(3 x 11 in)
Custom	Represents the custom paper size.

#include <iostream>
#include "Aspose.Cells.h"

using namespace Aspose::Cells;

int main()
{
    Aspose::Cells::Startup();

    // Source directory path
    U16String srcDir(u"..\\Data\\01_SourceDirectory\\");

    // Output directory path
    U16String outDir(u"..\\Data\\02_OutputDirectory\\");

    // Create a new workbook
    Workbook workbook;

    // Access the first worksheet in the Excel file
    Worksheet worksheet = workbook.GetWorksheets().Get(0);

    // Setting the paper size to A4
    worksheet.GetPageSetup().SetPaperSize(PaperSizeType::PaperA4);

    // Save the workbook
    workbook.Save(outDir + u"ManagePaperSize_out.xls");

    std::cout << "Paper size set to A4 successfully!" << std::endl;

    Aspose::Cells::Cleanup();
}

Druckqualität

Stellen Sie die Druckqualität der Arbeitsblätter mit der Eigenschaft GetPrintQuality() der Klasse PageSetup ein. Die Einheit für die Druckqualität ist Dots Per Inches (DPI).

#include <iostream>
#include "Aspose.Cells.h"

using namespace Aspose::Cells;

int main()
{
    Aspose::Cells::Startup();

    // Source directory path
    U16String srcDir(u"..\\Data\\01_SourceDirectory\\");

    // Output directory path
    U16String outDir(u"..\\Data\\02_OutputDirectory\\");

    // Create a new workbook
    Workbook workbook;

    // Access the first worksheet in the workbook
    Worksheet worksheet = workbook.GetWorksheets().Get(0);

    // Set the print quality of the worksheet to 180 dpi
    worksheet.GetPageSetup().SetPrintQuality(180);

    // Save the workbook
    workbook.Save(outDir + u"SetPrintQuality_out.xls");

    std::cout << "Print quality set successfully!" << std::endl;

    Aspose::Cells::Cleanup();
}

Erste Seitenzahl

Beginnen Sie die Nummerierung der Arbeitsblätter mit der Eigenschaft GetFirstPageNumber() der Klasse PageSetup. Die Eigenschaft GetFirstPageNumber() legt die Seitennummer des ersten Arbeitsblattabschnitts fest, danach werden die Seiten aufsteigend nummeriert.

#include <iostream>
#include "Aspose.Cells.h"

using namespace Aspose::Cells;

int main()
{
    Aspose::Cells::Startup();

    // Source directory path
    U16String srcDir(u"..\\Data\\01_SourceDirectory\\");

    // Output directory path
    U16String outDir(u"..\\Data\\02_OutputDirectory\\");

    // Create a new workbook
    Workbook workbook;

    // Access the first worksheet in the workbook
    Worksheet worksheet = workbook.GetWorksheets().Get(0);

    // Set the first page number of the worksheet pages
    worksheet.GetPageSetup().SetFirstPageNumber(2);

    // Save the workbook
    workbook.Save(outDir + u"SetFirstPageNumber_out.xls");

    std::cout << "First page number set successfully!" << std::endl;

    Aspose::Cells::Cleanup();
}