PrintTicket.PageOrientation Proprietà

Definizione

Spazio dei nomi:

System.Printing

Assembly:

ReachFramework.dll

Ottiene o imposta un valore che indica l'orientamento del contenuto della pagina per la stampa.

public:
 property Nullable<System::Printing::PageOrientation> PageOrientation { Nullable<System::Printing::PageOrientation> get(); void set(Nullable<System::Printing::PageOrientation> value); };

public System.Printing.PageOrientation? PageOrientation { get; set; }

member this.PageOrientation : Nullable<System.Printing.PageOrientation> with get, set

Public Property PageOrientation As Nullable(Of PageOrientation)

Valore della proprietà

Nullable<PageOrientation>

Valore PageOrientation che specifica l'orientamento del contenuto della pagina, ad esempio Landscape o ReversePortrait.

Eccezioni

ArgumentOutOfRangeException

Il codice che effettua la chiamata ha tentato di impostare la proprietà su un valore non presente nell'enumerazione PageOrientation.

Esempio

Nell'esempio seguente viene illustrato come usare questa proprietà per configurare un processo di stampa.

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

Commenti

Un null valore per questa proprietà significa che questa impostazione di funzionalità non è specificata. Inoltre, quando il valore è null, le versioni XML di PrintTicket (vedere SaveTo e GetXmlStream) non contengono alcun markup per questa funzionalità.

Questa proprietà corrisponde alla parola chiave dello PageOrientationschema di stampa.

È possibile testare le opzioni supportate dalla stampante usando la PageOrientationCapability proprietà .