Cómo establecer márgenes de papel para imprimir en C

¿Cómo puedo establecer márgenes iguales en todos los lados?

El constructor más simple toma un solo entero y lo aplica uniformemente a los cuatro lados. Pasamos el valor en milímetros:

:path=/static-assets/print/content-code-examples/how-to/set-paper-margins/set-paper-margins-uniform-margins.cs

using IronPrint;

// Configure a uniform 20 mm margin on all sides
PrintSettings settings = new PrintSettings
{
    PaperMargins = new Margins(20),
    PaperSize = PaperSize.A4
};

// Print the invoice
Printer.Print("invoice.pdf", settings);

Imports IronPrint

' Configure a uniform 20 mm margin on all sides
Dim settings As New PrintSettings With {
    .PaperMargins = New Margins(20),
    .PaperSize = PaperSize.A4
}

' Print the invoice
Printer.Print("invoice.pdf", settings)

Margins(20) establece Left, Top, Right, y Bottom cada uno a 20 mm. Esta es la opción más común para documentos de negocios estándar donde el espacio en blanco consistente en cada borde es suficiente.

IronPrint mide los márgenes en milímetros, lo cual evita la confusión de la clase System.Drawing.Printing.Margins que usa centésimas de pulgada. Un margen de 25.4 mm en IronPrint es equivalente a new System.Drawing.Printing.Margins(100) — no se requiere cálculo de conversión de nuestra parte.

¿Cómo configuro diferentes márgenes para cada lado?

Cuando un documento necesita espacio extra en la parte superior para un membrete o en la parte inferior para un pie de página, utilizamos el constructor de cuatro parámetros:

:path=/static-assets/print/content-code-examples/how-to/set-paper-margins/set-paper-margins-per-side-margins.cs

using IronPrint;

// Configure per-side margins (left, top, right, bottom)
PrintSettings settings = new PrintSettings
{
    PaperMargins = new Margins(10, 25, 10, 20),
    PaperOrientation = PaperOrientation.Portrait
};

// Print the letterhead
Printer.Print("letterhead.pdf", settings);

Imports IronPrint

' Configure per-side margins (left, top, right, bottom)
Dim settings As New PrintSettings With {
    .PaperMargins = New Margins(10, 25, 10, 20),
    .PaperOrientation = PaperOrientation.Portrait
}

' Print the letterhead
Printer.Print("letterhead.pdf", settings)

El orden de los parámetros es left, top, right, bottom. Cada valor es independiente, por lo que podemos crear diseños asimétricos que acomoden encabezados, pies de página, bordes de encuadernación o espacio para perforaciones. La referencia de la API de la clase Margins documenta cada campo.

¿Qué opciones abreviadas existen para diseños de márgenes comunes?

La clase Margins de IronPrint ofrece dos constructores adicionales más allá de las versiones uniforme y por lado:

Abreviatura Horizontal / Vertical — Margins(int horizontal, int vertical) establece izquierda+derecha en el primer valor y arriba+abajo en el segundo:

:path=/static-assets/print/content-code-examples/how-to/set-paper-margins/set-paper-margins-shorthand-margins.cs

using IronPrint;

// Configure horizontal and vertical margin shorthand
PrintSettings settings = new PrintSettings
{
    PaperMargins = new Margins(10, 20)
};

// Print the landscape report
Printer.Print("report-landscape.pdf", settings);

Imports IronPrint

' Configure horizontal and vertical margin shorthand
Dim settings As New PrintSettings With {
    .PaperMargins = New Margins(10, 20)
}

' Print the landscape report
Printer.Print("report-landscape.pdf", settings)

Márgenes cero — Margins.Zero elimina todos los márgenes para impresión sin bordes:

:path=/static-assets/print/content-code-examples/how-to/set-paper-margins/set-paper-margins-zero-margins.cs

using IronPrint;

// Configure zero margins for edge-to-edge printing
PrintSettings borderless = new PrintSettings
{
    PaperMargins = new Margins(0)
};

// Print the poster
Printer.Print("poster.png", borderless);

Imports IronPrint

' Configure zero margins for edge-to-edge printing
Dim borderless As New PrintSettings With {
    .PaperMargins = New Margins(0)
}

' Print the poster
Printer.Print("poster.png", borderless)

Ten en cuenta que la mayoría de las impresoras físicas tienen un área mínima de impresión por hardware. Establecer Margins.Zero envía instrucciones de márgenes cero al controlador, pero la impresora aún puede cortar contenido cerca de los bordes dependiendo de sus capacidades.

¿Cómo combino márgenes con otras configuraciones de impresión?

PaperMargins es una propiedad en PrintSettings. Podemos combinarlo con tamaño de papel, orientación, DPI, copias, modo en escala de grises y selección de impresora en un único objeto de configuración:

:path=/static-assets/print/content-code-examples/how-to/set-paper-margins/set-paper-margins-combined-settings.cs

using IronPrint;

// Configure full print settings with asymmetric margins
PrintSettings settings = new PrintSettings
{
    PaperMargins = new Margins(15, 20, 15, 25),
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,
    NumberOfCopies = 2,
    Grayscale = false,
    PrinterName = "HP LaserJet Pro MFP M428"
};

// Print the Q4 report to the named printer
Printer.Print("Q4-report.pdf", settings);

Imports IronPrint

' Configure full print settings with asymmetric margins
Dim settings As New PrintSettings With {
    .PaperMargins = New Margins(15, 20, 15, 25),
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300,
    .NumberOfCopies = 2,
    .Grayscale = False,
    .PrinterName = "HP LaserJet Pro MFP M428"
}

' Print the Q4 report to the named printer
Printer.Print("Q4-report.pdf", settings)

Para flujos de trabajo asíncronos — WPF, MAUI, o aplicaciones web de ASP.NET — reemplaza Printer.Print() con await Printer.PrintAsync() para evitar bloquear el hilo de la interfaz de usuario. El mismo objeto PrintSettings funciona con ambos métodos.

¿Cuales son mis próximos pasos?

Cubrimos cuatro maneras de configurar márgenes de impresión con IronPrint: márgenes uniformes usando Margins(int), control por lado con Margins(int, int, int, int), la abreviatura horizontal/vertical Margins(int, int), y la impresión sin bordes con Margins.Zero. Cada enfoque se integra en PrintSettings.PaperMargins y funciona tanto con Printer.Print() como con Printer.PrintAsync().

Para una mayor lectura, explora estos recursos:

• Tutoriales de IronPrint — Imprimir Documento para recorridos completos de impresión.
• Cómo configurar impresiones para DPI, orientación, copias y más.
• Referencia de la API de la clase Margins para documentación completa de constructores y campos.
• Referencia de API de la Clase Printer para todos los métodos de impresión estáticos.

Obtenga una licencia de prueba gratuita para probar todas las funciones en un entorno en vivo, o vea las opciones de licencias cuando esté listo para desplegar.