Aspose::Words::ConvertUtil class
Contents
[
Hide
]ConvertUtil class
Provides helper functions to convert between various measurement units. To learn more, visit the Convert Between Measurement Units documentation article.
class ConvertUtil
Methods
| Method | Description |
|---|---|
| ConvertUtil() | |
| static InchToPoint(double) | Converts inches to points. |
| static MillimeterToPoint(double) | Converts millimeters to points. |
| static PixelToNewDpi(double, double, double) | Converts pixels from one resolution to another. |
| static PixelToPoint(double) | Converts pixels to points at 96 dpi. |
| static PixelToPoint(double, double) | Converts pixels to points at the specified pixel resolution. |
| static PointToInch(double) | Converts points to inches. |
| static PointToPixel(double) | Converts points to pixels at 96 dpi. |
| static PointToPixel(double, double) | Converts points to pixels at the specified pixel resolution. |
Examples
Shows how to adjust paper size, orientation, margins, along with other settings for a section.
auto doc = System::MakeObject<Aspose::Words::Document>();
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);
builder->get_PageSetup()->set_PaperSize(Aspose::Words::PaperSize::Legal);
builder->get_PageSetup()->set_Orientation(Aspose::Words::Orientation::Landscape);
builder->get_PageSetup()->set_TopMargin(Aspose::Words::ConvertUtil::InchToPoint(1.0));
builder->get_PageSetup()->set_BottomMargin(Aspose::Words::ConvertUtil::InchToPoint(1.0));
builder->get_PageSetup()->set_LeftMargin(Aspose::Words::ConvertUtil::InchToPoint(1.5));
builder->get_PageSetup()->set_RightMargin(Aspose::Words::ConvertUtil::InchToPoint(1.5));
builder->get_PageSetup()->set_HeaderDistance(Aspose::Words::ConvertUtil::InchToPoint(0.2));
builder->get_PageSetup()->set_FooterDistance(Aspose::Words::ConvertUtil::InchToPoint(0.2));
builder->Writeln(u"Hello world!");
doc->Save(get_ArtifactsDir() + u"PageSetup.PageMargins.docx");
Shows how to specify page properties in inches.
auto doc = System::MakeObject<Aspose::Words::Document>();
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);
// A section's "Page Setup" defines the size of the page margins in points.
// We can also use the "ConvertUtil" class to use a more familiar measurement unit,
// such as inches when defining boundaries.
System::SharedPtr<Aspose::Words::PageSetup> pageSetup = builder->get_PageSetup();
pageSetup->set_TopMargin(Aspose::Words::ConvertUtil::InchToPoint(1.0));
pageSetup->set_BottomMargin(Aspose::Words::ConvertUtil::InchToPoint(2.0));
pageSetup->set_LeftMargin(Aspose::Words::ConvertUtil::InchToPoint(2.5));
pageSetup->set_RightMargin(Aspose::Words::ConvertUtil::InchToPoint(1.5));
// An inch is 72 points.
ASPOSE_ASSERT_EQ(72.0, Aspose::Words::ConvertUtil::InchToPoint(1));
ASPOSE_ASSERT_EQ(1.0, Aspose::Words::ConvertUtil::PointToInch(72));
// Add content to demonstrate the new margins.
builder->Writeln(System::String::Format(u"This Text is {0} points/{1} inches from the left, ", pageSetup->get_LeftMargin(), Aspose::Words::ConvertUtil::PointToInch(pageSetup->get_LeftMargin())) + System::String::Format(u"{0} points/{1} inches from the right, ", pageSetup->get_RightMargin(), Aspose::Words::ConvertUtil::PointToInch(pageSetup->get_RightMargin())) + System::String::Format(u"{0} points/{1} inches from the top, ", pageSetup->get_TopMargin(), Aspose::Words::ConvertUtil::PointToInch(pageSetup->get_TopMargin())) + System::String::Format(u"and {0} points/{1} inches from the bottom of the page.", pageSetup->get_BottomMargin(), Aspose::Words::ConvertUtil::PointToInch(pageSetup->get_BottomMargin())));
doc->Save(get_ArtifactsDir() + u"UtilityClasses.PointsAndInches.docx");
See Also
- Namespace Aspose::Words
- Library Aspose.Words for C++