Collation Enum

Definisi

Ruang nama:

System.Printing

Rakitan:

ReachFramework.dll

Menentukan apakah printer menyusun output ketika mencetak beberapa salinan pekerjaan cetak multi-halaman.

public enum class Collation

public enum Collation

type Collation = 

Public Enum Collation

Warisan

Object

ValueType

Enum

Collation

Bidang

Collated	1	Output yang disusun.
Uncollated	2	Output tidak terbungkus.
Unknown	0	Fitur (yang opsinya diwakili oleh enumerasi ini) diatur ke opsi yang tidak ditentukan dalam Skema Cetak.

Contoh

Contoh berikut menunjukkan cara menguji kemampuan printer dan mengonfigurasi pekerjaan cetak untuk memanfaatkannya. .

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

Keterangan

Printer standar biasanya menyusun output dengan mencetak setiap halaman salinan pertama, lalu setiap halaman salinan kedua, dan sebagainya. Ketika printer standar tidak menyusun, printer mencetak setiap salinan halaman pertama, lalu setiap salinan halaman kedua, dan sebagainya.

Beberapa printer secara khusus dilengkapi dengan bin kolagen. Urutan pencetakan untuk printer yang dilengkapi khusus ini mungkin berbeda dari printer standar; namun hasilnya sama: setiap salinan pekerjaan cetak multi-halaman berisi semua halamannya dalam urutan yang tepat tanpa pengurutan manual.

Gunakan nilai jenis ini terutama untuk tujuan berikut.

• Sebagai anggota CollationCapability koleksi, yang merupakan properti dari PrintCapabilities, nilai-nilai ini menunjukkan jenis output yang didukung printer. (Banyak printer mendukung kedua jenis tersebut.)

• Sebagai nilai Collation properti dari , PrintTicketnilai menginstruksikan printer apakah akan menyusun.

Nilai Tidak Diketahui tidak pernah digunakan dalam properti PrintCapabilities objek.

Anda tidak boleh menyetel PrintTicket properti ke Tidak Diketahui. Jika beberapa aplikasi memproduksi lainnya PrintTicket telah membuat dokumen PrintTicket yang mengatur fitur kolase ke opsi kolase yang tidak dikenal, maka PrintTicket objek dalam aplikasi Anda yang dibangun dengan dokumen tersebut akan memiliki Tidak Diketahui sebagai nilai Collation properti.

PrintTicket Meskipun kelas dan PrintCapabilities tidak dapat diwariskan, Anda dapat memperluas Skema Cetak untuk mengenali fitur perangkat cetak yang tidak dipertangjawabkan di PrintTicket kelas atau PrintCapabilities . Untuk informasi selengkapnya lihat Cara: Memperluas Skema Cetak dan Membuat Kelas Sistem Cetak Baru.

Lihat juga

• PrintCapabilities
• PrintTicket