Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase PrintTicket

 

Publicado: octubre de 2016

Define la configuración de un trabajo de impresión.

Espacio de nombres:   System.Printing
Ensamblado:  ReachFramework (en ReachFramework.dll)

System.Object
  System.Printing.PrintTicket

public sealed class PrintTicket : INotifyPropertyChanged

NombreDescripción
System_CAPS_pubmethodPrintTicket()

Inicializa una nueva instancia de la clase PrintTicket.

System_CAPS_pubmethodPrintTicket(Stream)

Inicializa una nueva instancia de la PrintTicket clase usando una secuencia XML (que contiene un documento de PrintTicket) que cumpla con el XML Print Schema.

NombreDescripción
System_CAPS_pubpropertyCollation

Obtiene o establece un valor que indica si la impresora intercala el resultado.

System_CAPS_pubpropertyCopyCount

Obtiene o establece el número de copias del trabajo de impresión.

System_CAPS_pubpropertyDeviceFontSubstitution

Obtiene o establece un valor que indica si la impresora sustituye las fuentes basadas en dispositivo por fuentes basadas en el equipo en el trabajo de impresión.

System_CAPS_pubpropertyDuplexing

Obtiene o establece un valor que indica el tipo de la impresión de dos caras, si lo hubiera, la impresora se usa para el trabajo de impresión.

System_CAPS_pubpropertyInputBin

Obtiene o establece un valor que indica qué bandeja de entrada (Bandeja de papel) para usar.

System_CAPS_pubpropertyOutputColor

Obtiene o establece un valor que indica cómo la impresora controla el contenido que tiene color o tonos de gris.

System_CAPS_pubpropertyOutputQuality

Obtiene o establece un valor que indica la calidad del resultado del trabajo de impresión.

System_CAPS_pubpropertyPageBorderless

Obtiene o establece un valor que indica si el dispositivo imprime el contenido hasta el borde del soporte o deja un margen alrededor del borde.

System_CAPS_pubpropertyPageMediaSize

Obtiene o establece el tamaño de papel (u otro medio) que utiliza una impresora para un trabajo de impresión.

System_CAPS_pubpropertyPageMediaType

Obtiene o establece un valor que indica a qué tipo de papel o medio que la impresora utilizará para el trabajo de impresión.

System_CAPS_pubpropertyPageOrder

Obtiene o establece un valor que indica si la impresora imprime varias páginas atrás al frente o frontal hacia atrás.

System_CAPS_pubpropertyPageOrientation

Obtiene o establece un valor que indica cómo se orienta para imprimir el contenido de la página.

System_CAPS_pubpropertyPageResolution

Obtiene o establece el nivel de resolución de página que utiliza la impresora para un trabajo de impresión.

System_CAPS_pubpropertyPageScalingFactor

Obtiene o establece el porcentaje por el que la impresora amplía o reduce la imagen impresa en una página.

System_CAPS_pubpropertyPagesPerSheet

Obtiene o establece el número de páginas que se imprimen en cada cara de una hoja de papel.

System_CAPS_pubpropertyPagesPerSheetDirection

Obtiene o establece un valor que indica cómo la impresora organiza varias páginas que se imprimen en cada lado de una hoja de papel.

System_CAPS_pubpropertyPhotoPrintingIntent

Obtiene o establece un valor que indica, en términos cualitativos, el nivel de calidad que usa la impresora para imprimir una foto.

System_CAPS_pubpropertyStapling

Obtiene o establece un valor que indica si y dónde, una impresora grapa varias páginas.

System_CAPS_pubpropertyTrueTypeFontMode

Obtiene o establece un valor que indica cómo la impresora controla el texto que utiliza fuentes TrueType.

NombreDescripción
System_CAPS_pubmethodClone()

Crea un clon modificable de este PrintTicket y hace copias en profundidad de los valores de este objeto.

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodGetXmlStream()

Devuelve un MemoryStream objeto que representa los valores de propiedad de un PrintTicket como una secuencia XML que se ajusta a la Print Schema.

System_CAPS_pubmethodSaveTo(Stream)

Guarda el PrintTicket configuración para un Stream objeto utilizando un formato XML que se ajusta a la Print Schema.

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

NombreDescripción
System_CAPS_pubeventPropertyChanged

Se produce cuando alguna propiedad de la PrintTicket cambios.

Un PrintTicket objeto es una representación fácil-a-trabajo-con determinados tipos de documento XML denominado de un documento PrintTicket. Éste es un conjunto de instrucciones que indican a una impresora cómo establecer sus distintas características (como doble cara, intercalación y grapado). Por ejemplo, para indicar a la impresora que Active la grapadora y grapar los trabajos de impresión en la esquina superior izquierda, el documento tendrá un <JobStapleAllDocuments … > elemento que especifica StapleTopLeft. El elemento es, a su vez, representado por la Stapling propiedad de la PrintTicket objeto. El documento PrintTicket debe ajustarse a la Print Schema.

La PrintTicket clase habilita la aplicación para configurar las características de la impresora sin necesidad de escribir directamente en los de XML Stream objetos.

Todas las características más populares de empresariales y domésticas impresoras fotográficas y de archivo se representan mediante las propiedades de PrintTicket la clase. Pero la Print Schema define muchos más, menos común, características y se pueden extender para controlar las características de los dispositivos de impresión especializados. Por lo tanto, aunque el PrintTicket y PrintCapabilities no se puede heredar las clases, puede ampliar el Print Schema para reconocer las características de dispositivo de impresión que no se recoge en el PrintTicket o PrintCapabilities clases. Para obtener más información, consulte NOTINBUILD: Cómo: Extender el esquema de impresión y crear nuevas clases de sistema de impresión.

Nota   cuando la PrintTicket objeto se crea con el constructor que toma un documento de PrintTicket (como un Stream) parámetro, ese documento completo se almacena en un campo no público del objeto, incluidos los elementos XML que expresan características menos comunes que no están representadas por ninguna de las propiedades públicas de la PrintTicket clase. De hecho, si el controlador que generó el documento PrintTicket utiliza una extensión privada de la Print Schema, que ha definido marcado también se almacena como parte del documento PrintTicket no público.

System_CAPS_cautionPrecaución

Las clases en el System.Printing no se admite el espacio de nombres para su uso dentro de un servicio de Windows o la aplicación ASP.NET o el servicio. Al intentar utilizar estas clases en uno de estos tipos de aplicaciones puede generar problemas inesperados, tal como se ve reducida excepciones de rendimiento y tiempo de ejecución de servicio.

Si desea imprimir desde una aplicación de formularios Windows Forms, consulte el System.Drawing.Printing espacio de nombres.

En el ejemplo siguiente se muestra cómo determinar las capacidades de una impresora específica y cómo configurar un trabajo de impresión para aprovecharlas.

// ---------------------- 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 printCapabilites = printQueue.GetPrintCapabilities();

    // Modify PrintTicket
    if (printCapabilites.CollationCapability.Contains(Collation.Collated))
    {
        printTicket.Collation = Collation.Collated;
    }

    if ( printCapabilites.DuplexingCapability.Contains(
            Duplexing.TwoSidedLongEdge) )
    {
        printTicket.Duplexing = Duplexing.TwoSidedLongEdge;
    }

    if (printCapabilites.StaplingCapability.Contains(Stapling.StapleDualLeft))
    {
        printTicket.Stapling = Stapling.StapleDualLeft;
    }

    return printTicket;
}// end:GetPrintTicketFromPrinter()

.NET Framework
Disponible desde 3.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: