PrintTicket Sınıf

Başvuru

Tanım

Ad Alanı:: System.Printing

Bütünleştirilmiş Kod:: ReachFramework.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Yazdırma işinin ayarlarını tanımlar.

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

Devralma: Object
PrintTicket

Uygulamalar: INotifyPropertyChanged

Örnekler

Aşağıdaki örnekte, belirli bir yazıcının özelliklerini belirleme ve yazdırma işini bunlardan yararlanacak şekilde yapılandırma adımları gösterilmektedir.

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

Açıklamalar

PrintTicket Nesne, PrintTicket belgesi olarak adlandırılan belirli bir XML belgesi türünün temsiliyle çalışması kolay bir belgedir. İkincisi, yazıcının çeşitli özelliklerini (çift yönlü, harmanlama ve zımbalama gibi) nasıl ayarlayacağını belirten bir yönerge kümesidir. Örneğin, yazıcıdan zımbalama ve zımbalama yazdırma işlerini sol üst köşede açmasını bildirmek için, belgede StapleTopLeft öğesini belirten bir <JobStapleAllDocuments … > öğe olacaktır. öğesi de nesnenin Stapling PrintTicket özelliğiyle temsil edilir. PrintTicket belgesi Yazdırma Şemasına uygun olmalıdır.

sınıfı, PrintTicket uygulamanızın XML Stream nesnelerini doğrudan yazmak zorunda kalmadan yazıcının özelliklerini yapılandırmasına olanak tanır.

Ev ve iş dosyası ve fotoğraf yazıcılarının en popüler özelliklerinin tümü sınıfın PrintTicket özellikleriyle temsil edilir. Ancak Yazdırma Şeması çok daha fazla, daha az yaygın ve özellik tanımlar ve özel yazdırma cihazlarının özelliklerini işlemek için genişletilebilir. Bu nedenle, ve PrintCapabilities sınıfları devralınamasa daPrintTicket, veya PrintCapabilities sınıflarında hesaba bağlanmayan yazdırma cihazı özelliklerini tanımak için Yazdırma Şemasını PrintTicket genişletebilirsiniz. Daha fazla bilgi için bkz. Nasıl yapılır: Yazdırma Şemasını Genişletme ve Yeni Yazdırma Sistemi Sınıflarını İçerik Oluşturucu.

NotPrintTicket Nesne, PrintTicket belgesi (olarak Stream) parametresini alan oluşturucuyla oluşturulduğunda, bu belgenin tamamı nesnedeki genel olmayan bir alanda depolanır ve içindeki XML öğeleri sınıfın genel özelliklerinden PrintTicket herhangi biriyle temsil edilmeyen daha az ortak özellikleri ifade eder. Aslında, PrintTicket belgesini oluşturan sürücü Yazdırma Şemasının özel bir uzantısını kullanıyorsa, özel olarak tanımlanan işaretleme de genel olmayan PrintTicket belgesinin bir parçası olarak depolanır.

Dikkat

Ad alanı içindeki System.Printing sınıflar bir Windows hizmeti veya ASP.NET uygulaması ya da hizmeti içinde kullanılmak üzere desteklenmez. Bu sınıfları bu uygulama türlerinden birinin içinden kullanmaya çalışmak, hizmet performansının azalması ve çalışma zamanı özel durumları gibi beklenmeyen sorunlara neden olabilir.

Windows Forms bir uygulamadan yazdırmak istiyorsanız ad alanına System.Drawing.Printing bakın.

Oluşturucular

PrintTicket()	PrintTicket sınıfının yeni bir örneğini başlatır.
PrintTicket(Stream)	XML Yazdırma Şeması ile uyumlu bir XML akışı (PrintTicket belgesi içeren) kullanarak sınıfının yeni bir örneğini PrintTicket başlatır.

Özellikler

Collation	Yazıcının çıkışını harmanlayıp harmanlamadığını belirten bir değer alır veya ayarlar.
CopyCount	Yazdırma işi için kopya sayısını alır veya ayarlar.
DeviceFontSubstitution	Yazıcının yazdırma işinde bilgisayar tabanlı yazı tipleri için cihaz tabanlı yazı tiplerini değiştirip değiştirmediğini belirten bir değer alır veya ayarlar.
Duplexing	Yazıcının yazdırma işi için kullandığı çift taraflı yazdırma türünü belirten bir değer alır veya ayarlar.
InputBin	Hangi giriş kutusunun (kağıt tepsisi) kullanılacağını belirten bir değer alır veya ayarlar.
OutputColor	Yazıcının gri renkli veya tonlu içeriği nasıl işlediğini gösteren bir değer alır veya ayarlar.
OutputQuality	Yazdırma işi için çıkışın kalitesini belirten bir değer alır veya ayarlar.
PageBorderless	Cihazın medyanın kenarına içerik yazdırdığını veya kenar çevresinde yazdırılmamış bir kenar boşluğu bırakıp bırakmadığını belirten bir değer alır veya ayarlar.
PageMediaSize	Yazıcının yazdırma işi için kullandığı kağıdın (veya başka bir medyanın) sayfa boyutunu alır veya ayarlar.
PageMediaType	Yazıcının yazdırma işi için ne tür kağıt veya medya kullandığını belirten bir değer alır veya ayarlar.
PageOrder	Yazıcının birden çok sayfayı önden öne mi yoksa önden arkaya mı yazdırdığını gösteren bir değer alır veya ayarlar.
PageOrientation	Sayfa içeriğinin yazdırma için nasıl yönlendirildiğini gösteren bir değer alır veya ayarlar.
PageResolution	Yazıcının bir yazdırma işi için kullandığı sayfa çözünürlüğü düzeyini alır veya ayarlar.
PageScalingFactor	Yazıcının sayfadaki yazdırma görüntüsünü büyütme veya azaltma yüzdesini alır veya ayarlar.
PagesPerSheet	Kağıdın her yazdırılan tarafına yazdırılan sayfa sayısını alır veya ayarlar.
PagesPerSheetDirection	Yazıcının kağıdın her iki tarafına yazdıran birden çok sayfayı nasıl düzenlediğini gösteren bir değer alır veya ayarlar.
PhotoPrintingIntent	Yazıcının fotoğraf yazdırmak için kullandığı kalite düzeyini nitel terimle belirten bir değer alır veya ayarlar.
Stapling	Yazıcının birden çok sayfayı zımbalayıp zımbalayıp zımbalamadığını ve nereye zımbalayıp zımbalamadığını belirten bir değer alır veya ayarlar.
TrueTypeFontMode	Yazıcının TrueType yazı tiplerini kullanan metni nasıl işlediğini belirten bir değer alır veya ayarlar.

Yöntemler

Clone()	Bu PrintTicketnesnenin değerlerinin derin kopyalarını oluşturarak bu öğesinin değiştirilebilir bir kopyasını oluşturur.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
GetXmlStream()	MemoryStream Bir öğesinin özellik değerlerini, Yazdırma Şemasına PrintTicket uygun bir XML akışı olarak temsil eden bir nesnesi döndürür.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
SaveTo(Stream)	Yazdırma Şemasına PrintTicket uygun bir XML biçimi kullanarak ayarları bir Stream nesneye kaydeder.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ekinlikler

PropertyChanged

Değişikliklerin herhangi bir özelliği PrintTicket olduğunda gerçekleşir.

Şunlara uygulanır