PageMediaType Énumération

Définition

Espace de noms:

System.Printing

Assembly:

ReachFramework.dll

Spécifie des types de papier d'impression de papier ou autre média.

public enum class PageMediaType

public enum PageMediaType

type PageMediaType = 

Public Enum PageMediaType

Héritage

Object

ValueType

Enum

PageMediaType

Champs

Archival	2	Média qualité archive.
AutoSelect	1	Le périphérique d'impression sélectionne le média.
BackPrintFilm	3	Papier couché.
Bond	4	Papier à lettres bond standard.
CardStock	5	Papier cartonné standard.
Continuous	6	Papier continu.
EnvelopePlain	7	Enveloppe standard.
EnvelopeWindow	8	Enveloppe fenêtre.
Fabric	9	Textile.
HighResolution	10	Papier haute résolution.
Label	11	Étiquettes.
MultiLayerForm	12	Formulaires attachés à parties multiples.
MultiPartForm	13	Formulaires individuels à parties multiples.
None	29	Média inconnu ou non répertorié.
Photographic	14	Papier photo qualité standard.
PhotographicFilm	15	Papier photo qualité film.
PhotographicGlossy	16	Papier photo glossy.
PhotographicHighGloss	17	Papier photo hi-gloss.
PhotographicMatte	18	Papier photo mat.
PhotographicSatin	19	Papier photo brillant.
PhotographicSemiGloss	20	Papier photo semi-gloss.
Plain	21	Papier ordinaire.
Screen	22	Sortie affichage continu.
ScreenPaged	23	Sortie affichage paginé.
Stationery	24	Papier spécial.
TabStockFull	25	Fiches, non découpées.
TabStockPreCut	26	Fiches, pré-découpées.
Transparency	27	Transparent.
TShirtTransfer	28	Papier transfert T-shirt.
Unknown	0	La fonctionnalité (dont les options sont représentées par cette énumération) est définie avec une option non définie dans le Schéma d’impression.

Exemples

L’exemple suivant montre comment déterminer les fonctionnalités de l’imprimante et configurer le travail d’impression pour en tirer parti.

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

Remarques

Les valeurs de ce type sont principalement utilisées à ces fins :

• En tant que membres de la PageMediaTypeCapability collection, une propriété de PrintCapabilities, ils indiquent les types de supports pris en charge par l’imprimante.

• En tant que valeur de la PageMediaType propriété d’un PrintTicket, ils indiquent à l’imprimante d’utiliser un type spécifique de média.

La valeur Unknownvalue n’est jamais utilisée dans les propriétés des PrintCapabilities objets.

Vous ne devez jamais définir une PrintTicket propriété sur Inconnu. Si une autre PrintTicket application productrice a créé un document PrintTicket qui définit la fonctionnalité de type multimédia de page sur une option non reconnue (c’est-à-dire une option qui n’est pas définie dans le schéma d’impression), un PrintTicket objet de votre application construit avec ce document aura la valeur Unknown comme valeur de la PageMediaType propriété.

Bien que les PrintTicket classes et PrintCapabilities ne puissent pas être héritées, vous pouvez étendre le schéma d’impression pour reconnaître les fonctionnalités d’appareil d’impression qui ne sont pas prises en compte dans les PageMediaType classes ou PrintCapabilities . Pour plus d’informations, consultez Guide pratique pour étendre le schéma d’impression et créer des classes système d’impression.

Voir aussi

• PrintCapabilities
• PrintTicket