PagesPerSheetDirection Enumeration
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt die Anordnung der Seiten an, wenn mehrere Inhaltsseiten auf einer Seite des Druckmediums gedruckt werden.
public enum class PagesPerSheetDirection
public enum PagesPerSheetDirection
type PagesPerSheetDirection =
Public Enum PagesPerSheetDirection
- Vererbung
Felder
BottomLeft | 4 | Die Seiten werden in Spalten von oben nach unten und von rechts nach links relativ zur Seitenausrichtung gedruckt. |
BottomRight | 2 | Die Seiten werden in Spalten von oben nach unten und von links nach rechts relativ zur Seitenausrichtung gedruckt. |
LeftBottom | 3 | Die Seiten werden in Zeilen von rechts nach links und von oben nach unten relativ zur Seitenausrichtung gedruckt. |
LeftTop | 7 | Die Seiten werden in Zeilen von rechts nach links und von unten nach oben relativ zur Seitenausrichtung gedruckt. |
RightBottom | 1 | Die Seiten werden in Zeilen von links nach rechts und von oben nach unten relativ zur Seitenausrichtung gedruckt. |
RightTop | 5 | Die Seiten werden in Zeilen von links nach rechts und von unten nach oben relativ zur Seitenausrichtung gedruckt. |
TopLeft | 8 | Die Seiten werden in Spalten von oben nach unten und von rechts nach links relativ zur Seitenausrichtung gedruckt. |
TopRight | 6 | Die Seiten werden in Spalten von unten nach oben und von links nach rechts relativ zur Seitenausrichtung gedruckt. |
Unknown | 0 | Für die Funktion (deren Optionen durch diese Enumeration dargestellt werden) wurde eine Option festgelegt, die im Druckschemanicht definiert ist. |
Beispiele
Im folgenden Beispiel wird gezeigt, wie Sie die Funktionen eines Druckers testen und den Druckauftrag konfigurieren, um sie zu nutzen.
// ---------------------- GetPrintTicketFromPrinter -----------------------
/// <summary>
/// Returns a PrintTicket based on the current default printer.</summary>
/// <returns>
/// A PrintTicket for the current local default printer.</returns>
PrintTicket^ GetPrintTicketFromPrinter ()
{
PrintQueue^ printQueue = nullptr;
LocalPrintServer^ localPrintServer = gcnew LocalPrintServer();
// Retrieving collection of local printer on user machine
PrintQueueCollection^ localPrinterCollection = localPrintServer->GetPrintQueues();
System::Collections::IEnumerator^ localPrinterEnumerator = localPrinterCollection->GetEnumerator();
if (localPrinterEnumerator->MoveNext())
{
// Get PrintQueue from first available printer
printQueue = ((PrintQueue^)localPrinterEnumerator->Current);
} else
{
return nullptr;
}
// Get default PrintTicket from printer
PrintTicket^ printTicket = printQueue->DefaultPrintTicket;
PrintCapabilities^ printCapabilities = printQueue->GetPrintCapabilities();
// Modify PrintTicket
if (printCapabilities->CollationCapability->Contains(Collation::Collated))
{
printTicket->Collation = Collation::Collated;
}
if (printCapabilities->DuplexingCapability->Contains(Duplexing::TwoSidedLongEdge))
{
printTicket->Duplexing = Duplexing::TwoSidedLongEdge;
}
if (printCapabilities->StaplingCapability->Contains(Stapling::StapleDualLeft))
{
printTicket->Stapling = Stapling::StapleDualLeft;
}
return printTicket;
};// end:GetPrintTicketFromPrinter()
// ---------------------- GetPrintTicketFromPrinter -----------------------
/// <summary>
/// Returns a PrintTicket based on the current default printer.</summary>
/// <returns>
/// A PrintTicket for the current local default printer.</returns>
private PrintTicket GetPrintTicketFromPrinter()
{
PrintQueue printQueue = null;
LocalPrintServer localPrintServer = new LocalPrintServer();
// Retrieving collection of local printer on user machine
PrintQueueCollection localPrinterCollection =
localPrintServer.GetPrintQueues();
System.Collections.IEnumerator localPrinterEnumerator =
localPrinterCollection.GetEnumerator();
if (localPrinterEnumerator.MoveNext())
{
// Get PrintQueue from first available printer
printQueue = (PrintQueue)localPrinterEnumerator.Current;
}
else
{
// No printer exist, return null PrintTicket
return null;
}
// Get default PrintTicket from printer
PrintTicket printTicket = printQueue.DefaultPrintTicket;
PrintCapabilities printCapabilities = printQueue.GetPrintCapabilities();
// Modify PrintTicket
if (printCapabilities.CollationCapability.Contains(Collation.Collated))
{
printTicket.Collation = Collation.Collated;
}
if ( printCapabilities.DuplexingCapability.Contains(
Duplexing.TwoSidedLongEdge) )
{
printTicket.Duplexing = Duplexing.TwoSidedLongEdge;
}
if (printCapabilities.StaplingCapability.Contains(Stapling.StapleDualLeft))
{
printTicket.Stapling = Stapling.StapleDualLeft;
}
return printTicket;
}// end:GetPrintTicketFromPrinter()
' ---------------------- GetPrintTicketFromPrinter -----------------------
''' <summary>
''' Returns a PrintTicket based on the current default printer.</summary>
''' <returns>
''' A PrintTicket for the current local default printer.</returns>
Private Function GetPrintTicketFromPrinter() As PrintTicket
Dim printQueue As PrintQueue = Nothing
Dim localPrintServer As New LocalPrintServer()
' Retrieving collection of local printer on user machine
Dim localPrinterCollection As PrintQueueCollection = localPrintServer.GetPrintQueues()
Dim localPrinterEnumerator As System.Collections.IEnumerator = localPrinterCollection.GetEnumerator()
If localPrinterEnumerator.MoveNext() Then
' Get PrintQueue from first available printer
printQueue = CType(localPrinterEnumerator.Current, PrintQueue)
Else
' No printer exist, return null PrintTicket
Return Nothing
End If
' Get default PrintTicket from printer
Dim printTicket As PrintTicket = printQueue.DefaultPrintTicket
Dim printCapabilities As PrintCapabilities = printQueue.GetPrintCapabilities()
' Modify PrintTicket
If printCapabilities.CollationCapability.Contains(Collation.Collated) Then
printTicket.Collation = Collation.Collated
End If
If printCapabilities.DuplexingCapability.Contains(Duplexing.TwoSidedLongEdge) Then
printTicket.Duplexing = Duplexing.TwoSidedLongEdge
End If
If printCapabilities.StaplingCapability.Contains(Stapling.StapleDualLeft) Then
printTicket.Stapling = Stapling.StapleDualLeft
End If
Return printTicket
End Function ' end:GetPrintTicketFromPrinter()
Hinweise
Verwenden Sie die Werte dieses Typs hauptsächlich für diese Zwecke:
Als Mitglieder der PagesPerSheetDirectionCapability Auflistung, die eine Eigenschaft ist PrintCapabilities, geben diese Werte die Seitenanordnungen an, die der Drucker unterstützt.
Als Wert der PagesPerSheetDirection Eigenschaft eines PrintTicketObjekts leitet der Wert den Drucker an, um Seiten von Inhalten in einer angegebenen Richtung anzuordnen.
Der Unbekannte Wert wird nie in Eigenschaften von PrintCapabilities Objekten verwendet.
Sie sollten niemals eine PrintTicket Eigenschaft auf Unbekannt festlegen. Wenn einige andere PrintTicket produzierte Anwendung ein PrintTicket-Dokument erstellt hat, das das Feature "Seiten-pro-Blatt-Richtung" auf eine nicht erkannte Option festgelegt hat (das heißt, eine Option, die im Druckschema nicht definiert ist), wird ein PrintTicket Objekt in Ihrer Anwendung, das mit diesem Dokument erstellt wird, als Wert der PagesPerSheetDirection Eigenschaft unbekannt sein.
Obwohl die PrintTicket PrintCapabilities Klassen nicht geerbt werden können, können Sie das Druckschema erweitern, um Druckgerätefeatures zu erkennen, die nicht in den PrintTicket Klassen PrintCapabilities berücksichtigt werden. Weitere Informationen finden Sie in der Vorgehensweise: Erweitern des Druckschemas und Erstellen neuer Drucksystemklassen.