PrintQueueCollection Klasa

Definicja

Przestrzeń nazw:

System.Printing

Zestaw:

System.Printing.dll

Reprezentuje kolekcję obiektów PrintQueue.

public ref class PrintQueueCollection : System::Printing::PrintSystemObjects, IDisposable, System::Collections::Generic::IEnumerable<System::Printing::PrintQueue ^>

public class PrintQueueCollection : System.Printing.PrintSystemObjects, IDisposable, System.Collections.Generic.IEnumerable<System.Printing.PrintQueue>

type PrintQueueCollection = class
    inherit PrintSystemObjects
    interface seq<PrintQueue>
    interface IEnumerable
    interface IDisposable

Public Class PrintQueueCollection
Inherits PrintSystemObjects
Implements IDisposable, IEnumerable(Of PrintQueue)

Dziedziczenie

Object

PrintSystemObjects

PrintQueueCollection

Implementuje

IEnumerable<PrintQueue> IEnumerable IDisposable

Przykłady

W poniższym przykładzie pokazano, jak używać tej kolekcji do testowania możliwości drukarki i konfigurowania zadania drukowania w celu ich wykorzystania.

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

Uwagi

Ostrożność

Klasy w przestrzeni nazw System.Printing nie są obsługiwane do użycia w usłudze systemu Windows lub ASP.NET aplikacji lub usługi. Próba użycia tych klas z jednego z tych typów aplikacji może powodować nieoczekiwane problemy, takie jak zmniejszona wydajność usługi i wyjątki czasu wykonywania.

Jeśli chcesz wydrukować z aplikacji Windows Forms, zobacz System.Drawing.Printing przestrzeni nazw.

Konstruktory

PrintQueueCollection()	Inicjuje nowe wystąpienie klasy PrintQueueCollection.
PrintQueueCollection(PrintServer, String[])	Inicjuje nowe wystąpienie klasy PrintQueueCollection dla określonego PrintServer.
PrintQueueCollection(PrintServer, String[], EnumeratedPrintQueueTypes[])	Inicjuje nowe wystąpienie klasy PrintQueueCollection dla określonego PrintServer, zawierające tylko kolejki serwera wydruku określonego EnumeratedPrintQueueTypes.

Właściwości

SyncRoot

Pobiera obiekt, który może służyć do synchronizowania dostępu do PrintQueueCollection.

Metody

Add(PrintQueue)	Dodaje PrintQueue do kolekcji.
Dispose()	Zwalnia wszystkie zasoby używane przez PrintSystemObjects. (Odziedziczone po PrintSystemObjects)
Dispose(Boolean)	Zwalnia niezarządzane zasoby używane przez PrintQueueCollectioni opcjonalnie zwalnia używane zasoby zarządzane.
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetEnumerator()	Zwraca obiekt, który implementuje ogólny interfejs IEnumerator, który został zamknięty za pomocą PrintQueue.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetNonGenericEnumerator()	Pobiera obiekt, który implementuje niegeneryczny interfejs IEnumerator.
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

IEnumerable.GetEnumerator()

Zwraca obiekt, który implementuje ogólny interfejs IEnumerator, który został zamknięty za pomocą PrintQueue.

Metody rozszerzania