PageMediaSize Clase

Definición

Espacio de nombres:

System.Printing

Ensamblado:

ReachFramework.dll

Describe el tamaño de página del papel u otro soporte.

public ref class PageMediaSize sealed

public sealed class PageMediaSize

type PageMediaSize = class

Public NotInheritable Class PageMediaSize

Herencia

Object

PageMediaSize

Ejemplos

En el ejemplo siguiente se muestra cómo usar esta clase para escalar un elemento visual para ajustarse a los márgenes del papel en el que se va a imprimir.

/// <summary>
///   Returns a scaled copy of a given visual transformed to
///   fit for printing to a specified print queue.</summary>
/// <param name="v">
///   The visual to be printed.</param>
/// <param name="pq">
///   The print queue to be output to.</param>
/// <returns>
///   The root element of the transformed visual.</returns>
private Visual PerformTransform(Visual v, PrintQueue pq)
{
    ContainerVisual root = new ContainerVisual();
    const double inch = 96;

    // Set the margins.
    double xMargin = 1.25 * inch;
    double yMargin = 1 * inch;

    PrintTicket pt = pq.UserPrintTicket;
    Double printableWidth = pt.PageMediaSize.Width.Value;
    Double printableHeight = pt.PageMediaSize.Height.Value;

    Double xScale = (printableWidth - xMargin * 2) / printableWidth;
    Double yScale = (printableHeight - yMargin * 2) / printableHeight;

    root.Children.Add(v);
    root.Transform = new MatrixTransform(xScale, 0, 0, yScale, xMargin, yMargin);

    return root;
}// end:PerformTransform()

''' <summary>
'''   Returns a scaled copy of a given visual transformed to
'''   fit for printing to a specified print queue.</summary>
''' <param name="v">
'''   The visual to be printed.</param>
''' <param name="pq">
'''   The print queue to be output to.</param>
''' <returns>
'''   The root element of the transformed visual.</returns>
Private Function PerformTransform(ByVal v As Visual, ByVal pq As PrintQueue) As Visual
    Dim root As New ContainerVisual()
    Const inch As Double = 96

    ' Set the margins.
    Dim xMargin As Double = 1.25 * inch
    Dim yMargin As Double = 1 * inch

    Dim pt As PrintTicket = pq.UserPrintTicket
    Dim printableWidth As Double = pt.PageMediaSize.Width.Value
    Dim printableHeight As Double = pt.PageMediaSize.Height.Value

    Dim xScale As Double = (printableWidth - xMargin * 2) / printableWidth
    Dim yScale As Double = (printableHeight - yMargin * 2) / printableHeight

    root.Children.Add(v)
    root.Transform = New MatrixTransform(xScale, 0, 0, yScale, xMargin, yMargin)

    Return root
End Function ' end:PerformTransform()

Comentarios

Para una clase que incluye la misma información sobre el tamaño PageMediaSize del medio que e incluye información sobre el área que se puede crear imágenes de la página, vea PrintDocumentImageableArea.

Precaución

Las clases dentro del System.Printing espacio de nombres no se admiten para su uso en un servicio de Windows ni en una aplicación o servicio de ASP.NET. Intentar usar estas clases desde uno de estos tipos de aplicación puede producir problemas inesperados, como una disminución del rendimiento del servicio y excepciones en tiempo de ejecución.

Si desea imprimir desde una aplicación de Windows Forms, consulte el System.Drawing.Printing espacio de nombres .

Constructores

PageMediaSize(Double, Double)	Inicializa una nueva instancia de la clase PageMediaSize utilizando el ancho y alto.
PageMediaSize(PageMediaSizeName)	Inicializa una nueva instancia de la clase PageMediaSize utilizando el objeto PageMediaSizeName especificado.
PageMediaSize(PageMediaSizeName, Double, Double)	Inicializa una nueva instancia de la clase PageMediaSize utilizando el PageMediaSizeName especificado y el ancho y alto.

Propiedades

Height	Obtiene el alto de página.
PageMediaSizeName	Obtiene el nombre del tamaño de página del papel u otro soporte.
Width	Obtiene el ancho de página.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Muestra el tamaño de página del papel u otro soporte.