Stapling Enum

Definition

Namnområde:
System.Printing
Sammansättning:
ReachFramework.dll

Anger om och var en skrivare häftar ett dokument med flera sidor.

public enum class Stapling
public enum Stapling
type Stapling = 
Public Enum Stapling
Arv
Object
ValueType
Enum
Stapling

Fält

Name Värde Description
Unknown 0

Funktionen (vars alternativ representeras av den här uppräkningen) är inställd på ett alternativ som inte definierats i utskriftsschemat.
SaddleStitch 1

Flera häftklamrar längs viklinjen. Kallas även för häftning av sadelstygn.
StapleBottomLeft 2

En enda häftklammer i det nedre vänstra hörnet.
StapleBottomRight 3

En enda häftklammer i det nedre högra hörnet.
StapleDualLeft 4

Två häftklamrar längs vänster kant.
StapleDualRight 5

Två häftklamrar längs höger kant.
StapleDualTop 6

Två häftklamrar längs den övre kanten.
StapleDualBottom 7

Två häftklamrar längs den nedre kanten.
StapleTopLeft 8

En enda häftklammer i det övre vänstra hörnet.
StapleTopRight 9

En enda häftklammer i det övre högra hörnet.
None 10

Dokumentet är inte häftat.

Exempel

I följande exempel visas hur du testar en skrivares funktioner och konfigurerar utskriftsjobbet 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

Använd värdena för den här typen främst för följande ändamål:

  • Som medlemmar i StaplingCapability samlingen, som är en egenskap för PrintCapabilities, anger dessa värden vilka typer av häftning som en skrivare stöder.

  • Som värdet för Stapling egenskapen för en PrintTicketinstruerar värdet skrivaren om och var den ska häftas.

Värdet Unknown används aldrig i egenskaper PrintCapabilities för objekt.

Du bör aldrig ange en PrintTicket egenskap till Unknown. Om något annat PrintTicket producerande program har skapat ett PrintTicket-dokument som ställer in häftningsfunktionen på ett okänt alternativ (det vill s.v.s. ett alternativ som inte har definierats i utskriftsschemat), kommer ett PrintTicket objekt i ditt program som är konstruerat med dokumentet att ha Unknown som värde för Stapling egenskapen.

Ä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. Mer information finns i Så här utökar du utskriftsschemat och skapar nya systemklasser för utskrift.

Gäller för

Se även