PrintCapabilities Klass

Definition

public ref class PrintCapabilities sealed

public sealed class PrintCapabilities

type PrintCapabilities = class

Public NotInheritable Class PrintCapabilities

Arv

Object

PrintCapabilities

Exempel

I följande exempel visas hur du fastställer funktionerna för en viss skrivare och hur du konfigurerar ett utskriftsjobb för att dra nytta av dem.

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

Kommentarer

Ett PrintCapabilities objekt är en lätt att arbeta med representation av en viss typ av XML-dokument som kallas för ett PrintCapabilities-dokument. Det senare är en ögonblicksbild av alla en skrivares funktioner och deras aktuella inställningar. Om skrivaren till exempel stöder färgutskrift skulle dokumentet ha ett <PageOutputColor … > element som anger hur färgutdata ska hanteras. Elementet representeras i sin tur av OutputColorCapability objektets PrintCapabilities egenskap. Om skrivaren inte stöder färg finns det inget <PageOutputColor … > element i dokumentet och värdet för OutputColorCapability egenskapen är null. Dokumentet PrintCapabilities måste överensstämma med utskriftsschemat.

Klassen PrintCapabilities gör det möjligt för ditt program att hämta en skrivares funktioner utan att behöva ägna sig åt direkt läsning av XML-objekt Stream .

Alla de mest populära funktionerna i fil- och fotoskrivare, för både hem och företag, kapslas in av PrintCapabilities klassen. Men utskriftsschemat definierar många fler, mindre vanliga funktioner och kan utökas för att hantera funktioner i specialutskriftsenheter. Även om klasserna PrintTicket och PrintCapabilities inte kan ärvas kan du utöka utskriftsschemat så att utskriftsenhetens funktioner som inte redovisas i klasserna PrintTicket eller PrintCapabilities identifieras.

ObserveraPrintCapabilities När objektet skapas med konstruktorn som tar ett PrintCapabilities-dokument (som en Stream) parameter lagras hela dokumentet i ett icke-offentligt fält i objektet, inklusive XML-elementen i det som uttrycker mindre vanliga funktioner som inte representeras av någon av klassens offentliga egenskaper PrintCapabilities . Om drivrutinen som skapade PrintCapabilities-dokumentet använder en privat förlängning av utskriftsschemat lagras även den privatdefinierade markeringen som en del av dokumentet printcapabilities som inte är offentliga.

Om du vill skriva ut från ett Windows Forms program läser du namnområdet System.Drawing.Printing.