PrintTicket.PageMediaSize Właściwość

Definicja

Przestrzeń nazw:

System.Printing

Zestaw:

ReachFramework.dll

Pobiera lub ustawia rozmiar strony papieru (lub innego nośnika), którego drukarka używa do zadania drukowania.

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

Wartość właściwości

PageMediaSize

PageMediaSize Obiekt reprezentujący rozmiar strony przy użyciu nazwy, wymiarów lub obu tych elementów.

Wyjątki

ArgumentOutOfRangeException

Wywołanie kodu próbowało ustawić właściwość z obiektem PageMediaSize , który ma co najmniej jedną null właściwość.

-lub-

Wywołanie kodu próbowało ustawić właściwość z obiektem PageMediaSize , którego PageMediaSizeName właściwość jest ustawiona na wartość, która nie znajduje się w wyliczenie PageMediaSizeName .

-lub-

Wywołanie kodu próbowało ustawić właściwość z obiektem PageMediaSize , którego Width właściwość lub Height jest ustawiona na wartość mniejszą niż 1.

Przykłady

W poniższym przykładzie pokazano, jak używać tej właściwości do skalowania elementu wizualizacji w celu dopasowania do marginesów papieru, na którym ma być wydrukowany.

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

Ta właściwość odpowiada słowu kluczowemu SchematPageMediaSize wydruku.

Możesz przetestować opcje obsługiwane przez drukarkę przy użyciu PageMediaSizeCapability właściwości .