ConvertUtil

ConvertUtil class

Proporciona funciones auxiliares para convertir entre varias unidades de medida.

Para obtener más información, visite elConvertir entre unidades de medida Artículo de documentación.

public static class ConvertUtil

Métodos

NombreDescripción
static InchToPoint(double)Convierte pulgadas a puntos.
static MillimeterToPoint(double)Convierte milímetros a puntos.
static PixelToNewDpi(double, double, double)Convierte píxeles de una resolución a otra.
static PixelToPoint(double)Convierte píxeles en puntos a 96 dpi.
static PixelToPoint(double, double)Convierte píxeles en puntos con la resolución de píxeles especificada.
static PointToInch(double)Convierte puntos a pulgadas.
static PointToPixel(double)Convierte puntos en píxeles a 96 dpi.
static PointToPixel(double, double)Convierte puntos en píxeles con la resolución de píxeles especificada.

Ejemplos

Muestra cómo ajustar el tamaño del papel, la orientación, los márgenes y otras configuraciones para una sección.

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

Muestra cómo especificar las propiedades de la página en pulgadas.

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

//La "Configuración de página" de una sección define el tamaño de los márgenes de la página en puntos.
// También podemos usar la clase "ConvertUtil" para utilizar una unidad de medida más familiar,
// como pulgadas al definir límites.
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);

//Una pulgada son 72 puntos.
Assert.AreEqual(72.0d, ConvertUtil.InchToPoint(1));
Assert.AreEqual(1.0d, ConvertUtil.PointToInch(72));

//Añadir contenido para demostrar los nuevos márgenes.
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");

Ver también

ControlChar Class Document Class