PrintQueue 類別

定義

管理印表機和列印工作。

public ref class PrintQueue : System::Printing::PrintSystemObject
public class PrintQueue : System.Printing.PrintSystemObject
type PrintQueue = class
    inherit PrintSystemObject
Public Class PrintQueue
Inherits PrintSystemObject
繼承

備註

物件的某些屬性 PrintQueue 代表在電腦上執行的列印佇列公用程式特性,但其他屬性則代表印表機本身的功能或狀態。 例如, NumberOfJobs 是列印佇列的特性,但 Location 是印表機的屬性。 印表機的許多屬性,例如是否需要使用者注意、需要透過 方法將印表機本身傳遞 RefreshPrintQueue 物件。 這應該在程式讀取對應的屬性 (NeedUserIntervention) 之前完成。 同樣地,當您的程式變更物件的一或多個屬性值 PrintQueue 時,必須將變更寫入電腦上的實際列印佇列公用程式。 使用 Commit 方法執行此動作。

警告

命名空間內的 System.Printing 類別不支援在Windows服務或 ASP.NET 應用程式或服務中使用。 嘗試從其中一個應用程式類型內使用這些類別可能會產生非預期的問題,例如服務效能降低和執行時間例外狀況。

如果您想要從Windows Forms應用程式列印,請參閱 System.Drawing.Printing 命名空間。

建構函式

PrintQueue(PrintServer, String)

使用指定的 PrintQueue 和佇列名稱,初始化 PrintServer 類別的新執行個體。

PrintQueue(PrintServer, String, Int32)

使用指定的 PrintQueue、佇列名稱和列印結構描述版本,初始化 PrintServer 類別的新執行個體。

PrintQueue(PrintServer, String, Int32, PrintSystemDesiredAccess)

使用指定的 PrintQueue、佇列名稱、列印結構描述版本和想要的存取權限,初始化 PrintServer 類別的新執行個體。

PrintQueue(PrintServer, String, PrintQueueIndexedProperty[])

使用指定的 PrintQueue、佇列名稱和要初始化的 PrintServer 值陣列,初始化 PrintQueueIndexedProperty 類別的新執行個體。

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

使用指定的 PrintQueue、佇列名稱、要初始化的 PrintServer 值陣列和想要的存取權限,初始化 PrintQueueIndexedProperty 類別的新執行個體。

PrintQueue(PrintServer, String, PrintSystemDesiredAccess)

使用指定的 PrintQueue、佇列名稱和想要的存取權限,初始化 PrintServer 類別的新執行個體。

PrintQueue(PrintServer, String, String[])

使用指定的 PrintQueue、佇列名稱和要初始化的屬性名稱陣列,初始化 PrintServer 類別的新執行個體。

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

使用指定的 PrintQueue、佇列名稱、屬性篩選常式 (Filter) 和想要的存取權限,初始化 PrintServer 類別的新執行個體。

屬性

AveragePagesPerMinute

取得以每分鐘頁數測量的印表機速度。

ClientPrintSchemaVersion

取得列印結構描述的版本。

Comment

取得或設定印表機的相關註解。

CurrentJobSettings

取得物件,這個物件包含目前列印工作的組態設定。

DefaultPrintTicket

取得或設定與這個 PrintQueue 關聯的預設印表機選項。

DefaultPriority

取得或設定提供給每個加入佇列之新列印工作的預設優先權。

Description

取得列印佇列的描述。

FullName

取得佇列的完整名稱。

HasPaperProblem

取得值,這個值表示印表機是否有未指定的紙張問題。

HasToner

取得值,這個值表示印表機是否有碳粉。

HostingPrintServer

取得或設定可控制列印佇列之保護 (Protected) 的列印伺服器。

InPartialTrust

取得或設定值,這個值表示佇列是在部分信任的模式這一較高信任層級中操作。

IsBidiEnabled

取得值,這個值表示是否啟用與印表機的雙向 (Bidirectional) 通訊。

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

取得值,這個值表示列印佇列是否可以使用加強型中繼檔 (Enhanced Meta File,EMF),這種檔案能夠加快從列印應用程式到 Windows 多工緩衝處理程式的資料流程。

IsServerUnknown

取得值,這個值表示印表機是否處於錯誤狀態。

IsShared

取得值,這個值表示網路上的其他電腦是否可以使用該印表機。

IsTonerLow

取得值,這個值表示印表機是否碳粉不足。

IsWaiting

取得值,這個值表示佇列是否正等待加入工作。

IsWarmingUp

取得值,這個值表示印表機是否在準備中。

IsXpsDevice

取得值,其指出印表機的驅動程式是否建置在 XPSDrv 模型上,以使用 XML 文件規格 (XPS) 作為其分頁描述語言。

KeepPrintedJobs

取得值,這個值表示佇列是否要在列印後儲存印表機語言檔案,而不是將其刪除。

Location

取得或設定印表機的實體位置。

MaxPrintSchemaVersion

取得佇列可用的最新可能列印結構描述版本號碼。

Name

取得或設定列印佇列的名稱。

NeedUserIntervention

取得值,這個值表示印表機是否需要使用者互動。

NumberOfJobs

取得列印佇列中排列的工作總數。

PagePunt

取得值,這個值表示是否印表機無法列印目前頁。

Parent

取得物件的父物件。

(繼承來源 PrintSystemObject)
PrintingIsCancelled

取得值,這個值表示是否要取消目前的列印工作。

Priority

取得或設定此列印佇列相對於其他列印佇列的優先權,其他列印佇列與此佇列裝載於同一列印伺服器上並使用相同的實體印表機。

PropertiesCollection

取得屬性和值組的集合。

(繼承來源 PrintSystemObject)
QueueAttributes

取得列印佇列的屬性。

QueueDriver

取得或設定佇列的印表機驅動程式。

QueuePort

取得或設定佇列使用的通訊埠。

QueuePrintProcessor

取得或設定佇列使用的列印處理器。

QueueStatus

取得值,這個值表示印表機的狀態。 狀態包括「準備中」、「正在初始化」、「正在列印」及其他狀態。

ScheduleCompletedJobsFirst

取得值,這個值表示印表機是否先列印已完成多工緩衝處理程序的工作,再列印尚未完成多工緩衝處理的工作,即使後者先進入佇列或具有更高優先權也是如此。

SeparatorFile

取得或設定要插入每個列印工作開頭之檔案的路徑和檔名。

ShareName

取得或設定印表機名稱,在網路上共用該印表機時使用者會看到這個名稱。

StartTimeOfDay

取得或設定一天中印表機開始列印工作的最早時間,以午夜 Coordinated Universal Time (UTC,亦稱為格林威治標準時間 (Greenwich Mean Time,GMT)) 之後經過的分鐘數表示。

UntilTimeOfDay

取得或設定一天中印表機列印工作的最晚時間,以午夜 Coordinated Universal Time (UTC,亦稱為格林威治標準時間 (Greenwich Mean Time,GMT)) 之後經過的分鐘數表示。

UserPrintTicket

取得或設定目前使用者的預設 PrintTicket 物件,其中包含列印工作的詳細資訊。

方法

AddJob()

在佇列中插入新 (以一般方式命名) 的列印工作,其內容是 Byte 陣列。

AddJob(String)

在佇列中插入新的列印工作,其內容是 Byte 陣列。

AddJob(String, PrintTicket)

將 XML 紙張規格的新列印工作 (XPS) 檔插入佇列中,並提供指定的名稱和設定。

AddJob(String, String, Boolean)

將 XML 紙張規格的新列印工作 (XPS) Document 插入佇列中、提供指定的名稱,並指定是否應該加以驗證。

AddJob(String, String, Boolean, PrintTicket)

將 XML 紙張規格的新列印工作 (XPS) Document 插入佇列中、提供指定的名稱和設定,並指定是否應該加以驗證。

Commit()

PrintQueue 物件的目前屬性寫入至列印伺服器上的實際列印佇列。

CreateXpsDocumentWriter(Double, Double)

使用指定的維度 (Dimension) 建立 XpsDocumentWriter 物件。

CreateXpsDocumentWriter(PrintDocumentImageableArea)

建立 XpsDocumentWriter 物件,開啟 Windows 通用列印對話方塊,並傳回 ref (Visual Basic 中為 ByRef) 參數,這個參數表示可影像化區域和媒體維度的詳細資訊。

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)

建立 XpsDocumentWriter 物件,開啟 Windows 通用列印對話方塊,在對話方塊中輸入頁面範圍和列印工作的描述,並傳回 ref (Visual Basic 中為 ByRef) 參數,這個參數表示可影像化區域和媒體維度的詳細資訊。

CreateXpsDocumentWriter(PrintQueue)

建立 XpsDocumentWriter 物件,並將它與指定的列印佇列相關聯。

CreateXpsDocumentWriter(String, PrintDocumentImageableArea)

建立 XpsDocumentWriter 物件,開啟 Windows 通用列印對話方塊 (並為其提供工作描述),且傳回 ref (Visual Basic 中為ByRef) 參數,這個參數表示可影像化區域和媒體維度的詳細資訊。

CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)

建立 XpsDocumentWriter 物件,開啟 Windows 通用列印對話方塊,在對話方塊中輸入頁面範圍,並傳回 ref (Visual Basic 中為 ByRef) 參數,這個參數表示可影像化區域和媒體維度的詳細資訊。

Dispose()

釋放 PrintSystemObject 所使用的所有資源。

(繼承來源 PrintSystemObject)
Dispose(Boolean)

釋放 PrintSystemObject 所使用的 Unmanaged 資源,並選擇性地釋放 Managed 資源。

(繼承來源 PrintSystemObject)
Equals(Object)

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
GetHashCode()

做為預設雜湊函式。

(繼承來源 Object)
GetJob(Int32)

取得具有指定 ID 編號的列印工作。

GetPrintCapabilities()

取得 PrintCapabilities 物件,這個物件會識別印表機功能。

GetPrintCapabilities(PrintTicket)

取得 PrintCapabilities 物件,這個物件會識別印表機功能。

GetPrintCapabilitiesAsXml()

取得 MemoryStream 物件,其會以符合列印結構描述的 XML 資料流形式指定印表機的功能。

GetPrintCapabilitiesAsXml(PrintTicket)

取得 MemoryStream 物件,其會以符合列印結構描述的 XML 格式來指定印表機的功能。

GetPrintJobInfoCollection()

針對佇列中的每個工作建立包含 PrintSystemJobInfo 物件的集合。

GetType()

取得目前執行個體的 Type

(繼承來源 Object)
Initialize()

初始化 PrintSystemObject 的屬性。

(繼承來源 PrintSystemObject)
InternalDispose(Boolean)

釋放 PrintQueue 所使用的 Unmanaged 資源,並選擇性地釋放 Managed 資源。

MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
MergeAndValidatePrintTicket(PrintTicket, PrintTicket)

會合併兩個 PrintTicket 並保證得出有效的 PrintTicket,且不會要求印表機不支援的任何列印功能。

MergeAndValidatePrintTicket(PrintTicket, PrintTicket, PrintTicketScope)

合併兩個 PrintTicket 並保證得出有效的 PrintTicket,且不會要求印表機不支援的任何列印功能,並限制在指定的範圍內。

Pause()

暫停列印佇列。 它會保持暫停,直到執行 Resume()

Purge()

移除列印佇列中的所有工作。

Refresh()

使用電腦上執行之印表機和列印佇列公用程式的值,更新 PrintQueue 的屬性。

Resume()

重新啟動已暫停的列印佇列。

ToString()

傳回代表目前物件的字串。

(繼承來源 Object)

適用於

另請參閱