PageMediaSize Klasa

Definicja

Przestrzeń nazw:

System.Printing

Zestaw:

ReachFramework.dll

Opisuje rozmiar strony papieru lub innego nośnika.

public ref class PageMediaSize sealed

public sealed class PageMediaSize

type PageMediaSize = class

Public NotInheritable Class PageMediaSize

Dziedziczenie

Object

PageMediaSize

Przykłady

W poniższym przykładzie pokazano, jak za pomocą tej klasy skalować element wizualizacji w celu dopasowania go do marginesów papieru, na którym ma być drukowana.

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

Uwagi

Aby uzyskać informacje o klasie zawierającej te same informacje o rozmiarze nośnika, a PageMediaSize także informacje o obszarze obrazowym strony, zobacz PrintDocumentImageableArea.

Przestroga

Klasy w przestrzeni System.Printing nazw nie są obsługiwane w ramach usługi systemu Windows lub ASP.NET aplikacji lub usługi. Próba użycia tych klas z poziomu jednego z tych typów aplikacji może powodować nieoczekiwane problemy, takie jak zmniejszona wydajność usługi i wyjątki czasu wykonywania.

Jeśli chcesz wydrukować z aplikacji Windows Forms, zobacz System.Drawing.Printing przestrzeń nazw.

Konstruktory

PageMediaSize(Double, Double)	Inicjuje PageMediaSize nowe wystąpienie klasy przy użyciu szerokości i wysokości.
PageMediaSize(PageMediaSizeName)	Inicjuje PageMediaSize nowe wystąpienie klasy przy użyciu określonego PageMediaSizeNameelementu .
PageMediaSize(PageMediaSizeName, Double, Double)	Inicjuje PageMediaSize nowe wystąpienie klasy przy użyciu określonej wartości PageMediaSizeName oraz szerokości i wysokości.

Właściwości

Height	Pobiera wysokość strony.
PageMediaSizeName	Pobiera nazwę rozmiaru strony dla papieru lub innego nośnika.
Width	Pobiera szerokość strony.

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Wyświetla rozmiar strony papieru lub innego nośnika.