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

也可以看看

ControlChar Class Document Class