¿Cómo establecer márgenes de papel para imprimir en C&#35

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

El constructor más simple toma un solo número 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 en 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 que evita la confusión de la clase System.Drawing.Printing.Margins que utiliza centésimas de pulgada. Un margen de 25,4 mm en IronPrint es equivalente a new System.Drawing.Printing.Margins(100) — no se requiere conversión matemática por nuestra parte.

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

Cuando un documento necesita espacio adicional en la parte superior para un membrete o en la inferior para un pie de página, usamos 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 todos los campos.

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

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

Notación abreviada 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)

Tenga en cuenta que la mayoría de las impresoras físicas imponen un área de impresión mínima a nivel de hardware. Configurar Margins.Zero envía instrucciones de margen cero al controlador, pero la impresora aún puede recortar el contenido cerca de los bordes dependiendo de sus capacidades.

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

PaperMargins es una propiedad de PrintSettings. Podemos combinarla con el tamaño del papel, orientación, DPI, copias, modo de 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 ASP.NET — reemplazar Printer.Print() por 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 formas 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 alimenta en PrintSettings.PaperMargins y funciona con ambos Printer.Print() y Printer.PrintAsync().

Para una mayor lectura, explora estos recursos:

• Tutoriales de IronPrint — Imprimir documento para recorridos completos de impresión.
• Guía sobre configuraciones de impresión 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 estáticos de impresión.

Obtenga una licencia de prueba gratuita para probar todas las características en un entorno en vivo, o vea las opciones de licencia cuando esté listo para implementar.