DeviceFontSubstitution Wyliczenie

Definicja

Przestrzeń nazw:

System.Printing

Zestaw:

ReachFramework.dll

Określa, czy podstawianie czcionek urządzenia jest włączone na drukarce.

public enum class DeviceFontSubstitution

public enum DeviceFontSubstitution

type DeviceFontSubstitution = 

Public Enum DeviceFontSubstitution

Dziedziczenie

Object

ValueType

Enum

DeviceFontSubstitution

Pola

Off	1	Podstawianie czcionek urządzenia jest wyłączone.
On	2	Podstawianie czcionek urządzenia jest włączone.
Unknown	0	Funkcja (której opcje są reprezentowane przez to wyliczenie) jest ustawiona na opcję niezdefiniową w schemacie wydruku.

Przykłady

W poniższym przykładzie pokazano, jak określić możliwości drukarki i skonfigurować zadanie drukowania w celu korzystania z nich.

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

Uwagi

Drukowanie jest szybsze, gdy do drukarki jest wysyłany tylko tekst, a nie czcionka. Niektóre drukarki mają czcionki, które są trwale przechowywane w pamięci. Drukarki te umożliwiają użytkownikom zastępowanie czcionki drukarki rezydentnej dla każdej czcionki używanej przez aplikację drukowania.

Wartości tego typu są używane głównie do następujących celów:

• Jako członkowie DeviceFontSubstitutionCapability kolekcji właściwość PrintCapabilities, reprezentują możliwości drukarki.

• Jako wartość DeviceFontSubstitution właściwości PrintTicket, instruują drukarkę, aby włączyć lub wyłączyć podstawianie czcionek urządzenia dla zadania drukowania.

Nieznana wartość nigdy nie jest używana we właściwościach PrintCapabilities obiektów.

Nigdy nie należy ustawiać PrintTicket właściwości na Nieznany. Jeśli inna PrintTicket aplikacja produkująca utworzyła dokument PrintTicket, który ustawia funkcję podstawiania czcionek urządzenia na nierozpoznaną opcję (czyli opcję, która nie jest zdefiniowana w schemacie drukowania), to PrintTicket obiekt w aplikacji, który jest skonstruowany z tym dokumentem, będzie miał wartość Nieznany jako wartość DeviceFontSubstitution właściwości.

PrintTicket Mimo że klasy i PrintCapabilities nie mogą być dziedziczone, można rozszerzyć schemat wydruku w celu rozpoznawania funkcji urządzenia wydruku, które nie są uwzględniane w PrintTicket klasach lubPrintCapabilities. Aby uzyskać więcej informacji, zobacz How to: Extend the Print Schema and Create New Print System Classes (Instrukcje: rozszerzanie schematu wydruku) i Create New Print System Classes (Tworzenie nowych klas systemu wydruku).

Zobacz też

• PrintCapabilities
• PrintTicket