Duplexing Enumeração

Definição

Espaço de Nomes:
System.Printing
Assemblagem:
ReachFramework.dll

Especifica se uma impressora utiliza impressão de um só lado ou algum tipo de impressão de dois lados (duplex).

public enum class Duplexing
public enum Duplexing
type Duplexing = 
Public Enum Duplexing
Herança
Object
ValueType
Enum
Duplexing

Campos

Name Valor Description
Unknown 0

A característica (cujas opções são representadas por esta enumeração) é definida para uma opção não definida no Esquema de Impressão.
OneSided 1

A saída imprime apenas num lado de cada folha.
TwoSidedShortEdge 2

A saída imprime em ambos os lados de cada folha, que vira ao longo da aresta paralela a MediaSizeWidth.
TwoSidedLongEdge 3

A saída imprime em ambos os lados de cada folha, que vira ao longo da aresta paralela à MediaSizeHeight.

Exemplos

O exemplo seguinte mostra como testar as capacidades de uma impressora e configurar o trabalho de impressão para tirar partido delas. .

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

Observações

Use os valores deste tipo principalmente para estes fins:

  • Como membros da DuplexingCapability coleção, que é uma propriedade de PrintCapabilities, estes valores indicam os tipos de impressão unilateral e bilateral que a impressora suporta.

  • Como o valor da Duplexing propriedade de um PrintTicket, orientam o impressor a usar impressão unilateral ou algum tipo de impressão bilateral.

O valor Desconhecido nunca é usado nas propriedades dos PrintCapabilities objetos.

Nunca deve definir uma PrintTicket propriedade como Desconhecida. Se alguma outra PrintTicket aplicação produtora criou um documento PrintTicket que define a funcionalidade de duplicação para uma opção de duplicação não reconhecida (ou seja, uma opção não definida no Esquema de Impressão), então um PrintTicket objeto na sua aplicação construído com esse documento terá Unknown como valor da Duplexing propriedade.

Embora as PrintTicket classes and PrintCapabilities não possam ser herdadas, pode estender o Esquema de Impressão para reconhecer funcionalidades de dispositivos de impressão que não estão contabilizadas nas PrintTicket classes ou.PrintCapabilities Para mais informações, veja Como: Estender o Esquema de Impressão e Criar Novas Classes do Sistema de Impressão.

Aplica-se a

Ver também