Stapling Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Especifica se, e quando, uma impressora grampeia um documento de várias páginas.
public enum class Stapling
public enum Stapling
type Stapling =
Public Enum Stapling
- Herança
Campos
None | 10 | O documento não é grampeado. |
SaddleStitch | 1 | Vários grampos ao longo da linha de dobra. Também chamado de associação de grampo a cavalo. |
StapleBottomLeft | 2 | Um único grampo no canto inferior esquerdo. |
StapleBottomRight | 3 | Um único grampo no canto inferior direito. |
StapleDualBottom | 7 | Dois grampos ao longo da borda inferior. |
StapleDualLeft | 4 | Dois grampos ao longo da borda esquerda. |
StapleDualRight | 5 | Dois grampos ao longo da borda direita. |
StapleDualTop | 6 | Dois grampos ao longo da borda superior. |
StapleTopLeft | 8 | Um único grampo no canto superior esquerdo. |
StapleTopRight | 9 | Um único grampo no canto superior direito. |
Unknown | 0 | O recurso (cujas opções são representadas por essa enumeração) é definido como uma opção não definida no Esquema de Impressão. |
Exemplos
O exemplo a seguir mostra como testar as funcionalidades de uma impressora e configurar o trabalho de impressão para tirar proveito 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()
Comentários
Use os valores desse tipo principalmente para estas finalidades:
Como membros da StaplingCapability coleção, que é uma propriedade de PrintCapabilities, esses valores indicam os tipos de stapling que uma impressora dá suporte.
Como o valor da Stapling propriedade de um PrintTicket, o valor instrui a impressora se e onde, para grampear.
O Unknown
valor nunca é usado em propriedades de PrintCapabilities objetos.
Você nunca deve definir uma PrintTicket propriedade como Unknown
. Se algum outro PrintTicket aplicativo produtor tiver criado um documento PrintTicket que define o recurso de stapling como uma opção não reconhecida (ou seja, uma opção que não está definida no Esquema de Impressão), um PrintTicket objeto em seu aplicativo que é construído com esse documento terá Unknown
como o valor da Stapling propriedade.
Embora as PrintTicket classes e não PrintCapabilities possam ser herdadas, você pode estender o Esquema de Impressão para reconhecer os recursos de dispositivo de impressão que não são contabilizados nas classes ou PrintCapabilities nas PrintTicket classes. Para obter mais informações , consulte Como estender o esquema de impressão e criar novas classes do sistema de impressão.