PrintTicket.PageMediaSize Properti

Definisi

Ruang nama:

System.Printing

Rakitan:

ReachFramework.dll

Mendapatkan atau menyetel ukuran halaman untuk kertas (atau media lain) yang digunakan printer untuk tugas cetak.

public:
 property System::Printing::PageMediaSize ^ PageMediaSize { System::Printing::PageMediaSize ^ get(); void set(System::Printing::PageMediaSize ^ value); };

public System.Printing.PageMediaSize PageMediaSize { get; set; }

member this.PageMediaSize : System.Printing.PageMediaSize with get, set

Public Property PageMediaSize As PageMediaSize

Nilai Properti

PageMediaSize

Objek PageMediaSize yang mewakili ukuran halaman dengan menggunakan nama, dimensi, atau keduanya.

Pengecualian

ArgumentOutOfRangeException

Kode panggilan telah mencoba mengatur properti dengan PageMediaSize objek yang memiliki setidaknya satu null properti.

-atau-

Kode panggilan telah mencoba mengatur properti dengan PageMediaSize objek yang propertinya PageMediaSizeName diatur ke nilai yang tidak ada dalam PageMediaSizeName enumerasi.

-atau-

Kode panggilan telah mencoba mengatur properti dengan PageMediaSize objek yang properti ataunya WidthHeight diatur ke nilai kurang dari 1.

Contoh

Contoh berikut menunjukkan cara menggunakan properti ini untuk menskalakan elemen visual agar pas dalam margin kertas yang akan dicetak.

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

Keterangan

Properti ini sesuai dengan kata kunci SkemaPageMediaSize Cetak.

Anda dapat menguji opsi yang didukung printer dengan menggunakan PageMediaSizeCapability properti .