تعيين خيارات الصفحة باستخدام C++
Contents
[
Hide
]
في بعض الأحيان، من الضروري تكوين إعدادات إعداد الصفحة لورقات العمل للتحكم في الطباعة. توفر هذه الإعدادات خيارات مختلفة.
ضبط خيارات الصفحة
تدعم خيارات إعداد الصفحة بالكامل في Aspose.Cells. يشرح هذا المقال كيفية ضبط خيارات الصفحة مع Aspose.Cells ويعرض عينات الشفرة للضبط:
توفر Aspose.Cells فئة، Workbook، التي تمثل ملف Microsoft Excel. تحتوي فئة Workbook على مجموعة Worksheets التي تتيح الوصول إلى كل ورقة عمل في ملف Excel. تمثل ورقة عمل بفئة Worksheet.
توفر فئة Worksheet الخاصية PageSetup التي تُستخدم لتعيين خيارات إعداد الصفحة لورقة العمل. في الواقع، هذه الخاصية PageSetup عبارة عن كائن من فئة PageSetup يُستخدم لتعيين خيارات تخطيط الصفحة المختلفة لورقة عمل مطبوعة. توفر فئة PageSetup خصائص مختلفة تُستخدم لتعيين إعدادات الصفحة. بعض هذه الخصائص مذكورة أدناه.
اتجاه الصفحة
يمكن تعيين اتجاه الصفحة إلى عمودي أو أفقي باستخدام الخاصية GetOrientation() من فئة PageSetup. تقبل الخاصية GetOrientation() إحدى القيم المعتمدة في تعداد PageOrientationType، المدرجة أدناه.
| أنواع توجيه الصفحة | الوصف |
|---|---|
| Landscape | توجيه أفقي |
| Portrait | توجيه عمودي |
#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();
}
عامل التحليل
من الممكن تقليل أو تكبير حجم ورقة العمل عن طريق ضبط معامل التكبير باستخدام الخاصية PageSetup.GetZoom().
#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
لتتناسب محتويات ورقة العمل مع عدد معين من الصفحات، استخدم الخاصيتين GetFitToPagesTall() و GetFitToPagesWide() من فئة PageSetup. كما تُستخدم هذه الخاصيتين أيضًا لضبط مقياس ورقة العمل.
يمكنك إما اختيار الخاصية GetFitToPagesTall()/GetFitToPagesWide() أو الخاصية GetZoom() ولكن ليس كلاهما معاً.
#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();
}
حجم ورق
حدد حجم الورق الذي ستطبع عليه أوراق العمل باستخدام الخاصية GetPaperSize() من فئة PageSetup. تقبل الخاصية GetPaperSize() إحدى القيم المعتمدة في تعداد PaperSizeType، المدرجة أدناه.
| أنواع حجم الورق | الوصف |
|---|---|
| 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();
}
جودة الطباعة
تعيين جودة الطباعة للأوراق التي ستطبع باستخدام الخاصية GetPrintQuality() من فئة PageSetup. وحدة القياس لجودة الطباعة هو النقاط لكل إنش (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();
}
رقم الصفحة الأولى
ابدأ ترقيم صفحات ورقة العمل باستخدام الخاصية GetFirstPageNumber() من فئة PageSetup. تحدد الخاصية GetFirstPageNumber() رقم صفحة ورقة العمل الأولى، وتُرقم الصفحات التالية بترتيب تصاعدي.
#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();
}