PrintTicket Třída

Reference

Definice

Obor názvů:: System.Printing

Sestavení:: ReachFramework.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Definuje nastavení tiskové úlohy.

public ref class PrintTicket sealed : System::ComponentModel::INotifyPropertyChanged

public sealed class PrintTicket : System.ComponentModel.INotifyPropertyChanged

type PrintTicket = class
    interface INotifyPropertyChanged

Public NotInheritable Class PrintTicket
Implements INotifyPropertyChanged

Dědičnost: Object
PrintTicket

Implementuje: INotifyPropertyChanged

Příklady

Následující příklad ukazuje, jak určit možnosti konkrétní tiskárny a jak nakonfigurovat tiskovou úlohu tak, aby je využívala.

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

Poznámky

Objekt PrintTicket je snadno ovladatelný objekt s reprezentací určitého typu dokumentu XML, který se nazývá dokument PrintTicket. Druhá část je sada pokynů, které tiskárně říkají, jak nastavit její různé funkce (jako je duplexní, kolace a sešívání). Chcete-li například dát tiskárně pokyn, aby zapnula sešívač a sešíval tiskové úlohy v levém horním rohu, měl by <JobStapleAllDocuments … > dokument prvek, který určuje StapleTopLeft. Prvek je zase reprezentován Stapling vlastností objektu PrintTicket . Dokument PrintTicket musí odpovídat schématu tisku.

Třída PrintTicket umožňuje vaší aplikaci konfigurovat funkce tiskárny bez nutnosti přímého zápisu objektů XML Stream .

Všechny nejoblíbenější funkce domácí a firemní tiskárny souborů a fotek jsou reprezentovány vlastnostmi PrintTicket třídy. Schéma tisku ale definuje mnoho dalších méně běžných funkcí a lze ho rozšířit tak, aby zvládlo funkce speciálních tiskových zařízení. I když PrintTicket tedy třídy a PrintCapabilities nelze dědit, můžete rozšířit schéma tisku tak, aby rozpoznalo funkce tiskového zařízení, které nejsou zahrnuté ve PrintTicket třídách nebo PrintCapabilities . Další informace najdete v tématech Postupy: Rozšíření schématu tisku a Vytvoření nových tiskových systémových tříd.

Poznámka Při vytvoření objektu PrintTicket pomocí konstruktoru, který přebírá printTicket dokument (jako Streamparametr ) celý dokument je uložen v neveřejné pole v objektu, včetně elementů XML v něm, které vyjadřují méně běžné funkce, které nejsou reprezentovány žádnou z veřejných vlastností PrintTicket třídy. Pokud ovladač, který vytvořil dokument PrintTicket, používá privátní rozšíření schématu tisku, je tato soukromě definovaná značka také uložena jako součást neveřejného dokumentu PrintTicket.

Upozornění

Třídy v rámci System.Printing oboru názvů nejsou podporovány pro použití v rámci služby windows nebo ASP.NET aplikace nebo služby. Při pokusu o použití těchto tříd z jednoho z těchto typů aplikací může dojít k neočekávaným problémům, jako je snížení výkonu služby a výjimky za běhu.

Pokud chcete tisknout z aplikace Windows Forms, podívejte se na System.Drawing.Printing obor názvů.

Konstruktory

PrintTicket()	Inicializuje novou instanci PrintTicket třídy.
PrintTicket(Stream)	Inicializuje novou instanci PrintTicket třídy pomocí datového proudu XML (který obsahuje dokument PrintTicket), který je v souladu se schématem tisku XML.

Vlastnosti

Collation	Získá nebo nastaví hodnotu určující, zda tiskárna kompletuje výstup.
CopyCount	Získá nebo nastaví počet kopií pro tiskovou úlohu.
DeviceFontSubstitution	Získá nebo nastaví hodnotu určující, zda tiskárna nahrazuje písma zařízení pro počítačové písma v tiskové úloze.
Duplexing	Získá nebo nastaví hodnotu označující, jaký druh oboustranného tisku tiskárna používá pro tiskovou úlohu.
InputBin	Získá nebo nastaví hodnotu určující, jakou vstupní přihrádku (zásobník papíru) použít.
OutputColor	Získá nebo nastaví hodnotu označující, jak tiskárna zpracovává obsah, který má barvu nebo odstíny šedé.
OutputQuality	Získá nebo nastaví hodnotu označující kvalitu výstupu tiskové úlohy.
PageBorderless	Získá nebo nastaví hodnotu označující, zda zařízení tiskne obsah na okraj média nebo ponechá netisknutou okraj kolem okraje.
PageMediaSize	Získá nebo nastaví velikost stránky pro papír (nebo jiné médium), které tiskárna používá pro tiskovou úlohu.
PageMediaType	Získá nebo nastaví hodnotu označující, jaký druh papíru nebo média tiskárna používá pro tiskovou úlohu.
PageOrder	Získá nebo nastaví hodnotu označující, zda tiskárna tiskne více stránek zepředu nebo zepředu dozadu.
PageOrientation	Získá nebo nastaví hodnotu označující, jak je obsah stránky orientovaný pro tisk.
PageResolution	Získá nebo nastaví úroveň rozlišení stránky, kterou tiskárna používá pro tiskovou úlohu.
PageScalingFactor	Získá nebo nastaví procento, o které tiskárna zvětší nebo zmenší tiskový obrázek na stránce.
PagesPerSheet	Získá nebo nastaví počet stránek, které se vytisknou na každé vytištěné straně listu papíru.
PagesPerSheetDirection	Získá nebo nastaví hodnotu označující, jak tiskárna uspořádá více stránek, které se vytisknou na každé straně listu papíru.
PhotoPrintingIntent	Získá nebo nastaví hodnotu označující v kvalitativních termínech úroveň kvality, kterou tiskárna používá k tisku fotografie.
Stapling	Získá nebo nastaví hodnotu označující, zda a kde tiskárna sešívkuje více stránek.
TrueTypeFontMode	Získá nebo nastaví hodnotu označující, jak tiskárna zpracovává text, který používá písma TrueType.

Metody

Clone()	Vytvoří upravitelný klon tohoto PrintTicketobjektu a vytváří hluboké kopie hodnot tohoto objektu.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
GetXmlStream()	MemoryStream Vrátí objekt, který představuje hodnoty vlastností objektu PrintTicket jako datový proud XML, který odpovídá schématu tisku.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
SaveTo(Stream)	Uloží PrintTicket nastavení do objektu Stream pomocí formátu XML, který odpovídá schématu tisku.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Událost

PropertyChanged

Nastane, když se PrintTicket změní jakákoli vlastnost.

Platí pro

Sdílet prostřednictvím