ConvertUtil
Contents
[
Hide
]ConvertUtil class
Provides helper functions to convert between various measurement units.
To learn more, visit the Convert Between Measurement Units documentation article.
public static class ConvertUtil
Methods
Name | Description |
---|---|
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.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.PageSetup.PaperSize = PaperSize.Legal;
builder.PageSetup.Orientation = Orientation.Landscape;
builder.PageSetup.TopMargin = ConvertUtil.InchToPoint(1.0);
builder.PageSetup.BottomMargin = ConvertUtil.InchToPoint(1.0);
builder.PageSetup.LeftMargin = ConvertUtil.InchToPoint(1.5);
builder.PageSetup.RightMargin = ConvertUtil.InchToPoint(1.5);
builder.PageSetup.HeaderDistance = ConvertUtil.InchToPoint(0.2);
builder.PageSetup.FooterDistance = ConvertUtil.InchToPoint(0.2);
builder.Writeln("Hello world!");
doc.Save(ArtifactsDir + "PageSetup.PageMargins.docx");
Shows how to specify page properties in inches.
Document doc = new Document();
DocumentBuilder builder = new 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.
PageSetup pageSetup = builder.PageSetup;
pageSetup.TopMargin = ConvertUtil.InchToPoint(1.0);
pageSetup.BottomMargin = ConvertUtil.InchToPoint(2.0);
pageSetup.LeftMargin = ConvertUtil.InchToPoint(2.5);
pageSetup.RightMargin = ConvertUtil.InchToPoint(1.5);
// An inch is 72 points.
Assert.AreEqual(72.0d, ConvertUtil.InchToPoint(1));
Assert.AreEqual(1.0d, ConvertUtil.PointToInch(72));
// Add content to demonstrate the new margins.
builder.Writeln($"This Text is {pageSetup.LeftMargin} points/{ConvertUtil.PointToInch(pageSetup.LeftMargin)} inches from the left, " +
$"{pageSetup.RightMargin} points/{ConvertUtil.PointToInch(pageSetup.RightMargin)} inches from the right, " +
$"{pageSetup.TopMargin} points/{ConvertUtil.PointToInch(pageSetup.TopMargin)} inches from the top, " +
$"and {pageSetup.BottomMargin} points/{ConvertUtil.PointToInch(pageSetup.BottomMargin)} inches from the bottom of the page.");
doc.Save(ArtifactsDir + "UtilityClasses.PointsAndInches.docx");
See Also
- namespace Aspose.Words
- assembly Aspose.Words