PrintTicket.PageMediaSize 속성

정의

네임스페이스:

System.Printing

어셈블리:

ReachFramework.dll

인쇄 작업에 사용하는 용지(또는 다른 미디어)의 크기를 가져오거나 설정합니다.

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

속성 값

PageMediaSize

이름, 크기 또는 둘 모두를 사용하여 용지 크기를 나타내는 PageMediaSize 개체입니다.

예외

ArgumentOutOfRangeException

호출 코드가 이 속성을 최소한 하나의 null 속성이 있는 PageMediaSize 개체를 사용하여 설정하려고 한 경우

또는

호출 코드가 이 속성을 PageMediaSize 속성이 PageMediaSizeName 열거형에 없는 값으로 설정된 PageMediaSizeName 개체를 사용하여 설정하려고 한 경우

또는

호출 코드가 이 속성을 PageMediaSize 또는 Width 속성이 1보다 작은 값으로 설정된 Height 개체를 사용하여 설정하려고 한 경우

예제

다음 예제에서는이 속성을 사용 하 여 인쇄 되는 페이지의 여백 내에 맞게 시각적 요소를 확장 하는 방법을 보여 줍니다.

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

설명

이 속성에 해당 합니다 Print Schema의 PageMediaSize 키워드입니다.

프린터를 사용 하 여 지 원하는 옵션에 대 한 테스트 수를 PageMediaSizeCapability 속성입니다.