PrintTicket.PageOrientation 属性

定义

获取或设置一个值,该值表示打印时如何定向页面内容。Gets or sets a value indicating how the page content is oriented for printing.

public:
 property Nullable<System::Printing::PageOrientation> PageOrientation { Nullable<System::Printing::PageOrientation> get(); void set(Nullable<System::Printing::PageOrientation> value); };
public Nullable<System.Printing.PageOrientation> PageOrientation { get; set; }
member this.PageOrientation : Nullable<System.Printing.PageOrientation> with get, set
Public Property PageOrientation As Nullable(Of PageOrientation)

属性值

用于指定如何定向页面内容的 PageOrientation 值,如 LandscapeReversePortraitA PageOrientation value specifying how page content is oriented, for example, Landscape or ReversePortrait.

异常

调用代码操作尝试将属性设置为不在 PageOrientation 枚举范围内的值。Calling code has attempted to set the property to a value that is not in the PageOrientation enumeration.

示例

下面的示例演示如何使用此属性来配置打印作业。The following example shows how to use this property to configure a print job.

// Use different PrintTickets for different FixedDocuments.
PrintTicket ptFD = new PrintTicket();

if (_firstDocumentPrintTicket <= 1)
{   // Print the first document in black/white and in portrait
    // orientation.  Since the PrintTicket at the
    // FixedDocumentSequence level already specifies portrait
    // orientation, this FixedDocument can just inherit that
    // setting without having to set it again.
    ptFD.PageOrientation = PageOrientation.Portrait;
    ptFD.OutputColor = OutputColor.Monochrome;
    _firstDocumentPrintTicket++;
}

else // if (_firstDocumentPrintTicket > 1)
{   // Print the second document in color and in landscape
    // orientation.  Since the PrintTicket at the
    // FixedDocumentSequence level already specifies portrait
    // orientation, this FixedDocument needs to set its
    // PrintTicket with landscape orientation in order to
    // override the higher level setting.
    ptFD.PageOrientation = PageOrientation.Landscape;
    ptFD.OutputColor = OutputColor.Color;
}
' Use different PrintTickets for different FixedDocuments.
Dim ptFD As New PrintTicket()

If _firstDocumentPrintTicket <= 1 Then
    ' orientation.  Since the PrintTicket at the
    ' FixedDocumentSequence level already specifies portrait
    ' orientation, this FixedDocument can just inherit that
    ' setting without having to set it again.
    ptFD.PageOrientation = PageOrientation.Portrait
    ptFD.OutputColor = OutputColor.Monochrome
    _firstDocumentPrintTicket += 1

Else ' if (_firstDocumentPrintTicket > 1)
    ' orientation.  Since the PrintTicket at the
    ' FixedDocumentSequence level already specifies portrait
    ' orientation, this FixedDocument needs to set its
    ' PrintTicket with landscape orientation in order to
    ' override the higher level setting.
    ptFD.PageOrientation = PageOrientation.Landscape
    ptFD.OutputColor = OutputColor.Color
End If

注解

null属性的值表示未指定此功能设置。A null value for this property means that this feature setting is not specified. 此外, null当该值为时,的 XML 版本PrintTicket (请参见SaveToGetXmlStream)将不包含此功能的任何标记。Also, when the value is null, the XML versions of the PrintTicket (see SaveTo and GetXmlStream) will not contain any markup for this feature.

此属性对应于打印架构PageOrientation关键字。This property corresponds to the Print Schema's PageOrientation keyword.

您可以使用PageOrientationCapability属性测试打印机支持的选项。You can test for the options that the printer supports by using the PageOrientationCapability property.

适用于