PrinterInformation.IsUnavailable Property

Returns true if the printer is not available

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

Property Value

Returns true if the printer is not available, 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-2005 Merrion Computing Ltd. All rights reserved.