PrinterInformation.IsPaperJammed Property

Returns true if the printer has a paper jam

[Visual Basic]
Public ReadOnly Property IsPaperJammed As Boolean
[C#]
public bool IsPaperJammed {get;}
[C++]
public: __property bool get_IsPaperJammed();
[JScript]
public function get IsPaperJammed() : boolean;

Property Value

Returns true if the printer has a paper jam, false otherwise

Remarks

The status is not always reliable if there are no jobs queued on the printer

Some printer hardware may not support the full set of statuses

More than one status may be true at once - for example a printer may be in error and have a paper jam

Example

[Visual Basic] The following example prints the status of a job to a trace

[Visual Basic] 
Public Sub TraceStatus(ByVal piIn As PrinterInformation)

        With piIn
            Trace.WriteLine("** Ready? " & .IsReady.ToString)
            Trace.WriteLine("** Manual Feed Required? " & .IsAwaitingManualFeed.ToString)
            Trace.WriteLine("** Default Printer? " & .IsDefault.ToString)
            Trace.WriteLine("** Deleting a job? " & .IsDeletingJob.ToString)
            Trace.WriteLine("** Door open? " & .IsDoorOpen.ToString)
            Trace.WriteLine("** Error? " & .IsInError.ToString)
            Trace.WriteLine("** Initialising? " & .IsInitialising.ToString)
            Trace.WriteLine("** Power save on? " & .IsInPowerSave.ToString)
            Trace.WriteLine("** Local printer? " & .IsLocalPrinter.ToString)
            Trace.WriteLine("** Network printer? " & .IsNetworkPrinter.ToString)
            Trace.WriteLine("** Off line? " & .IsOffline.ToString)
            Trace.WriteLine("** Out of memory? " & .IsOutOfmemory.ToString)
            Trace.WriteLine("** Is out of paper? " & .IsOutOfPaper.ToString)
            Trace.WriteLine("** Toner out? " & .IsOutOfToner.ToString)
            Trace.WriteLine("** Output bin full? " & .IsOutputBinFull.ToString)
            Trace.WriteLine("** Paper Jammed? " & .IsPaperJammed.ToString)
            Trace.WriteLine("** Printing? " & .IsPrinting.ToString)
            Trace.WriteLine("** Shared? " & .IsShared.ToString)
            Trace.WriteLine("** Not available? " & .IsUnavailable.ToString)
            Trace.WriteLine("** Waiting on user? " & .IsWaitingOnUserIntervention.ToString)
            Trace.WriteLine("** Warming up? " & .IsWarmingUp.ToString)
        End With

End Sub

Requirements

Namespace: PrinterQueueWatch

Platforms:  Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows .NET Server family

See Also

PrinterInformation overview , All PrinterInformation members

© 2003 Merrion Computing Ltd. All rights reserved.