PrintQueue 類別

定義

命名空間:

System.Printing

組件:

System.Printing.dll

管理印表機與列印工作。

public ref class PrintQueue : System::Printing::PrintSystemObject

public class PrintQueue : System.Printing.PrintSystemObject

type PrintQueue = class
    inherit PrintSystemObject

Public Class PrintQueue
Inherits PrintSystemObject

繼承

Object

PrintSystemObject

PrintQueue

備註

物件的 PrintQueue 某些屬性代表電腦上執行的列印隊列工具特性，但其他屬性則代表印表機本身的功能或狀態。 例如， NumberOfJobs 是列印佇列的一個特性，但 Location 卻是印表機的屬性。 印表機的許多特性，例如是否需要使用者注意，都必須透過方法 Refresh 從印表機本身傳遞給 PrintQueue 物件。 這應該在程式讀取對應屬性（NeedUserIntervention）之前完成。 同樣地，當你的程式更改物件一個或多個屬性 PrintQueue 的值時，必須將變更寫入電腦上的實際列印佇列工具。 用這個 Commit 方法來做。

Caution

命名空間內 System.Printing 的類別不支援用於 Windows 服務或 ASP.NET 應用程式或服務中。 嘗試在這些應用程式類型中使用這些類別，可能會產生意想不到的問題，例如服務效能下降及執行時例外。

如果你想從 Windows Forms 應用程式列印，請參考命名 System.Drawing.Printing 空間。

建構函式

名稱	Description
PrintQueue(PrintServer, String, Int32, PrintSystemDesiredAccess)	使用指定的PrintServer佇列名稱、列印結構版本及所需存取權限初始化一個新的類別實例PrintQueue。
PrintQueue(PrintServer, String, Int32)	使用指定的 PrintServer、佇列名稱及列印結構版本初始化一個新的類別實例PrintQueue。
PrintQueue(PrintServer, String, PrintQueueIndexedProperty[], PrintSystemDesiredAccess)	初始化一個新的類別實例 PrintQueue ，包含指定的 PrintServer佇列名稱、要初始化的數值陣列 PrintQueueIndexedProperty 及所需存取權限。
PrintQueue(PrintServer, String, PrintQueueIndexedProperty[])	使用指定的 PrintServer、佇列名稱及數值陣列PrintQueueIndexedProperty初始化一個新的類別實例PrintQueue。
PrintQueue(PrintServer, String, PrintSystemDesiredAccess)	使用指定的PrintServer佇列名稱及所需存取權限初始化一個新的類別實例PrintQueue。
PrintQueue(PrintServer, String, String[], PrintSystemDesiredAccess)	使用指定的 PrintServer、佇列名稱、屬性篩選器及所需存取權限初始化一個新的類別實例PrintQueue。
PrintQueue(PrintServer, String, String[])	使用指定的PrintServer佇列名稱 、 及屬性名稱陣列初始化一個新的類別實例PrintQueue。
PrintQueue(PrintServer, String)	使用指定的 PrintServer 和 佇列名稱初始化一個新的類別實例PrintQueue。

屬性

名稱	Description
AveragePagesPerMinute	它會以每分鐘頁數來衡量印表機的速度。
ClientPrintSchemaVersion	取得 列印架構的版本。
Comment	會收到或設定關於印表機的評論。
CurrentJobSettings	會取得一個包含目前列印工作設定的物件。
DefaultPrintTicket	取得或設定與此 PrintQueue相關聯的預設印表機選項。
DefaultPriority	取得或設定每個新增列印工作到佇列時所給予的預設優先權。
Description	會看到列印佇列的描述。
FullName	會取得隊伍的完整名稱。
HasPaperProblem	會得到一個值，表示印表機是否有未指定的紙張問題。
HasToner	會得到一個數值，指示印表機是否有碳粉。
HostingPrintServer	取得或設定（保護）控制列印佇列的列印伺服器。
InPartialTrust	取得或設定一個值，指示隊列是否處於部分信任模式，即較高的信任等級。
IsBidiEnabled	會得到一個值，表示是否啟用與印表機的雙向通訊。
IsBusy	會得到一個表示列印設備是否忙線的值。
IsDevQueryEnabled	當文件與印表機設定不符時，會獲得一個值，指示佇列是否保存文件。
IsDirect	會取得一個值，指示佇列是直接列印到印表機，還是先捲軸文件再列印。
IsDisposed	會取得或設定一個值，表示該物件是否已被處置。 (繼承來源 PrintSystemObject)
IsDoorOpened	會得到一個值，表示印表機上是否有門是開著的。
IsHidden	會得到一個值，表示列印佇列是否隱藏在你的應用程式介面中。
IsInError	會得到一個值，表示印表機或裝置是否處於錯誤狀態。
IsInitializing	會得到一個值，表示印表機是否正在初始化自己。
IsIOActive	會得到一個表示印表機是否正在接收或傳送資料或訊號的值。
IsManualFeedRequired	會得到一個值，指示印表機是否需要手動送紙以完成當前列印工作。
IsNotAvailable	會得到一個表示印表機是否可用的值。
IsOffline	會得到一個值，表示印表機是否離線。
IsOutOfMemory	會得到一個值，表示印表機是否已使用記憶體。
IsOutOfPaper	會得到一個值，指示是否需要重新裝載符合當前工作所需尺寸的紙張。
IsOutputBinFull	會得到一個值，表示印表機的輸出區域是否有溢出危險。
IsPaperJammed	會得到一個數值，表示目前的紙張是否卡在印表機裡。
IsPaused	會得到一個值，表示列印佇列是否已被暫停。
IsPendingDeletion	會取得一個值，表示印表機是否正在刪除列印工作。
IsPowerSaveOn	會得到一個值，表示印表機是否處於省電模式。
IsPrinting	會得到一個值，表示工作是否正在列印。
IsProcessing	會得到一個值，表示印表機是否正在處理列印工作。
IsPublished	會取得一個值，表示印表機是否對其他網路使用者可見。
IsQueued	會得到一個值，表示印表機是否能同時支援一個包含多個列印工作的佇列。
IsRawOnlyEnabled	會得到一個值，指示列印佇列是否能使用 EMF（增強元檔案），以加速從列印應用程式到 Windows 暫存器的資料流。
IsServerUnknown	會得到一個值，表示印表機是否處於錯誤狀態。
IsShared	會得到一個值，表示該印表機是否可供網路上其他電腦使用。
IsTonerLow	會得到一個數值，表示印表機是否快用墨了。
IsWaiting	會得到一個值，表示佇列是否正在等待新增工作。
IsWarmingUp	會得到一個表示印表機是否正在預熱的值。
IsXpsDevice	會取得一個值，指示印表機驅動程式是否基於 XPSDrv 模型 ，因此使用 XML Paper Specification（XPS）作為頁面描述語言。
KeepPrintedJobs	會取得一個值，表示佇列是否正在儲存印表機語言檔案，而非列印後刪除。
Location	取得或設定印表機的實體位置。
MaxPrintSchemaVersion	取得佇列可以使用的最新列印 結構 版本號。
Name	取得或設定列印佇列的名稱。
NeedUserIntervention	會有一個數值，表示印表機是否需要人工處理。
NumberOfJobs	會顯示列印佇列中排隊的總工作數量。
PagePunt	會取得一個值，指示印表機是否無法列印當前頁面。
Parent	取得物件的父代。 (繼承來源 PrintSystemObject)
PrintingIsCancelled	取得或設定一個值，指示目前列印工作是否被取消。
Priority	取得或設定列印佇列相對於同一列印伺服器且使用同一實體印表機的其他列印佇列的優先順序。
PropertiesCollection	會得到一組屬性與值對。 (繼承來源 PrintSystemObject)
QueueAttributes	取得列印佇列的屬性。
QueueDriver	取得或設定佇列的印表機驅動程式。
QueuePort	取得或設定佇列使用的埠。
QueuePrintProcessor	取得或設定佇列所使用的列印處理器。
QueueStatus	會得到一個代表印表機狀態的值。 這些包括「熱身」、「初始化」、「列印」等。
ScheduleCompletedJobsFirst	會取得一個值，表示印表機是否會先列印已完成排程的作業，而不是尚未完全排程的作業，即使後者先進入佇列或優先權較高。
SeparatorFile	取得或設定在每個列印工作開始時插入的檔案的路徑與檔案名稱。
ShareName	取得或設定印表機名稱，當使用者分享時，網路上會看到該印表機。
StartTimeOfDay	取得或設定印表機列印工作最早的時間，表示為午夜後的協調世界時（UTC）（亦稱格林威治標準時間 GMT）。
UntilTimeOfDay	取得或設定印表機列印工作的最新時間，表示為午夜後的協調世界時（UTC）（亦稱格林威治標準時間 GMT）分鐘數。
UserPrintTicket	取得或設定目前使用者的預設 PrintTicket 物件，該物件包含列印工作的詳細資訊。

方法

名稱	Description
AddJob()	將一個新的（通用命名的）列印工作插入佇列，其內容為 Byte 陣列。
AddJob(String, PrintTicket)	將 XML 紙張規範（XPS）文件的新列印工作插入佇列，並賦予其指定的名稱與設定。
AddJob(String, String, Boolean, PrintTicket)	將 XML 紙本規範（XPS）文件的新列印工作插入佇列，給出指定的名稱與設定，並指定是否需要驗證。
AddJob(String, String, Boolean)	將 XML 紙本規範（XPS）文件的新列印工作插入佇列，賦予指定名稱，並指定是否需驗證。
AddJob(String)	將一個 Byte 新的列印工作插入一個包含陣列的新列印工作。
Commit()	將物件目前的屬性 PrintQueue 寫入列印伺服器上的實際列印佇列。
CreateXpsDocumentWriter(Double, Double)	建立 XpsDocumentWriter 符合指定尺寸的物件。
CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)	建立物件XpsDocumentWriter，開啟 Windows 通用列印對話框，提供頁面範圍與列印工作描述，並回傳一個refByRef（Visual Basic 格式）參數，代表可影像區域及媒體尺寸的資訊。
CreateXpsDocumentWriter(PrintDocumentImageableArea)	建立一個XpsDocumentWriter物件，開啟 Windows 通用列印對話框，並回傳refByRef一個（在 Visual Basic 中）參數，代表可影像區域及媒體尺寸的資訊。
CreateXpsDocumentWriter(PrintQueue)	建立一個 XpsDocumentWriter 物件，並將其關聯到指定的列印佇列。
CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)	建立一個XpsDocumentWriter物件，開啟 Windows 通用列印對話框，提供該對話框的頁面範圍，並回傳refByRef一個（在 Visual Basic 中）參數，代表可影像區域及媒體尺寸的資訊。
CreateXpsDocumentWriter(String, PrintDocumentImageableArea)	建立一個XpsDocumentWriter物件，開啟 Windows 通用列印對話框（並提供工作描述），並回傳refByRef一個（在 Visual Basic 中）參數，代表可影像區域及媒體尺寸的資訊。
Dispose()	釋放所有由 PrintSystemObject. (繼承來源 PrintSystemObject)
Dispose(Boolean)	釋放 未管理的資源， PrintSystemObject 並可選擇性地釋放受管理資源。 (繼承來源 PrintSystemObject)
GetJob(Int32)	會取得指定 ID 編號的列印任務。
GetPrintCapabilities()	取得 PrintCapabilities 一個物件來識別印表機的功能。
GetPrintCapabilities(PrintTicket)	取得 PrintCapabilities 一個物件來識別印表機的功能。
GetPrintCapabilitiesAsXml()	取得 MemoryStream 一個物件，指定印表機的功能，作為符合 列印結構的 XML 串流。
GetPrintCapabilitiesAsXml(PrintTicket)	取得 MemoryStream 一個物件，以符合 列印結構的 XML 格式指定印表機功能。
GetPrintJobInfoCollection()	建立一個集合，包含佇列中每個工作一個 PrintSystemJobInfo 物件。
Initialize()	初始化 的 PrintSystemObject屬性。 (繼承來源 PrintSystemObject)
InternalDispose(Boolean)	釋放 未管理的資源， PrintQueue 並可選擇性地釋放受管理資源。
MergeAndValidatePrintTicket(PrintTicket, PrintTicket, PrintTicketScope)	合併兩個 PrintTickets，保證結果 PrintTicket 有效，不會要求印表機不支援的列印功能，且限制在指定的範圍內。
MergeAndValidatePrintTicket(PrintTicket, PrintTicket)	合併兩個 PrintTickets，保證結果 PrintTicket 有效，且不會要求印表機不支援的任何列印功能。
Pause()	暫停列印佇列。 它會暫停直到 Resume() 執行。
Purge()	移除列印佇列中的所有工作。
Refresh()	更新物件屬性 PrintQueue ，並取得印表機及電腦上執行的列印隊列工具的數值。
Resume()	重新啟動暫停的列印佇列。

另請參閱

• PrintServer