PrinterDiscoverySession.OnStartPrinterStateTracking(PrinterId) Method

Definition

Callback asking you to start tracking the state of a printer.

[Android.Runtime.Register("onStartPrinterStateTracking", "(Landroid/print/PrinterId;)V", "GetOnStartPrinterStateTracking_Landroid_print_PrinterId_Handler")]
public abstract void OnStartPrinterStateTracking (Android.Print.PrinterId printerId);
[<Android.Runtime.Register("onStartPrinterStateTracking", "(Landroid/print/PrinterId;)V", "GetOnStartPrinterStateTracking_Landroid_print_PrinterId_Handler")>]
abstract member OnStartPrinterStateTracking : Android.Print.PrinterId -> unit

Parameters

printerId
PrinterId

The printer to start tracking.

Attributes

Remarks

Callback asking you to start tracking the state of a printer. Tracking the state means that you should do a best effort to observe the state of this printer and notify the system if that state changes via calling #addPrinters(List).

<strong>Note: </strong> A printer can be initially added without its capabilities to avoid polling printers that the user will not select. However, after this method is called you are expected to update the printer <strong>including</strong> its capabilities. Otherwise, the printer will be ignored.

A scenario when you may be requested to track a printer's state is if the user selects that printer and the system has to present print options UI based on the printer's capabilities. In this case the user should be promptly informed if, for example, the printer becomes unavailable.

Java documentation for android.printservice.PrinterDiscoverySession.onStartPrinterStateTracking(android.print.PrinterId).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to

See also