PrintQueue Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Gère les imprimantes et les travaux d’impression.
public ref class PrintQueue : System::Printing::PrintSystemObject
public class PrintQueue : System.Printing.PrintSystemObject
type PrintQueue = class
inherit PrintSystemObject
Public Class PrintQueue
Inherits PrintSystemObject
- Héritage
Remarques
Certaines propriétés de l’objet PrintQueue représentent des caractéristiques de l’utilitaire de file d’attente d’impression qui s’exécute sur l’ordinateur, mais d’autres représentent des fonctionnalités ou des états de l’imprimante elle-même. Par exemple, NumberOfJobs est une caractéristique de la file d’attente d’impression, mais Location il s’agit d’une propriété de l’imprimante. De nombreuses propriétés de l’imprimante, telles que si elle a besoin de l’attention de l’utilisateur, doivent être passées, par le biais de la méthode, de l’imprimante Refresh elle-même à l’objet PrintQueue . Cette opération doit être effectuée avant que la propriété correspondante (NeedUserIntervention) soit lue par votre programme. De même, lorsque votre programme modifie les valeurs d’une ou plusieurs propriétés d’un PrintQueue objet, la modification doit être écrite dans l’utilitaire de file d’attente d’impression réel sur l’ordinateur. Procédez ainsi avec la Commit méthode.
Caution
Les classes de l’espace System.Printing de noms ne sont pas prises en charge pour une utilisation au sein d’un service Windows ou d’une application ou d’un service ASP.NET. La tentative d’utilisation de ces classes à partir de l’un de ces types d’applications peut entraîner des problèmes inattendus, tels que des performances de service réduites et des exceptions d’exécution.
Si vous souhaitez imprimer à partir d’une application Windows Forms, consultez l’espace System.Drawing.Printing de noms.
Constructeurs
| Nom | Description |
|---|---|
| PrintQueue(PrintServer, String, Int32, PrintSystemDesiredAccess) |
Initialise une nouvelle instance de classe à l’aide du nom de file d’attente, du nom de la file d’attente, PrintServerde la version du PrintQueue schéma d’impression et de l’accès souhaité. |
| PrintQueue(PrintServer, String, Int32) |
Initialise une nouvelle instance de classe à l’aide du nom de file d’attente, du nom de la file d’attente et de la version de PrintQueue schéma d’impression spécifiée PrintServer. |
| PrintQueue(PrintServer, String, PrintQueueIndexedProperty[], PrintSystemDesiredAccess) |
Initialise une nouvelle instance de PrintQueue classe avec le nom de file d’attente, le nom de la file d’attente, PrintServerle tableau de PrintQueueIndexedProperty valeurs à initialiser et l’accès souhaité. |
| PrintQueue(PrintServer, String, PrintQueueIndexedProperty[]) |
Initialise une nouvelle instance de PrintQueue classe à l’aide du nom de file d’attente et du tableau de PrintQueueIndexedProperty valeurs spécifiés PrintServerà initialiser. |
| PrintQueue(PrintServer, String, PrintSystemDesiredAccess) |
Initialise une nouvelle instance de PrintQueue classe à l’aide du nom de file d’attente spécifié PrintServeret de l’accès souhaité. |
| PrintQueue(PrintServer, String, String[], PrintSystemDesiredAccess) |
Initialise une nouvelle instance de classe à l’aide du nom de file d’attente, du PrintServernom de PrintQueue la file d’attente, du filtre de propriétés et de l’accès souhaité. |
| PrintQueue(PrintServer, String, String[]) |
Initialise une nouvelle instance de PrintQueue classe à l’aide du nom de file d’attente, du nom de la file d’attente et du tableau de noms de propriétés spécifiés PrintServerà initialiser. |
| PrintQueue(PrintServer, String) |
Initialise une nouvelle instance de PrintQueue classe à l’aide du nom spécifié PrintServer et de la file d’attente. |
Propriétés
| Nom | Description |
|---|---|
| AveragePagesPerMinute |
Obtient la vitesse de l’imprimante mesurée en pages par minute. |
| ClientPrintSchemaVersion |
Obtient la version du schéma d’impression. |
| Comment |
Obtient ou définit un commentaire sur l’imprimante. |
| CurrentJobSettings |
Obtient un objet qui contient les paramètres de configuration du travail d’impression actuel. |
| DefaultPrintTicket |
Obtient ou définit les options d’imprimante par défaut associées à ce PrintQueue. |
| DefaultPriority |
Obtient ou définit la priorité par défaut qui est donnée à chaque nouvelle tâche d’impression ajoutée à la file d’attente. |
| Description |
Obtient une description de la file d’attente d’impression. |
| FullName |
Obtient le nom complet de la file d’attente. |
| HasPaperProblem |
Obtient une valeur qui indique si l’imprimante rencontre un problème de papier non spécifié. |
| HasToner |
Obtient une valeur qui indique si l’imprimante a un toner. |
| HostingPrintServer |
Obtient ou définit (protégé) le serveur d’impression qui contrôle la file d’attente d’impression. |
| InPartialTrust |
Obtient ou définit une valeur qui indique si la file d’attente fonctionne en mode partiellement approuvé, un niveau de confiance supérieur. |
| IsBidiEnabled |
Obtient une valeur qui indique si la communication bidirectionnelle avec l’imprimante est activée. |
| IsBusy |
Obtient une valeur qui indique si l’appareil d’impression est occupé. |
| IsDevQueryEnabled |
Obtient une valeur qui indique si la file d’attente contient des documents lorsque les configurations de document et d’imprimante ne correspondent pas. |
| IsDirect |
Obtient une valeur qui indique si la file d’attente imprime directement dans l’imprimante ou spools des documents, puis les imprime. |
| IsDisposed |
Obtient ou définit une valeur qui indique si l’objet a été supprimé. (Hérité de PrintSystemObject) |
| IsDoorOpened |
Obtient une valeur qui indique si une porte est ouverte sur l’imprimante. |
| IsHidden |
Obtient une valeur qui indique si la file d’attente d’impression est masquée dans l’interface utilisateur de votre application. |
| IsInError |
Obtient une valeur qui indique si l’imprimante ou l’appareil est dans une condition d’erreur. |
| IsInitializing |
Obtient une valeur qui indique si l’imprimante s’initialise elle-même. |
| IsIOActive |
Obtient une valeur qui indique si l’imprimante reçoit ou envoie des données ou des signaux. |
| IsManualFeedRequired |
Obtient une valeur qui indique si l’imprimante doit être alimentée manuellement du papier pour le travail d’impression actuel. |
| IsNotAvailable |
Obtient une valeur qui indique si l’imprimante est disponible. |
| IsOffline |
Obtient une valeur qui indique si l’imprimante est hors connexion. |
| IsOutOfMemory |
Obtient une valeur qui indique si l’imprimante est hors mémoire. |
| IsOutOfPaper |
Obtient une valeur qui indique si l’imprimante doit être rechargée avec du papier de la taille requise pour le travail actuel. |
| IsOutputBinFull |
Obtient une valeur qui indique si la zone de sortie de l’imprimante est en danger de dépassement de capacité. |
| IsPaperJammed |
Obtient une valeur qui indique si la feuille de papier actuelle est bloquée dans l’imprimante. |
| IsPaused |
Obtient une valeur qui indique si la file d’attente d’impression a été suspendue. |
| IsPendingDeletion |
Obtient une valeur qui indique si l’imprimante est en cours de suppression d’un travail d’impression. |
| IsPowerSaveOn |
Obtient une valeur qui indique si l’imprimante est en mode d’économie d’alimentation. |
| IsPrinting |
Obtient une valeur qui indique si un travail est en cours d’impression. |
| IsProcessing |
Obtient une valeur qui indique si l’imprimante traite un travail d’impression. |
| IsPublished |
Obtient une valeur qui indique si l’imprimante est visible par d’autres utilisateurs du réseau. |
| IsQueued |
Obtient une valeur qui indique si l’imprimante peut prendre en charge une file d’attente avec plusieurs travaux d’impression à la fois. |
| IsRawOnlyEnabled |
Obtient une valeur qui indique si la file d’attente d’impression peut utiliser EMF (Meta File amélioré) qui permet un flux de données plus rapide d’une application d’impression vers le spouleur Windows. |
| IsServerUnknown |
Obtient une valeur qui indique si l’imprimante est dans un état d’erreur. |
| IsShared |
Obtient une valeur qui indique si l’imprimante est disponible pour une utilisation par d’autres ordinateurs sur le réseau. |
| IsTonerLow |
Obtient une valeur qui indique si l’imprimante est en cours d’exécution à court de toner. |
| IsWaiting |
Obtient une valeur qui indique si la file d’attente attend l’ajout d’un travail. |
| IsWarmingUp |
Obtient une valeur qui indique si l’imprimante se réchauffe. |
| IsXpsDevice |
Obtient une valeur qui indique si le pilote de l’imprimante est basé sur le modèle XPSDrv afin qu’il utilise la spécification de papier XML (XPS) comme langue de description de page. |
| KeepPrintedJobs |
Obtient une valeur qui indique si la file d’attente enregistre le fichier de langue de l’imprimante au lieu de la supprimer après l’impression. |
| Location |
Obtient ou définit l’emplacement physique de l’imprimante. |
| MaxPrintSchemaVersion |
Obtient le numéro de version possible le plus récent du schéma d’impression que la file d’attente peut utiliser. |
| Name |
Obtient ou définit le nom de la file d’attente d’impression. |
| NeedUserIntervention |
Obtient une valeur qui indique si l’imprimante a besoin de l’attention d’un être humain. |
| NumberOfJobs |
Obtient le nombre total de travaux alignés dans la file d’attente d’impression. |
| PagePunt |
Obtient une valeur qui indique si l’imprimante ne peut pas imprimer la page active. |
| Parent |
Renvoie le parent de l’objet. (Hérité de PrintSystemObject) |
| PrintingIsCancelled |
Obtient ou définit une valeur qui indique si le travail d’impression actuel est annulé. |
| Priority |
Obtient ou définit la priorité de la file d’attente d’impression par rapport à d’autres files d’attente d’impression hébergées par le même serveur d’impression et qui utilisent la même imprimante physique. |
| PropertiesCollection |
Obtient une collection de paires d’attributs et de valeurs. (Hérité de PrintSystemObject) |
| QueueAttributes |
Obtient les propriétés de la file d’attente d’impression. |
| QueueDriver |
Obtient ou définit le pilote d’imprimante pour la file d’attente. |
| QueuePort |
Obtient ou définit le port utilisé par la file d’attente. |
| QueuePrintProcessor |
Obtient ou définit le processeur d’impression que la file d’attente utilise. |
| QueueStatus |
Obtient une valeur qui représente l’état de l’imprimante. Il s’agit notamment de « réchauffement », d'« initialisation », d'« impression » et d’autres. |
| ScheduleCompletedJobsFirst |
Obtient une valeur qui indique si l’imprimante imprime les travaux qui ont terminé le processus de spoulage avant les travaux qui n’ont pas entièrement été mis en pool même si ceux-ci ont d’abord entré la file d’attente ou ont une priorité plus élevée. |
| SeparatorFile |
Obtient ou définit le chemin d’accès et le nom de fichier d’un fichier inséré au début de chaque travail d’impression. |
| ShareName |
Obtient ou définit un nom pour l’imprimante qui est visible par les utilisateurs sur le réseau lorsqu’il est partagé. |
| StartTimeOfDay |
Obtient ou définit l’heure la plus ancienne du jour, exprimée sous la forme du nombre de minutes après minuit temps universel coordonné (UTC) (également appelée Heure moyenne de Greenwich [GMT]), que l’imprimante imprime un travail. |
| UntilTimeOfDay |
Obtient ou définit l’heure la plus récente, exprimée sous la forme du nombre de minutes après minuit temps universel coordonné (UTC) (également appelée Heure moyenne de Greenwich [GMT]), que l’imprimante imprime un travail. |
| UserPrintTicket |
Obtient ou définit l’objet par défaut PrintTicket de l’utilisateur actuel, qui contient des informations détaillées sur la tâche d’impression. |
Méthodes
| Nom | Description |
|---|---|
| AddJob() |
Insère un nouveau travail d’impression (génériquement nommé), dont le contenu est un Byte tableau, dans la file d’attente. |
| AddJob(String, PrintTicket) |
Insère un nouveau travail d’impression pour un document XPS (XML Paper Specification) dans la file d’attente et lui donne le nom et les paramètres spécifiés. |
| AddJob(String, String, Boolean, PrintTicket) |
Insère un nouveau travail d’impression pour un document XPS (XML Paper Specification) dans la file d’attente, lui donne le nom et les paramètres spécifiés et spécifie s’il doit être validé ou non. |
| AddJob(String, String, Boolean) |
Insère un nouveau travail d’impression pour un document XPS (XML Paper Specification) dans la file d’attente, lui donne le nom spécifié et spécifie s’il doit être validé ou non. |
| AddJob(String) |
Insère un nouveau travail d’impression, dont le contenu est un Byte tableau, dans la file d’attente. |
| Commit() |
Écrit les propriétés actuelles de l’objet PrintQueue dans la file d’attente d’impression réelle sur le serveur d’impression. |
| CreateXpsDocumentWriter(Double, Double) |
Crée un XpsDocumentWriter objet avec les dimensions spécifiées. |
| CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange) |
Crée un XpsDocumentWriter objet, ouvre une boîte de dialogue d’impression commune Windows, fournit la boîte de dialogue avec une plage de pages et une description du travail d’impression et retourne un |
| CreateXpsDocumentWriter(PrintDocumentImageableArea) |
Crée un XpsDocumentWriter objet, ouvre une boîte de dialogue d’impression commune Windows et retourne un |
| CreateXpsDocumentWriter(PrintQueue) |
Crée un XpsDocumentWriter objet et l’associe à la file d’attente d’impression spécifiée. |
| CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange) |
Crée un XpsDocumentWriter objet, ouvre une boîte de dialogue d’impression commune Windows, fournit la boîte de dialogue avec une plage de pages et retourne un |
| CreateXpsDocumentWriter(String, PrintDocumentImageableArea) |
Crée un XpsDocumentWriter objet, ouvre une boîte de dialogue d’impression commune Windows (et fournit une description de travail) et retourne un |
| Dispose() |
Libère toutes les ressources utilisées par le PrintSystemObject. (Hérité de PrintSystemObject) |
| Dispose(Boolean) |
Libère les ressources non managées utilisées par les PrintSystemObject ressources gérées et libère éventuellement les ressources managées. (Hérité de PrintSystemObject) |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetJob(Int32) |
Obtient le travail d’impression avec le numéro d’ID spécifié. |
| GetPrintCapabilities() |
Obtient un PrintCapabilities objet qui identifie les fonctionnalités de l’imprimante. |
| GetPrintCapabilities(PrintTicket) |
Obtient un PrintCapabilities objet qui identifie les fonctionnalités de l’imprimante. |
| GetPrintCapabilitiesAsXml() |
Obtient un MemoryStream objet qui spécifie les fonctionnalités de l’imprimante en tant que flux XML conforme au schéma d’impression. |
| GetPrintCapabilitiesAsXml(PrintTicket) |
Obtient un MemoryStream objet qui spécifie les fonctionnalités de l’imprimante dans un format XML conforme au schéma d’impression. |
| GetPrintJobInfoCollection() |
Crée une collection qui contient un PrintSystemJobInfo objet pour chaque travail dans la file d’attente. |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| Initialize() |
Initialise les propriétés du PrintSystemObject. (Hérité de PrintSystemObject) |
| InternalDispose(Boolean) |
Libère les ressources non managées utilisées par les PrintQueue ressources gérées et libère éventuellement les ressources managées. |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| MergeAndValidatePrintTicket(PrintTicket, PrintTicket, PrintTicketScope) |
Fusionne deux PrintTickets et garantit que le résultat PrintTicket est valide, ne demande aucune fonctionnalité d’impression que l’imprimante ne prend pas en charge et est limitée à l’étendue spécifiée. |
| MergeAndValidatePrintTicket(PrintTicket, PrintTicket) |
Fusionne deux PrintTickets et garantit que le résultat PrintTicket est valide et ne demande aucune fonctionnalité d’impression que l’imprimante ne prend pas en charge. |
| Pause() |
Suspend la file d’attente d’impression. Elle reste suspendue jusqu’à ce qu’elle Resume() soit exécutée. |
| Purge() |
Supprime tous les travaux de la file d’attente d’impression. |
| Refresh() |
Met à jour les propriétés de l’objet PrintQueue avec des valeurs de l’imprimante et de l’utilitaire de file d’attente d’impression qui s’exécute sur l’ordinateur. |
| Resume() |
Redémarre une file d’attente d’impression qui a été suspendue. |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |