DeviceFontSubstitution Enumeration

Referenz

Definition

Namespace:: System.Printing

Assembly:: ReachFramework.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt an, ob die Geräteschriftartersetzung für einen Drucker aktiviert ist.

public enum class DeviceFontSubstitution

public enum DeviceFontSubstitution

type DeviceFontSubstitution =

Public Enum DeviceFontSubstitution

Vererbung: Object

ValueType

Enum
DeviceFontSubstitution

Felder

Off	1	Die Geräteschriftartersetzung ist deaktiviert.
On	2	Die Geräteschriftartersetzung ist aktiviert.
Unknown	0	Für die Funktion (deren Optionen durch diese Enumeration dargestellt werden) wurde eine Option festgelegt, die im Druckschemanicht definiert ist.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie Druckerfunktionen bestimmen und den Druckauftrag so konfigurieren, dass sie sie nutzen können.

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

Hinweise

Der Druck ist schneller, wenn nur der Text, nicht die Schriftart, an den Drucker gesendet wird. Einige Drucker verfügen über Schriftarten, die dauerhaft im Arbeitsspeicher gespeichert sind. Diese Drucker ermöglichen Benutzern das Ersetzen einer ansässigen Druckerschriftart für jede Schriftart, die von der Druckanwendung verwendet wird.

Die Werte dieses Typs werden hauptsächlich für diese Zwecke verwendet:

Als Mitglieder der DeviceFontSubstitutionCapability Auflistung PrintCapabilitiesstellen sie die Druckerfunktionen dar.
Als Wert der DeviceFontSubstitution Eigenschaft eines PrintTicketDruckers weisen sie den Drucker an, die Geräteschriftartsetzung für den Druckauftrag zu aktivieren oder zu deaktivieren.

Der Unbekannte Wert wird nie in Eigenschaften von PrintCapabilities Objekten verwendet.

Sie sollten niemals eine PrintTicket Eigenschaft auf Unbekannt festlegen. Wenn einige andere PrintTicket produzierte Anwendung ein PrintTicket-Dokument erstellt hat, das das Geräteschriftsetzungsfeature auf eine nicht erkannte Option festlegt (das heißt, eine Option, die im Druckschema nicht definiert ist), dann hat ein PrintTicket Objekt in Ihrer Anwendung, das mit diesem Dokument erstellt wird, unbekannt als Wert der DeviceFontSubstitution Eigenschaft.

Obwohl die PrintTicket PrintCapabilities Klassen nicht geerbt werden können, können Sie das Druckschema erweitern, um Druckgerätefeatures zu erkennen, die nicht in den PrintTicket Klassen PrintCapabilities berücksichtigt werden. Weitere Informationen finden Sie unter How to: Erweitern des Druckschemas und Erstellen neuer Drucksystemklassen.

Gilt für