PrintCapabilities.CollationCapability 屬性

定義

命名空間:

System.Printing

組件:

ReachFramework.dll

取得或設定值集合，指出印表機是否能將輸出自動分頁。

C#

public System.Collections.ObjectModel.ReadOnlyCollection<System.Printing.Collation> CollationCapability { get; }

屬性值

ReadOnlyCollection<Collation>

ReadOnlyCollection<T> 值的 Collation。

範例

下列範例示範如何使用這個屬性來判斷特定印表機的功能，以及如何設定列印作業以利用它們。

C#

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

備註

標準印表機通常會列印第一個複本的每一頁、第二個複本的每個頁面等等來定序輸出。 當標準印表機沒有定序時，它會列印第一頁的每個複本，然後列印第二頁的每個複本等等。

有些印表機特別配備定序間隔。這些特別配備印表機的列印順序可能與標準印表機的列印順序不同;不過結果相同：多頁列印作業的每個複本都會以適當的順序包含其所有頁面，而不需手動排序。

如果印表機不支援定序，則集合是空的。

這個屬性會對應至 列印架構的 DocumentCollate 關鍵詞，而不是 JobCollateAllDocuments 關鍵詞。

適用於