HasToner Property
Collapse the table of content
Expand the table of content

PrintQueue.HasToner Property

 

Gets a value that indicates if the printer has toner.

Namespace:   System.Printing
Assembly:  System.Printing (in System.Printing.dll)

Public ReadOnly Property HasToner As Boolean

Property Value

Type: System.Boolean

true if the current printer has toner; otherwise, false.

Some printer manufacturers may use this signal to indicate that toner is not low. Others may use it to indicate that the toner cartridge is present and properly inserted while using IsTonerLow to indicate that toner is low.

If the printer does not support a signal with this meaning, then the property is always false.

The following example shows how to use this property as part of a survey all printers for possible error status.

' Check for possible trouble states of a printer using its properties
Friend Shared Sub SpotTroubleUsingProperties(ByRef statusReport As String, ByVal pq As PrintQueue)
	If pq.HasPaperProblem Then
		statusReport = statusReport & "Has a paper problem. "
	End If
	If Not(pq.HasToner) Then
		statusReport = statusReport & "Is out of toner. "
	End If
	If pq.IsDoorOpened Then
		statusReport = statusReport & "Has an open door. "
	End If
	If pq.IsInError Then
		statusReport = statusReport & "Is in an error state. "
	End If
	If pq.IsNotAvailable Then
		statusReport = statusReport & "Is not available. "
	End If
	If pq.IsOffline Then
		statusReport = statusReport & "Is off line. "
	End If
	If pq.IsOutOfMemory Then
		statusReport = statusReport & "Is out of memory. "
	End If
	If pq.IsOutOfPaper Then
		statusReport = statusReport & "Is out of paper. "
	End If
	If pq.IsOutputBinFull Then
		statusReport = statusReport & "Has a full output bin. "
	End If
	If pq.IsPaperJammed Then
		statusReport = statusReport & "Has a paper jam. "
	End If
	If pq.IsPaused Then
		statusReport = statusReport & "Is paused. "
	End If
	If pq.IsTonerLow Then
		statusReport = statusReport & "Is low on toner. "
	End If
	If pq.NeedUserIntervention Then
		statusReport = statusReport & "Needs user intervention. "
	End If

	' Check if queue is even available at this time of day
	' The following method is defined in the complete example.
	ReportAvailabilityAtThisTime(statusReport, pq)

End Sub 'end SpotTroubleUsingProperties

.NET Framework
Available since 3.0
Return to top
Show:
© 2016 Microsoft