PrintTicket.PageMediaSize Egenskap

Definition

Namnområde:
System.Printing
Sammansättning:
ReachFramework.dll

Hämtar eller anger sidstorleken för det papper (eller annat medium) som en skrivare använder för ett utskriftsjobb.

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

Egenskapsvärde

PageMediaSize

Ett PageMediaSize objekt som representerar sidstorleken med hjälp av ett namn, dimensioner eller båda.

Undantag

ArgumentOutOfRangeException

Anropande kod har försökt ange egenskapen med ett PageMediaSize objekt som har minst en null egenskap.

-eller-

Anropande kod har försökt ange egenskapen med ett PageMediaSize objekt vars PageMediaSizeName egenskap är inställd på ett värde som inte finns i PageMediaSizeName uppräkningen.

-eller-

Anropande kod har försökt ange egenskapen med ett PageMediaSize objekt vars Width eller Height egenskapen är inställd på ett värde som är mindre än 1.

Exempel

I följande exempel visas hur du använder den här egenskapen för att skala ett visuellt element så att det passar inom marginalerna på papperet som det ska skrivas ut på.

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

Kommentarer

Den här egenskapen motsvarar nyckelordet för utskriftsschematPageMediaSize.

Du kan testa de alternativ som skrivaren stöder med hjälp PageMediaSizeCapability av egenskapen .

Gäller för