PageMediaSize Třída

Definice

Obor názvů:

System.Printing

Sestavení:

ReachFramework.dll

Popisuje velikost stránky pro papír nebo jiná média.

public ref class PageMediaSize sealed

public sealed class PageMediaSize

type PageMediaSize = class

Public NotInheritable Class PageMediaSize

Dědičnost

Object

PageMediaSize

Příklady

Následující příklad ukazuje, jak použít tuto třídu ke škálování vizuálního prvku tak, aby se vešly do okrajů papíru, na který se má vytisknout.

/// <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()

Poznámky

Třídu, která obsahuje stejné informace o velikosti média jako PageMediaSize a obsahuje také informace o oblasti stránky, která se dá zobrazit, najdete v tématu PrintDocumentImageableArea.

Upozornění

Třídy v rámci System.Printing oboru názvů nejsou podporovány pro použití v rámci služby systému Windows nebo ASP.NET aplikace nebo služby. Pokus o použití těchto tříd z jednoho z těchto typů aplikací může způsobit neočekávané problémy, jako je snížení výkonu služby a výjimky za běhu.

Pokud chcete tisknout z model Windows Forms aplikace, podívejte se na System.Drawing.Printing obor názvů.

Konstruktory

PageMediaSize(Double, Double)	Inicializuje novou instanci PageMediaSize třídy pomocí šířky a výšky.
PageMediaSize(PageMediaSizeName)	Inicializuje novou instanci PageMediaSize třídy pomocí zadané PageMediaSizeName.
PageMediaSize(PageMediaSizeName, Double, Double)	Inicializuje novou instanci PageMediaSize třídy pomocí zadané PageMediaSizeName a šířky a výšky.

Vlastnosti

Height	Získá výšku stránky.
PageMediaSizeName	Získá název velikosti stránky pro papír nebo jiné médium.
Width	Získá šířku stránky.

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Zobrazí velikost stránky pro papír nebo jiná média.