PrintQueue Classe

Definizione

Gestisce stampanti e processi di stampa.

public ref class PrintQueue : System::Printing::PrintSystemObject
public class PrintQueue : System.Printing.PrintSystemObject
type PrintQueue = class
    inherit PrintSystemObject
Public Class PrintQueue
Inherits PrintSystemObject
Ereditarietà

Commenti

Alcune proprietà dell'oggetto rappresentano le caratteristiche dell'utilità PrintQueue coda di stampa eseguita nel computer, ma altre rappresentano caratteristiche o stati della stampante stessa. Ad esempio, NumberOfJobs è una caratteristica della coda di stampa, ma Location è una proprietà della stampante. Molte delle proprietà della stampante, ad esempio se richiede attenzione da parte dell'utente, devono essere passate, tramite il Refresh metodo , dalla stampante stessa all'oggetto PrintQueue . Questa operazione deve essere eseguita prima che la proprietà corrispondente (NeedUserIntervention) venga letta dal programma. Analogamente, quando il programma modifica i valori di una o più proprietà di un PrintQueue oggetto, la modifica deve essere scritta nell'utilità coda di stampa effettiva nel computer. Eseguire questa operazione con il Commit metodo .

Attenzione

Le classi all'interno dello spazio dei System.Printing nomi non sono supportate per l'uso all'interno di un servizio Windows o di ASP.NET'applicazione o servizio. Il tentativo di usare queste classi all'interno di uno di questi tipi di applicazione può generare problemi imprevisti, ad esempio le prestazioni del servizio ridotte e le eccezioni di runtime.

Se si desidera stampare da un'applicazione Windows Form, vedere lo spazio dei nomi System.Drawing.Printing.

Costruttori

PrintQueue(PrintServer, String)

Inizializza una nuova istanza della classe PrintQueue utilizzando l'oggetto PrintServer e il nome della coda specificati.

PrintQueue(PrintServer, String, Int32)

Inizializza una nuova istanza della classe PrintQueue utilizzando l'oggetto PrintServer, il nome della coda e la versione dello schema di stampa specificati.

PrintQueue(PrintServer, String, Int32, PrintSystemDesiredAccess)

Inizializza una nuova istanza della classe PrintQueue utilizzando l'oggetto PrintServer, il nome della coda, la versione dello schema di stampa e l'accesso desiderato specificati.

PrintQueue(PrintServer, String, PrintQueueIndexedProperty[])

Inizializza una nuova istanza della classe PrintQueue utilizzando l'oggetto PrintServer, il nome della coda e la matrice dei valori PrintQueueIndexedProperty per l'inizializzazione specificati.

PrintQueue(PrintServer, String, PrintQueueIndexedProperty[], PrintSystemDesiredAccess)

Inizializza una nuova istanza della classe PrintQueue utilizzando l'oggetto PrintServer, il nome della coda, la matrice dei valori PrintQueueIndexedProperty per l'inizializzazione e l'accesso desiderato specificati.

PrintQueue(PrintServer, String, PrintSystemDesiredAccess)

Inizializza una nuova istanza della classe PrintQueue utilizzando l'oggetto PrintServer, il nome della coda e l'accesso desiderato specificati.

PrintQueue(PrintServer, String, String[])

Inizializza una nuova istanza della classe PrintQueue utilizzando l'oggetto PrintServer, il nome della coda e la matrice dei nomi di proprietà da inizializzare specificati.

PrintQueue(PrintServer, String, String[], PrintSystemDesiredAccess)

Inizializza una nuova istanza della classe PrintQueue utilizzando l'oggetto PrintServer, il nome della coda, il filtro di proprietà e l'accesso desiderato specificati.

Proprietà

AveragePagesPerMinute

Ottiene la velocità della stampante espressa in numero di pagine al minuto.

ClientPrintSchemaVersion

Ottiene la versione dello schema di stampa.

Comment

Ottiene o imposta un commento relativo alla stampante.

CurrentJobSettings

Ottiene un oggetto contenente le impostazioni di configurazione del processo di stampa corrente.

DefaultPrintTicket

Ottiene o imposta le opzioni della stampante predefinita associate a tale PrintQueue.

DefaultPriority

Ottiene o imposta la priorità predefinita assegnata ad ogni nuovo processo di stampa aggiunto alla coda.

Description

Ottiene una descrizione della coda di stampa.

FullName

Ottiene il nome completo della coda di stampa.

HasPaperProblem

Ottiene un valore che indica se la stampante ha un problema con la carta non specificato.

HasToner

Ottiene un valore che indica se la stampante ha toner.

HostingPrintServer

Ottiene o imposta (su protetto) il server di stampa che controlla la coda di stampa.

InPartialTrust

Ottiene o imposta un valore che indica se la coda sta operando in una modalità parzialmente attendibile: un livello più alto di attendibilità.

IsBidiEnabled

Ottiene un valore che indica se la comunicazione bidirezionale con la stampante è attivata.

IsBusy

Ottiene un valore che indica se il dispositivo di stampa è occupato.

IsDevQueryEnabled

Ottiene un valore che indica se i documenti vengono tenuti nella coda quando le configurazioni di documento e stampante non corrispondono.

IsDirect

Ottiene un valore che indica se la coda stampa direttamente alla stampante oppure effettua lo spooling dei documenti prima di stamparli.

IsDisposed

Ottiene o imposta un valore che indica se l'oggetto è stato eliminato.

(Ereditato da PrintSystemObject)
IsDoorOpened

Ottiene un valore che indica se una porta della stampante è aperta.

IsHidden

Ottiene un valore che indica se la coda di stampa è nascosta nell'interfaccia utente dell'applicazione.

IsInError

Ottiene un valore che indica se la stampante o il dispositivo sono in una condizione di errore.

IsInitializing

Ottiene un valore che indica se è in corso l'autoinizializzazione della stampante.

IsIOActive

Ottiene un valore che indica se la stampante sta ricevendo o inviando dati o segnali.

IsManualFeedRequired

Ottiene un valore che indica se la stampante necessita di alimentazione manuale della carta per il processo di stampa corrente.

IsNotAvailable

Ottiene un valore che indica se la stampante è disponibile.

IsOffline

Ottiene un valore che indica se la stampante non è in linea.

IsOutOfMemory

Ottiene un valore che indica se la memoria della stampante è insufficiente.

IsOutOfPaper

Ottiene un valore che indica se è necessario ricaricare la stampante con carta del formato richiesto per il processo corrente.

IsOutputBinFull

Ottiene un valore che indica se l'area di output della stampante è a rischio di overflow.

IsPaperJammed

Ottiene un valore che indica se il foglio di carta corrente è inceppato nella stampante.

IsPaused

Ottiene un valore che indica se la coda di stampa è in pausa.

IsPendingDeletion

Ottiene un valore che indica se è in corso l'eliminazione di un processo di stampa.

IsPowerSaveOn

Ottiene un valore che indica se la stampante è in modalità risparmio energia.

IsPrinting

Ottiene un valore che indica se è in corso la stampa di un processo.

IsProcessing

Ottiene un valore che indica se è in corso l'elaborazione di un processo di stampa.

IsPublished

Ottiene un valore che indica se la stampante è visibile agli altri utenti della rete.

IsQueued

Ottiene un valore che indica se la stampante è in grado di supportare una coda contenente più processi di stampa contemporaneamente.

IsRawOnlyEnabled

Ottiene un valore che indica se la coda di stampa è in grado di utilizzare il formato EMF (metafile avanzato, Enhanced Metafile), che consente un flusso di dati più veloce dall'applicazione di stampa allo spooler di Windows.

IsServerUnknown

Ottiene un valore che indica se la stampante è in uno stato di errore.

IsShared

Ottiene un valore che indica se la stampante è disponibile per l'uso da parte di altri computer nella rete.

IsTonerLow

Ottiene un valore che indica se il toner della stampante sta per finire.

IsWaiting

Ottiene un valore che indica se la coda è in attesa dell'aggiunta di un processo.

IsWarmingUp

Ottiene un valore che indica se la stampante è in fase di riscaldamento.

IsXpsDevice

Ottiene un valore che indica se il driver della stampante è compilato in base al modello XPSDrv, quindi usa XPS (XML Paper Specification) come linguaggio di descrizione della pagina.

KeepPrintedJobs

Ottiene un valore che indica se la coda salva il file del linguaggio della stampante anziché eliminarlo dopo la stampa.

Location

Ottiene o imposta la posizione fisica della stampante.

MaxPrintSchemaVersion

Ottiene il numero di versione più recente possibile dello schema di stampa che la coda può usare.

Name

Ottiene o imposta il nome della coda di stampa.

NeedUserIntervention

Ottiene un valore che indica se la stampante necessita di un intervento umano.

NumberOfJobs

Ottiene il numero complessivo di processi allineati nella coda di stampa.

PagePunt

Ottiene un valore che indica se la stampante non è in grado di stampare la pagina corrente.

Parent

Ottiene l'elemento padre dell'oggetto.

(Ereditato da PrintSystemObject)
PrintingIsCancelled

Ottiene o imposta un valore che indica se è in corso l'annullamento del processo di stampa corrente.

Priority

Ottiene o imposta la priorità della coda di stampa rispetto ad altre code ospitate dallo stesso server di stampa che utilizzano la stessa stampante fisica.

PropertiesCollection

Ottiene un insieme di coppie di attributi e valori.

(Ereditato da PrintSystemObject)
QueueAttributes

Ottiene le proprietà della coda di stampa.

QueueDriver

Ottiene o imposta il driver della stampante utilizzato dalla coda di stampa.

QueuePort

Ottiene o imposta la porta utilizzata dalla coda di stampa.

QueuePrintProcessor

Ottiene o imposta il processore di stampa utilizzato dalla coda.

QueueStatus

Ottiene un valore che rappresenta lo stato della stampante. Tra i valori possibili vi sono quelli relativi a riscaldamento in corso, inizializzazione in corso, stampa e così via.

ScheduleCompletedJobsFirst

Ottiene un valore che indica se la stampante tratta i processi che hanno completato lo spooling prima di quelli che non lo hanno completato, anche se questi ultimi sono stati inseriti in coda per primi o hanno una priorità più alta.

SeparatorFile

Ottiene o imposta il nome e il percorso di un file che viene inserito all'inizio di ciascun processo di stampa.

ShareName

Ottiene o imposta un nome per la stampante che, se condivisa, viene visualizzato dagli utenti in rete.

StartTimeOfDay

Ottiene o imposta il primo orario possibile, espresso come numero di minuti dopo la mezzanotte ora UTC (Coordinated Universal Time), nota anche come ora GMT (Greenwich Mean Time), per la stampa di un processo.

UntilTimeOfDay

Ottiene o imposta l'ultimo orario possibile, espresso come numero di minuti dopo la mezzanotte ora UTC (Coordinated Universal Time), nota anche come ora GMT (Greenwich Mean Time), per la stampa di un processo.

UserPrintTicket

Ottiene o imposta l'oggetto predefinito PrintTicket dell'utente corrente, che contiene informazioni dettagliate sul processo di stampa.

Metodi

AddJob()

Inserisce nella coda un nuovo processo di stampa (con un nome generico), il cui contenuto è una matrice Byte.

AddJob(String)

Inserisce nella coda un nuovo processo di stampa, il cui contenuto è una matrice Byte.

AddJob(String, PrintTicket)

Inserisce un nuovo processo di stampa per un documento XPS (XML Paper Specification) nella coda e assegna il nome e le impostazioni specificati.

AddJob(String, String, Boolean)

Inserisce un nuovo processo di stampa per un documento XPS (XML Paper Specification) nella coda, assegna il nome specificato e specifica se deve essere convalidato o meno.

AddJob(String, String, Boolean, PrintTicket)

Inserisce un nuovo processo di stampa per un documento XPS (XML Paper Specification) nella coda, assegna il nome e le impostazioni specificati e specifica se deve essere convalidato o meno.

Commit()

Scrive le proprietà correnti dell'oggetto PrintQueue nella coda di stampa effettiva sul server di stampa.

CreateXpsDocumentWriter(Double, Double)

Crea un oggetto XpsDocumentWriter delle dimensioni specificate.

CreateXpsDocumentWriter(PrintDocumentImageableArea)

Crea un oggetto XpsDocumentWriter, apre una finestra di dialogo di stampa comune di Windows e restituisce un parametro ref (ByRef in Visual Basic) che rappresenta informazioni sull'area stampabile e le dimensioni dei supporti.

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)

Crea un oggetto XpsDocumentWriter, apre una finestra di dialogo di stampa comune di Windows, include nella finestra di dialogo un intervallo di pagine e una descrizione del processo di stampa e restituisce un parametro ref (ByRef in Visual Basic), che rappresenta informazioni sull'area stampabile e le dimensioni dei supporti.

CreateXpsDocumentWriter(PrintQueue)

Crea un oggetto XpsDocumentWriter e lo associa alla coda di stampa specificata.

CreateXpsDocumentWriter(String, PrintDocumentImageableArea)

Crea un oggetto XpsDocumentWriter, apre una finestra di dialogo di stampa comune di Windows (includendovi una descrizione del processo) e restituisce un parametro ref (ByRef in Visual Basic), che rappresenta informazioni sull'area stampabile e le dimensioni dei supporti.

CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)

Crea un oggetto XpsDocumentWriter, apre una finestra di dialogo di stampa comune di Windows, include nella finestra di dialogo un intervallo di pagine e restituisce un parametro ref (ByRef in Visual Basic), che rappresenta informazioni sull'area stampabile e le dimensioni dei supporti.

Dispose()

Rilascia tutte le risorse usate da PrintSystemObject.

(Ereditato da PrintSystemObject)
Dispose(Boolean)

Rilascia le risorse non gestite usate da PrintSystemObject e, facoltativamente, le risorse gestite.

(Ereditato da PrintSystemObject)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetJob(Int32)

Ottiene il processo di stampa con il numero ID specificato.

GetPrintCapabilities()

Ottiene un oggetto PrintCapabilities che identifica le funzionalità della stampante.

GetPrintCapabilities(PrintTicket)

Ottiene un oggetto PrintCapabilities che identifica le funzionalità della stampante.

GetPrintCapabilitiesAsXml()

Ottiene un oggetto MemoryStream che specifica le funzionalità della stampante come flusso XML conforme allo schema di stampa.

GetPrintCapabilitiesAsXml(PrintTicket)

Ottiene un oggetto MemoryStream che specifica le funzionalità della stampante come formato XML conforme allo schema di stampa.

GetPrintJobInfoCollection()

Crea un insieme contenente un oggetto PrintSystemJobInfo per ciascun processo nella coda.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
Initialize()

Inizializza le proprietà dell'oggetto PrintSystemObject.

(Ereditato da PrintSystemObject)
InternalDispose(Boolean)

Rilascia le risorse non gestite usate da PrintQueue e, facoltativamente, le risorse gestite.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
MergeAndValidatePrintTicket(PrintTicket, PrintTicket)

Unisce due PrintTicket e fa in modo che l'oggetto PrintTicket risultante abbia una validità e non richieda alcuna funzionalità di stampa non supportata dalla stampante.

MergeAndValidatePrintTicket(PrintTicket, PrintTicket, PrintTicketScope)

Unisce due PrintTicket e fa in modo che l'oggetto PrintTicket risultante abbia una validità, non richieda alcuna funzionalità di stampa non supportata dalla stampante e sia limitato all'ambito specificato.

Pause()

Mette in pausa la coda di stampa. La coda rimane in pausa finché non si esegue Resume().

Purge()

Rimuove tutti i processi dalla coda di stampa.

Refresh()

Aggiorna le proprietà dell'oggetto PrintQueue con i valori inviati dalla stampante e dall'utilità della coda di stampa in esecuzione sul computer.

Resume()

Riavvia una coda di stampa messa in pausa.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche