PageMediaSize Classe

Definição

Descreve o tamanho da página para papel ou outro suporte.

public ref class PageMediaSize sealed
public sealed class PageMediaSize
type PageMediaSize = class
Public NotInheritable Class PageMediaSize
Herança
PageMediaSize

Exemplos

O exemplo seguinte mostra como usar esta classe para escalar um elemento visual para caber nas margens do papel onde vai 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()

Observações

Para uma aula que inclua a mesma informação sobre o tamanho do media que PageMediaSize e também inclua informações sobre a área imaginável da página, veja PrintDocumentImageableArea.

Atenção

As classes dentro do espaço de nomes System.Printing não são suportadas para uso dentro de um serviço Windows ou ASP.NET aplicação ou serviço. Tentar usar estas classes dentro de um destes tipos de aplicação pode produzir problemas inesperados, como desempenho de serviço diminuído e exceções em tempo de execução.

Se quiseres imprimir a partir de uma aplicação Windows Forms, vê o espaço de nomes System.Drawing.Printing.

Construtores

Name Description
PageMediaSize(Double, Double)

Inicializa uma nova instância da PageMediaSize classe usando a largura e a altura.

PageMediaSize(PageMediaSizeName, Double, Double)

Inicializa uma nova instância da PageMediaSize classe usando o especificado PageMediaSizeName e a largura e altura.

PageMediaSize(PageMediaSizeName)

Inicializa uma nova instância da PageMediaSize classe usando o especificado PageMediaSizeName.

Propriedades

Name Description
Height

Obtém a altura da página.

PageMediaSizeName

Obtém o nome do tamanho da página para papel ou outro suporte.

Width

Obtém a largura da página.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Mostra o tamanho da página para papel ou outro suporte.

Aplica-se a