PageMediaType Enumeração

Referência

Definição

Namespace:: System.Printing

Assembly:: ReachFramework.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Especifica os tipos de papel de impressão ou outras mídias.

public enum class PageMediaType

public enum PageMediaType

type PageMediaType =

Public Enum PageMediaType

Herança: Object

ValueType

Enum
PageMediaType

Campos

Archival	2	Mídia de qualidade de arquivo.
AutoSelect	1	O dispositivo de impressão seleciona a mídia.
BackPrintFilm	3	Filme de impressão no verso especial.
Bond	4	Mídia bond padrão.
CardStock	5	Papel cartão padrão.
Continuous	6	Mídia de alimentação contínua.
EnvelopePlain	7	Envelope padrão.
EnvelopeWindow	8	Envelope com janela.
Fabric	9	Mídia de tecido.
HighResolution	10	Mídia de alta resolução especial.
Label	11	Mídia de rótulo.
MultiLayerForm	12	Formulários de várias partes anexadas.
MultiPartForm	13	Formulários de várias partes individuais.
None	29	Mídia desconhecida ou não listada.
Photographic	14	Mídia fotográfica padrão.
PhotographicFilm	15	Mídia fotográfica de filme.
PhotographicGlossy	16	Mídia fotográfica brilhante.
PhotographicHighGloss	17	Mídia fotográfica de alto brilho.
PhotographicMatte	18	Mídia fotográfica fosca.
PhotographicSatin	19	Mídia fotográfica acetinada.
PhotographicSemiGloss	20	Mídia fotográfica semibrilhante.
Plain	21	Papel comum.
Screen	22	Saída para uma exibição em formulário contínuo.
ScreenPaged	23	Saída para uma exibição em formulário paginado.
Stationery	24	Especialidade estática.
TabStockFull	25	Lingueta, sem índice (guias únicas).
TabStockPreCut	26	Lingueta, com índice (várias guias).
Transparency	27	Folha transparente.
TShirtTransfer	28	Mídia que é usada para transferir uma imagem para uma camiseta.
Unknown	0	O recurso (cujas opções são representadas por essa enumeração) é definido como uma opção não definida no Esquema de Impressão.

Exemplos

O exemplo a seguir mostra como determinar as funcionalidades da impressora e configurar o trabalho de impressão para tirar proveito delas.

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

Comentários

Os valores desse tipo são usados principalmente para estas finalidades:

Como membros da PageMediaTypeCapability coleção, uma propriedade de PrintCapabilities, eles indicam os tipos de mídia compatíveis com a impressora.
Como o valor da PageMediaType propriedade de um PrintTicket, eles instruem a impressora a usar um tipo específico de mídia.

O Unknownvalue nunca é usado em propriedades de PrintCapabilities objetos.

Você nunca deve definir uma PrintTicket propriedade como Unknown. Se algum outro PrintTicket aplicativo produtor tiver criado um documento PrintTicket que define o recurso de tipo de mídia de página como uma opção não reconhecida (ou seja, uma opção que não está definida no Esquema de Impressão), um PrintTicket objeto em seu aplicativo construído com esse documento terá Unknown como o valor da PageMediaType propriedade.

Embora as PrintTicket classes e PrintCapabilities não possam ser herdadas, você pode estender o Esquema de Impressão para reconhecer recursos de dispositivo de impressão que não são contabilizados nas PageMediaType classes ou PrintCapabilities . Para obter mais informações, consulte Como estender o esquema de impressão e criar novas classes do sistema de impressão.

Aplica-se a

Compartilhar via