ConvertUtil

ConvertUtil class

Bietet Hilfsfunktionen zum Umrechnen zwischen verschiedenen Maßeinheiten.

Um mehr zu erfahren, besuchen Sie dieZwischen Maßeinheiten umrechnen Dokumentationsartikel.

public static class ConvertUtil

Methoden

NameBeschreibung
static InchToPoint(double)Konvertiert Zoll in Punkte.
static MillimeterToPoint(double)Wandelt Millimeter in Punkte um.
static PixelToNewDpi(double, double, double)Konvertiert Pixel von einer Auflösung in eine andere.
static PixelToPoint(double)Konvertiert Pixel in Punkte mit 96 dpi.
static PixelToPoint(double, double)Konvertiert Pixel in Punkte mit der angegebenen Pixelauflösung.
static PointToInch(double)Konvertiert Punkte in Zoll.
static PointToPixel(double)Konvertiert Punkte in Pixel mit 96 dpi.
static PointToPixel(double, double)Konvertiert Punkte in Pixel mit der angegebenen Pixelauflösung.

Beispiele

Zeigt, wie Papiergröße, Ausrichtung, Ränder und andere Einstellungen für einen Abschnitt angepasst werden.

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

Zeigt, wie Seiteneigenschaften in Zoll angegeben werden.

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

// Die „Seiteneinrichtung“ eines Abschnitts definiert die Größe der Seitenränder in Punkten.
// Wir können auch die Klasse „ConvertUtil“ verwenden, um eine bekanntere Maßeinheit zu verwenden,
// wie Zoll beim Definieren von Grenzen.
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);

// Ein Zoll entspricht 72 Punkten.
Assert.AreEqual(72.0d, ConvertUtil.InchToPoint(1));
Assert.AreEqual(1.0d, ConvertUtil.PointToInch(72));

// Inhalt hinzufügen, um die neuen Ränder zu demonstrieren.
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");

Siehe auch