PrintQueue Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 |
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 |
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 |
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 |
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) |