ConvertUtil

ConvertUtil class

提供帮助函数在各种测量单位之间进行转换。

public static class ConvertUtil

方法

姓名 描述
static InchToPoint(double) 将英寸转换为磅。
static MillimeterToPoint(double) 将毫米转换为磅。
static PixelToNewDpi(double, double, double) 将像素从一种分辨率转换为另一种分辨率。
static PixelToPoint(double) 将像素转换为 96 dpi 的点。
static PixelToPoint(double, double) 将像素转换为指定像素分辨率的点。
static PointToInch(double) 将点转换为英寸。
static PointToPixel(double) 将点转换为 96 dpi 的像素。
static PointToPixel(double, double) 将点转换为指定像素分辨率的像素。

例子

显示如何调整纸张大小、方向、边距以及部分的其他设置。

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");

显示如何以英寸为单位指定页面属性。

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

// 一个部分的“页面设置”定义了页边距的大小,以磅为单位。
// 我们也可以使用“ConvertUtil”类来使用更熟悉的度量单位,
// 例如定义边界时的英寸。
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);

// 一英寸是 72 磅。
Assert.AreEqual(72.0d, ConvertUtil.InchToPoint(1));
Assert.AreEqual(1.0d, ConvertUtil.PointToInch(72));

// 添加内容以演示新的边距。
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");

也可以看看