PageMediaSize Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Descreve o tamanho da página para papel ou outra mídia.
public ref class PageMediaSize sealed
public sealed class PageMediaSize
type PageMediaSize = class
Public NotInheritable Class PageMediaSize
- Herança
-
PageMediaSize
Exemplos
O exemplo a seguir mostra como usar essa classe para dimensionar um elemento visual para caber dentro das margens do papel no qual ela deve ser impressa.
/// <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()
Comentários
Para obter uma classe que inclui as mesmas informações sobre o tamanho PageMediaSize da mídia e também inclui informações sobre a área de imagem da página, consulte PrintDocumentImageableArea.
Cuidado
Classes dentro do System.Printing namespace não têm suporte para uso em um serviço do Windows ou ASP.NET aplicativo ou serviço. A tentativa de usar essas classes de dentro de um desses tipos de aplicativo pode produzir problemas inesperados, como redução do desempenho do serviço e exceções em tempo de execução.
Se você quiser imprimir de um aplicativo do Windows Forms, consulte o System.Drawing.Printing namespace.
Construtores
| Nome | Descrição |
|---|---|
| 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 a largura e a altura especificadas PageMediaSizeName . |
| PageMediaSize(PageMediaSizeName) |
Inicializa uma nova instância da PageMediaSize classe usando a especificada PageMediaSizeName. |
Propriedades
| Nome | Descrição |
|---|---|
| Height |
Obtém a altura da página. |
| PageMediaSizeName |
Obtém o nome do tamanho da página para papel ou outra mídia. |
| Width |
Obtém a largura da página. |
Métodos
| Nome | Descrição |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| ToString() |
Exibe o tamanho da página para papel ou outra mídia. |