Most visited

Recently visited

Results for

Added in API level 19

PrintService

public abstract class PrintService
extends Service

java.lang.Object
↳	android.content.Context
	↳	android.content.ContextWrapper
		↳	android.app.Service
			↳	android.printservice.PrintService

This is the base class for implementing print services. A print service knows how to discover and interact one or more printers via one or more protocols.

Printer discovery

A print service is responsible for discovering printers, adding discovered printers, removing added printers, and updating added printers. When the system is interested in printers managed by your service it will call onCreatePrinterDiscoverySession() from which you must return a new PrinterDiscoverySession instance. The returned session encapsulates the interaction between the system and your service during printer discovery. For description of this interaction refer to the documentation for PrinterDiscoverySession.

For every printer discovery session all printers have to be added since system does not retain printers across sessions. Hence, each printer known to this print service should be added only once during a discovery session. Only an already added printer can be removed or updated. Removed printers can be added again.

Print jobs

When a new print job targeted to a printer managed by this print service is is queued, i.e. ready for processing by the print service, you will receive a call to onPrintJobQueued(PrintJob). The print service may handle the print job immediately or schedule that for an appropriate time in the future. The list of all active print jobs for this service is obtained by calling getActivePrintJobs(). Active print jobs are ones that are queued or started.

A print service is responsible for setting a print job's state as appropriate while processing it. Initially, a print job is queued, i.e. PrintJob.isQueued() returns true, which means that the document to be printed is spooled by the system and the print service can begin processing it. You can obtain the printed document by calling PrintJob.getDocument() whose data is accessed via PrintDocument.getData(). After the print service starts printing the data it should set the print job's state to started by calling start() after which PrintJob.isStarted() would return true. Upon successful completion, the print job should be marked as completed by calling PrintJob.complete() after which PrintJob.isCompleted() would return true. In case of a failure, the print job should be marked as failed by calling PrintJob.fail( String) after which PrintJob.isFailed() would return true.

If a print job is queued or started and the user requests to cancel it, the print service will receive a call to onRequestCancelPrintJob(PrintJob) which requests from the service to do best effort in canceling the job. In case the job is successfully canceled, its state has to be marked as cancelled by calling PrintJob.cancel() after which PrintJob.isCacnelled() would return true.

Lifecycle

The lifecycle of a print service is managed exclusively by the system and follows the established service lifecycle. Additionally, starting or stopping a print service is triggered exclusively by an explicit user action through enabling or disabling it in the device settings. After the system binds to a print service, it calls onConnected(). This method can be overriden by clients to perform post binding setup. Also after the system unbinds from a print service, it calls onDisconnected(). This method can be overriden by clients to perform post unbinding cleanup. Your should not do any work after the system disconnected from your print service since the service can be killed at any time to reclaim memory. The system will not disconnect from a print service if there are active print jobs for the printers managed by it.

Declaration

A print service is declared as any other service in an AndroidManifest.xml but it must also specify that it handles the Intent with action android.printservice.PrintService. Failure to declare this intent will cause the system to ignore the print service. Additionally, a print service must request the android.permission.BIND_PRINT_SERVICE permission to ensure that only the system can bind to it. Failure to declare this intent will cause the system to ignore the print service. Following is an example declaration:

 <service android:name=".MyPrintService"
         android:permission="android.permission.BIND_PRINT_SERVICE">
     <intent-filter>
         <action android:name="android.printservice.PrintService" />
     </intent-filter>
     . . .
 </service>

Configuration

A print service can be configured by specifying an optional settings activity which exposes service specific settings, an optional add printers activity which is used for manual addition of printers, vendor name ,etc. It is a responsibility of the system to launch the settings and add printers activities when appropriate.

A print service is configured by providing a meta-data entry in the manifest when declaring the service. A service declaration with a meta-data tag is presented below:

 <service android:name=".MyPrintService"
         android:permission="android.permission.BIND_PRINT_SERVICE">
     <intent-filter>
         <action android:name="android.printservice.PrintService" />
     </intent-filter>
     <meta-data android:name="android.printservice" android:resource="@xml/printservice" />
 </service>

For more details for how to configure your print service via the meta-data refer to SERVICE_META_DATA and <print-service>.

Note: All callbacks in this class are executed on the main application thread. You should also invoke any method of this class on the main application thread.

Summary

Constants
`String`	`EXTRA_PRINTER_INFO` If you declared an optional activity with advanced print options via the `advancedPrintOptionsActivity` attribute, this extra is used to pass in the currently selected printer's `PrinterInfo` to your activity allowing you to inspect it.
`String`	`EXTRA_PRINT_DOCUMENT_INFO` If you declared an optional activity with advanced print options via the `advancedPrintOptionsActivity` attribute, this extra is used to pass in the meta-data for the currently printed document as a `PrintDocumentInfo` to your activity allowing you to inspect it.
`String`	`EXTRA_PRINT_JOB_INFO` If you declared an optional activity with advanced print options via the `advancedPrintOptionsActivity` attribute, this extra is used to pass in the currently constructed `PrintJobInfo` to your activity allowing you to modify it.
`String`	`SERVICE_INTERFACE` The `Intent` action that must be declared as handled by a service in its manifest for the system to recognize it as a print service.
`String`	`SERVICE_META_DATA` Name under which a `PrintService` component publishes additional information about itself.

Inherited constants

From class


    android.app.Service

From class


    android.content.Context

From interface


    android.content.ComponentCallbacks2

Public constructors
`PrintService()`

Public methods
`final PrinterId`	`generatePrinterId(String localId)` Generates a global printer id given the printer's locally unique one.
`final List<PrintJob>`	`getActivePrintJobs()` Gets the active print jobs for the printers managed by this service.
`final IBinder`	`onBind(Intent intent)` Return the communication channel to the service.

Protected methods
`final void`	`attachBaseContext(Context base)` Set the base context for this ContextWrapper.
`void`	`onConnected()` The system has connected to this service.
`abstract PrinterDiscoverySession`	`onCreatePrinterDiscoverySession()` Callback asking you to create a new `PrinterDiscoverySession`.
`void`	`onDisconnected()` The system has disconnected from this service.
`abstract void`	`onPrintJobQueued(PrintJob printJob)` Called when there is a queued print job for one of the printers managed by this print service.
`abstract void`	`onRequestCancelPrintJob(PrintJob printJob)` Called when cancellation of a print job is requested.

Inherited methods

From class


  
    android.app.Service

`void`	`dump(FileDescriptor fd, PrintWriter writer, String[] args)` Print the Service's state into the given stream.
`final Application`	`getApplication()` Return the application that owns this service.
`abstract IBinder`	`onBind(Intent intent)` Return the communication channel to the service.
`void`	`onConfigurationChanged(Configuration newConfig)` Called by the system when the device configuration changes while your component is running.
`void`	`onCreate()` Called by the system when the service is first created.
`void`	`onDestroy()` Called by the system to notify a Service that it is no longer used and is being removed.
`void`	`onLowMemory()` This is called when the overall system is running low on memory, and actively running processes should trim their memory usage.
`void`	`onRebind(Intent intent)` Called when new clients have connected to the service, after it had previously been notified that all had disconnected in its `onUnbind(Intent)`.
`void`	`onStart(Intent intent, int startId)` This method was deprecated in API level 5. Implement `onStartCommand(Intent, int, int)` instead.
`int`	`onStartCommand(Intent intent, int flags, int startId)` Called by the system every time a client explicitly starts the service by calling `startService(Intent)`, providing the arguments it supplied and a unique integer token representing the start request.
`void`	`onTaskRemoved(Intent rootIntent)` This is called if the service is currently running and the user has removed a task that comes from the service's application.
`void`	`onTrimMemory(int level)` Called when the operating system has determined that it is a good time for a process to trim unneeded memory from its process.
`boolean`	`onUnbind(Intent intent)` Called when all clients have disconnected from a particular interface published by the service.
`final void`	`startForeground(int id, Notification notification)` Make this service run in the foreground, supplying the ongoing notification to be shown to the user while in this state.
`final void`	`stopForeground(int flags)` Remove this service from foreground state, allowing it to be killed if more memory is needed.
`final void`	`stopForeground(boolean removeNotification)` Synonym for `stopForeground(int)`.
`final void`	`stopSelf()` Stop the service, if it was previously started.
`final void`	`stopSelf(int startId)` Old version of `stopSelfResult(int)` that doesn't return a result.
`final boolean`	`stopSelfResult(int startId)` Stop the service if the most recent time it was started was `startId`.

From class


  
    android.content.ContextWrapper

`void`	`attachBaseContext(Context base)` Set the base context for this ContextWrapper.
`boolean`	`bindService(Intent service, ServiceConnection conn, int flags)` Connect to an application service, creating it if needed.
`int`	`checkCallingOrSelfPermission(String permission)` Determine whether the calling process of an IPC or you have been granted a particular permission.
`int`	`checkCallingOrSelfUriPermission(Uri uri, int modeFlags)` Determine whether the calling process of an IPC or you has been granted permission to access a specific URI.
`int`	`checkCallingPermission(String permission)` Determine whether the calling process of an IPC you are handling has been granted a particular permission.
`int`	`checkCallingUriPermission(Uri uri, int modeFlags)` Determine whether the calling process and user ID has been granted permission to access a specific URI.
`int`	`checkPermission(String permission, int pid, int uid)` Determine whether the given permission is allowed for a particular process and user ID running in the system.
`int`	`checkSelfPermission(String permission)` Determine whether you have been granted a particular permission.
`int`	`checkUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags)` Check both a Uri and normal permission.
`int`	`checkUriPermission(Uri uri, int pid, int uid, int modeFlags)` Determine whether a particular process and user ID has been granted permission to access a specific URI.
`void`	`clearWallpaper()` This method was deprecated in API level 23. Use `WallpaperManager.clear()` instead. This method requires the caller to hold the permission `SET_WALLPAPER`.
`Context`	`createConfigurationContext(Configuration overrideConfiguration)` Return a new Context object for the current Context but whose resources are adjusted to match the given Configuration.
`Context`	`createDeviceProtectedStorageContext()` Return a new Context object for the current Context but whose storage APIs are backed by device-protected storage.
`Context`	`createDisplayContext(Display display)` Return a new Context object for the current Context but whose resources are adjusted to match the metrics of the given Display.
`Context`	`createPackageContext(String packageName, int flags)` Return a new Context object for the given application name.
`String[]`	`databaseList()` Returns an array of strings naming the private databases associated with this Context's application package.
`boolean`	`deleteDatabase(String name)` Delete an existing private SQLiteDatabase associated with this Context's application package.
`boolean`	`deleteFile(String name)` Delete the given private file associated with this Context's application package.
`boolean`	`deleteSharedPreferences(String name)` Delete an existing shared preferences file.
`void`	`enforceCallingOrSelfPermission(String permission, String message)` If neither you nor the calling process of an IPC you are handling has been granted a particular permission, throw a `SecurityException`.
`void`	`enforceCallingOrSelfUriPermission(Uri uri, int modeFlags, String message)` If the calling process of an IPC or you has not been granted permission to access a specific URI, throw `SecurityException`.
`void`	`enforceCallingPermission(String permission, String message)` If the calling process of an IPC you are handling has not been granted a particular permission, throw a `SecurityException`.
`void`	`enforceCallingUriPermission(Uri uri, int modeFlags, String message)` If the calling process and user ID has not been granted permission to access a specific URI, throw `SecurityException`.
`void`	`enforcePermission(String permission, int pid, int uid, String message)` If the given permission is not allowed for a particular process and user ID running in the system, throw a `SecurityException`.
`void`	`enforceUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags, String message)` Enforce both a Uri and normal permission.
`void`	`enforceUriPermission(Uri uri, int pid, int uid, int modeFlags, String message)` If a particular process and user ID has not been granted permission to access a specific URI, throw `SecurityException`.
`String[]`	`fileList()` Returns an array of strings naming the private files associated with this Context's application package.
`Context`	`getApplicationContext()` Return the context of the single, global Application object of the current process.
`ApplicationInfo`	`getApplicationInfo()` Return the full application info for this context's package.
`AssetManager`	`getAssets()` Returns an AssetManager instance for the application's package.
`Context`	`getBaseContext()`
`File`	`getCacheDir()` Returns the absolute path to the application specific cache directory on the filesystem.
`ClassLoader`	`getClassLoader()` Return a class loader you can use to retrieve classes in this package.
`File`	`getCodeCacheDir()` Returns the absolute path to the application specific cache directory on the filesystem designed for storing cached code.
`ContentResolver`	`getContentResolver()` Return a ContentResolver instance for your application's package.
`File`	`getDataDir()` Returns the absolute path to the directory on the filesystem where all private files belonging to this app are stored.
`File`	`getDatabasePath(String name)` Returns the absolute path on the filesystem where a database created with `openOrCreateDatabase(String, int, SQLiteDatabase.CursorFactory)` is stored.
`File`	`getDir(String name, int mode)` Retrieve, creating if needed, a new directory in which the application can place its own custom data files.
`File`	`getExternalCacheDir()` Returns absolute path to application-specific directory on the primary shared/external storage device where the application can place cache files it owns.
`File[]`	`getExternalCacheDirs()` Returns absolute paths to application-specific directories on all shared/external storage devices where the application can place cache files it owns.
`File`	`getExternalFilesDir(String type)` Returns the absolute path to the directory on the primary shared/external storage device where the application can place persistent files it owns.
`File[]`	`getExternalFilesDirs(String type)` Returns absolute paths to application-specific directories on all shared/external storage devices where the application can place persistent files it owns.
`File[]`	`getExternalMediaDirs()` Returns absolute paths to application-specific directories on all shared/external storage devices where the application can place media files.
`File`	`getFileStreamPath(String name)` Returns the absolute path on the filesystem where a file created with `openFileOutput(String, int)` is stored.
`File`	`getFilesDir()` Returns the absolute path to the directory on the filesystem where files created with `openFileOutput(String, int)` are stored.
`Looper`	`getMainLooper()` Return the Looper for the main thread of the current process.
`File`	`getNoBackupFilesDir()` Returns the absolute path to the directory on the filesystem similar to `getFilesDir()`.
`File`	`getObbDir()` Return the primary shared/external storage directory where this application's OBB files (if there are any) can be found.
`File[]`	`getObbDirs()` Returns absolute paths to application-specific directories on all shared/external storage devices where the application's OBB files (if there are any) can be found.
`String`	`getPackageCodePath()` Return the full path to this context's primary Android package.
`PackageManager`	`getPackageManager()` Return PackageManager instance to find global package information.
`String`	`getPackageName()` Return the name of this application's package.
`String`	`getPackageResourcePath()` Return the full path to this context's primary Android package.
`Resources`	`getResources()` Returns a Resources instance for the application's package.
`SharedPreferences`	`getSharedPreferences(String name, int mode)` Retrieve and hold the contents of the preferences file 'name', returning a SharedPreferences through which you can retrieve and modify its values.
`Object`	`getSystemService(String name)` Return the handle to a system-level service by name.
`String`	`getSystemServiceName(Class<?> serviceClass)` Gets the name of the system-level service that is represented by the specified class.
`Resources.Theme`	`getTheme()` Return the Theme object associated with this Context.
`Drawable`	`getWallpaper()` This method was deprecated in API level 23. Use `WallpaperManager.get()` instead.
`int`	`getWallpaperDesiredMinimumHeight()` This method was deprecated in API level 23. Use `WallpaperManager.getDesiredMinimumHeight()` instead.
`int`	`getWallpaperDesiredMinimumWidth()` This method was deprecated in API level 23. Use `WallpaperManager.getDesiredMinimumWidth()` instead.
`void`	`grantUriPermission(String toPackage, Uri uri, int modeFlags)` Grant permission to access a specific Uri to another package, regardless of whether that package has general permission to access the Uri's content provider.
`boolean`	`isDeviceProtectedStorage()` Indicates if the storage APIs of this Context are backed by device-protected storage.
`boolean`	`isRestricted()` Indicates whether this Context is restricted.
`boolean`	`moveDatabaseFrom(Context sourceContext, String name)` Move an existing database file from the given source storage context to this context.
`boolean`	`moveSharedPreferencesFrom(Context sourceContext, String name)` Move an existing shared preferences file from the given source storage context to this context.
`FileInputStream`	`openFileInput(String name)` Open a private file associated with this Context's application package for reading.
`FileOutputStream`	`openFileOutput(String name, int mode)` Open a private file associated with this Context's application package for writing.
`SQLiteDatabase`	`openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory, DatabaseErrorHandler errorHandler)` Open a new private SQLiteDatabase associated with this Context's application package.
`SQLiteDatabase`	`openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory)` Open a new private SQLiteDatabase associated with this Context's application package.
`Drawable`	`peekWallpaper()` This method was deprecated in API level 23. Use `WallpaperManager.peek()` instead.
`Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter)` Register a BroadcastReceiver to be run in the main activity thread.
`Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter, String broadcastPermission, Handler scheduler)` Register to receive intent broadcasts, to run in the context of `scheduler`.
`void`	`removeStickyBroadcast(Intent intent)` This method was deprecated in API level 23. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`void`	`removeStickyBroadcastAsUser(Intent intent, UserHandle user)` This method was deprecated in API level 23. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`void`	`revokeUriPermission(Uri uri, int modeFlags)` Remove all permissions to access a particular content provider Uri that were previously added with `grantUriPermission(String, Uri, int)`.
`void`	`sendBroadcast(Intent intent, String receiverPermission)` Broadcast the given intent to all interested BroadcastReceivers, allowing an optional required permission to be enforced.
`void`	`sendBroadcast(Intent intent)` Broadcast the given intent to all interested BroadcastReceivers.
`void`	`sendBroadcastAsUser(Intent intent, UserHandle user)` Version of `sendBroadcast(Intent)` that allows you to specify the user the broadcast will be sent to.
`void`	`sendBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission)` Version of `sendBroadcast(Intent, String)` that allows you to specify the user the broadcast will be sent to.
`void`	`sendOrderedBroadcast(Intent intent, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` Version of `sendBroadcast(Intent)` that allows you to receive data back from the broadcast.
`void`	`sendOrderedBroadcast(Intent intent, String receiverPermission)` Broadcast the given intent to all interested BroadcastReceivers, delivering them one at a time to allow more preferred receivers to consume the broadcast before it is delivered to less preferred receivers.
`void`	`sendOrderedBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` Version of `sendOrderedBroadcast(Intent, String, BroadcastReceiver, Handler, int, String, Bundle)` that allows you to specify the user the broadcast will be sent to.
`void`	`sendStickyBroadcast(Intent intent)` This method was deprecated in API level 23. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`void`	`sendStickyBroadcastAsUser(Intent intent, UserHandle user)` This method was deprecated in API level 23. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`void`	`sendStickyOrderedBroadcast(Intent intent, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` This method was deprecated in API level 23. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`void`	`sendStickyOrderedBroadcastAsUser(Intent intent, UserHandle user, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` This method was deprecated in API level 23. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`void`	`setTheme(int resid)` Set the base theme for this context.
`void`	`setWallpaper(Bitmap bitmap)` This method was deprecated in API level 23. Use `WallpaperManager.set()` instead. This method requires the caller to hold the permission `SET_WALLPAPER`.
`void`	`setWallpaper(InputStream data)` This method was deprecated in API level 23. Use `WallpaperManager.set()` instead. This method requires the caller to hold the permission `SET_WALLPAPER`.
`void`	`startActivities(Intent[] intents, Bundle options)` Launch multiple new activities.
`void`	`startActivities(Intent[] intents)` Same as `startActivities(Intent[], Bundle)` with no options specified.
`void`	`startActivity(Intent intent)` Same as `startActivity(Intent, Bundle)` with no options specified.
`void`	`startActivity(Intent intent, Bundle options)` Launch a new activity.
`boolean`	`startInstrumentation(ComponentName className, String profileFile, Bundle arguments)` Start executing an `Instrumentation` class.
`void`	`startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags)` Same as `startIntentSender(IntentSender, Intent, int, int, int, Bundle)` with no options specified.
`void`	`startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, Bundle options)` Like `startActivity(Intent, Bundle)`, but taking a IntentSender to start.
`ComponentName`	`startService(Intent service)` Request that a given application service be started.
`boolean`	`stopService(Intent name)` Request that a given application service be stopped.
`void`	`unbindService(ServiceConnection conn)` Disconnect from an application service.
`void`	`unregisterReceiver(BroadcastReceiver receiver)` Unregister a previously registered BroadcastReceiver.

From class


  
    android.content.Context

`abstract boolean`	`bindService(Intent service, ServiceConnection conn, int flags)` Connect to an application service, creating it if needed.
`abstract int`	`checkCallingOrSelfPermission(String permission)` Determine whether the calling process of an IPC or you have been granted a particular permission.
`abstract int`	`checkCallingOrSelfUriPermission(Uri uri, int modeFlags)` Determine whether the calling process of an IPC or you has been granted permission to access a specific URI.
`abstract int`	`checkCallingPermission(String permission)` Determine whether the calling process of an IPC you are handling has been granted a particular permission.
`abstract int`	`checkCallingUriPermission(Uri uri, int modeFlags)` Determine whether the calling process and user ID has been granted permission to access a specific URI.
`abstract int`	`checkPermission(String permission, int pid, int uid)` Determine whether the given permission is allowed for a particular process and user ID running in the system.
`abstract int`	`checkSelfPermission(String permission)` Determine whether you have been granted a particular permission.
`abstract int`	`checkUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags)` Check both a Uri and normal permission.
`abstract int`	`checkUriPermission(Uri uri, int pid, int uid, int modeFlags)` Determine whether a particular process and user ID has been granted permission to access a specific URI.
`abstract void`	`clearWallpaper()` This method was deprecated in API level 5. Use `WallpaperManager.clear()` instead. This method requires the caller to hold the permission `SET_WALLPAPER`.
`abstract Context`	`createConfigurationContext(Configuration overrideConfiguration)` Return a new Context object for the current Context but whose resources are adjusted to match the given Configuration.
`abstract Context`	`createDeviceProtectedStorageContext()` Return a new Context object for the current Context but whose storage APIs are backed by device-protected storage.
`abstract Context`	`createDisplayContext(Display display)` Return a new Context object for the current Context but whose resources are adjusted to match the metrics of the given Display.
`abstract Context`	`createPackageContext(String packageName, int flags)` Return a new Context object for the given application name.
`abstract String[]`	`databaseList()` Returns an array of strings naming the private databases associated with this Context's application package.
`abstract boolean`	`deleteDatabase(String name)` Delete an existing private SQLiteDatabase associated with this Context's application package.
`abstract boolean`	`deleteFile(String name)` Delete the given private file associated with this Context's application package.
`abstract boolean`	`deleteSharedPreferences(String name)` Delete an existing shared preferences file.
`abstract void`	`enforceCallingOrSelfPermission(String permission, String message)` If neither you nor the calling process of an IPC you are handling has been granted a particular permission, throw a `SecurityException`.
`abstract void`	`enforceCallingOrSelfUriPermission(Uri uri, int modeFlags, String message)` If the calling process of an IPC or you has not been granted permission to access a specific URI, throw `SecurityException`.
`abstract void`	`enforceCallingPermission(String permission, String message)` If the calling process of an IPC you are handling has not been granted a particular permission, throw a `SecurityException`.
`abstract void`	`enforceCallingUriPermission(Uri uri, int modeFlags, String message)` If the calling process and user ID has not been granted permission to access a specific URI, throw `SecurityException`.
`abstract void`	`enforcePermission(String permission, int pid, int uid, String message)` If the given permission is not allowed for a particular process and user ID running in the system, throw a `SecurityException`.
`abstract void`	`enforceUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags, String message)` Enforce both a Uri and normal permission.
`abstract void`	`enforceUriPermission(Uri uri, int pid, int uid, int modeFlags, String message)` If a particular process and user ID has not been granted permission to access a specific URI, throw `SecurityException`.
`abstract String[]`	`fileList()` Returns an array of strings naming the private files associated with this Context's application package.
`abstract Context`	`getApplicationContext()` Return the context of the single, global Application object of the current process.
`abstract ApplicationInfo`	`getApplicationInfo()` Return the full application info for this context's package.
`abstract AssetManager`	`getAssets()` Returns an AssetManager instance for the application's package.
`abstract File`	`getCacheDir()` Returns the absolute path to the application specific cache directory on the filesystem.
`abstract ClassLoader`	`getClassLoader()` Return a class loader you can use to retrieve classes in this package.
`abstract File`	`getCodeCacheDir()` Returns the absolute path to the application specific cache directory on the filesystem designed for storing cached code.
`final int`	`getColor(int id)` Returns a color associated with a particular resource ID and styled for the current theme.
`final ColorStateList`	`getColorStateList(int id)` Returns a color state list associated with a particular resource ID and styled for the current theme.
`abstract ContentResolver`	`getContentResolver()` Return a ContentResolver instance for your application's package.
`abstract File`	`getDataDir()` Returns the absolute path to the directory on the filesystem where all private files belonging to this app are stored.
`abstract File`	`getDatabasePath(String name)` Returns the absolute path on the filesystem where a database created with `openOrCreateDatabase(String, int, SQLiteDatabase.CursorFactory)` is stored.
`abstract File`	`getDir(String name, int mode)` Retrieve, creating if needed, a new directory in which the application can place its own custom data files.
`final Drawable`	`getDrawable(int id)` Returns a drawable object associated with a particular resource ID and styled for the current theme.
`abstract File`	`getExternalCacheDir()` Returns absolute path to application-specific directory on the primary shared/external storage device where the application can place cache files it owns.
`abstract File[]`	`getExternalCacheDirs()` Returns absolute paths to application-specific directories on all shared/external storage devices where the application can place cache files it owns.
`abstract File`	`getExternalFilesDir(String type)` Returns the absolute path to the directory on the primary shared/external storage device where the application can place persistent files it owns.
`abstract File[]`	`getExternalFilesDirs(String type)` Returns absolute paths to application-specific directories on all shared/external storage devices where the application can place persistent files it owns.
`abstract File[]`	`getExternalMediaDirs()` Returns absolute paths to application-specific directories on all shared/external storage devices where the application can place media files.
`abstract File`	`getFileStreamPath(String name)` Returns the absolute path on the filesystem where a file created with `openFileOutput(String, int)` is stored.
`abstract File`	`getFilesDir()` Returns the absolute path to the directory on the filesystem where files created with `openFileOutput(String, int)` are stored.
`abstract Looper`	`getMainLooper()` Return the Looper for the main thread of the current process.
`abstract File`	`getNoBackupFilesDir()` Returns the absolute path to the directory on the filesystem similar to `getFilesDir()`.
`abstract File`	`getObbDir()` Return the primary shared/external storage directory where this application's OBB files (if there are any) can be found.
`abstract File[]`	`getObbDirs()` Returns absolute paths to application-specific directories on all shared/external storage devices where the application's OBB files (if there are any) can be found.
`abstract String`	`getPackageCodePath()` Return the full path to this context's primary Android package.
`abstract PackageManager`	`getPackageManager()` Return PackageManager instance to find global package information.
`abstract String`	`getPackageName()` Return the name of this application's package.
`abstract String`	`getPackageResourcePath()` Return the full path to this context's primary Android package.
`abstract Resources`	`getResources()` Returns a Resources instance for the application's package.
`abstract SharedPreferences`	`getSharedPreferences(String name, int mode)` Retrieve and hold the contents of the preferences file 'name', returning a SharedPreferences through which you can retrieve and modify its values.
`final String`	`getString(int resId, Object... formatArgs)` Returns a localized formatted string from the application's package's default string table, substituting the format arguments as defined in `Formatter` and `format(String, Object...)`.
`final String`	`getString(int resId)` Returns a localized string from the application's package's default string table.
`final <T> T`	`getSystemService(Class<T> serviceClass)` Return the handle to a system-level service by class.
`abstract Object`	`getSystemService(String name)` Return the handle to a system-level service by name.
`abstract String`	`getSystemServiceName(Class<?> serviceClass)` Gets the name of the system-level service that is represented by the specified class.
`final CharSequence`	`getText(int resId)` Return a localized, styled CharSequence from the application's package's default string table.
`abstract Resources.Theme`	`getTheme()` Return the Theme object associated with this Context.
`abstract Drawable`	`getWallpaper()` This method was deprecated in API level 5. Use `WallpaperManager.get()` instead.
`abstract int`	`getWallpaperDesiredMinimumHeight()` This method was deprecated in API level 5. Use `WallpaperManager.getDesiredMinimumHeight()` instead.
`abstract int`	`getWallpaperDesiredMinimumWidth()` This method was deprecated in API level 5. Use `WallpaperManager.getDesiredMinimumWidth()` instead.
`abstract void`	`grantUriPermission(String toPackage, Uri uri, int modeFlags)` Grant permission to access a specific Uri to another package, regardless of whether that package has general permission to access the Uri's content provider.
`abstract boolean`	`isDeviceProtectedStorage()` Indicates if the storage APIs of this Context are backed by device-protected storage.
`boolean`	`isRestricted()` Indicates whether this Context is restricted.
`abstract boolean`	`moveDatabaseFrom(Context sourceContext, String name)` Move an existing database file from the given source storage context to this context.
`abstract boolean`	`moveSharedPreferencesFrom(Context sourceContext, String name)` Move an existing shared preferences file from the given source storage context to this context.
`final TypedArray`	`obtainStyledAttributes(AttributeSet set, int[] attrs)` Retrieve styled attribute information in this Context's theme.
`final TypedArray`	`obtainStyledAttributes(AttributeSet set, int[] attrs, int defStyleAttr, int defStyleRes)` Retrieve styled attribute information in this Context's theme.
`final TypedArray`	`obtainStyledAttributes(int resid, int[] attrs)` Retrieve styled attribute information in this Context's theme.
`final TypedArray`	`obtainStyledAttributes(int[] attrs)` Retrieve styled attribute information in this Context's theme.
`abstract FileInputStream`	`openFileInput(String name)` Open a private file associated with this Context's application package for reading.
`abstract FileOutputStream`	`openFileOutput(String name, int mode)` Open a private file associated with this Context's application package for writing.
`abstract SQLiteDatabase`	`openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory, DatabaseErrorHandler errorHandler)` Open a new private SQLiteDatabase associated with this Context's application package.
`abstract SQLiteDatabase`	`openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory)` Open a new private SQLiteDatabase associated with this Context's application package.
`abstract Drawable`	`peekWallpaper()` This method was deprecated in API level 5. Use `WallpaperManager.peek()` instead.
`void`	`registerComponentCallbacks(ComponentCallbacks callback)` Add a new `ComponentCallbacks` to the base application of the Context, which will be called at the same times as the ComponentCallbacks methods of activities and other components are called.
`abstract Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter)` Register a BroadcastReceiver to be run in the main activity thread.
`abstract Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter, String broadcastPermission, Handler scheduler)` Register to receive intent broadcasts, to run in the context of `scheduler`.
`abstract void`	`removeStickyBroadcast(Intent intent)` This method was deprecated in API level 21. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`abstract void`	`removeStickyBroadcastAsUser(Intent intent, UserHandle user)` This method was deprecated in API level 21. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`abstract void`	`revokeUriPermission(Uri uri, int modeFlags)` Remove all permissions to access a particular content provider Uri that were previously added with `grantUriPermission(String, Uri, int)`.
`abstract void`	`sendBroadcast(Intent intent, String receiverPermission)` Broadcast the given intent to all interested BroadcastReceivers, allowing an optional required permission to be enforced.
`abstract void`	`sendBroadcast(Intent intent)` Broadcast the given intent to all interested BroadcastReceivers.
`abstract void`	`sendBroadcastAsUser(Intent intent, UserHandle user)` Version of `sendBroadcast(Intent)` that allows you to specify the user the broadcast will be sent to.
`abstract void`	`sendBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission)` Version of `sendBroadcast(Intent, String)` that allows you to specify the user the broadcast will be sent to.
`abstract void`	`sendOrderedBroadcast(Intent intent, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` Version of `sendBroadcast(Intent)` that allows you to receive data back from the broadcast.
`abstract void`	`sendOrderedBroadcast(Intent intent, String receiverPermission)` Broadcast the given intent to all interested BroadcastReceivers, delivering them one at a time to allow more preferred receivers to consume the broadcast before it is delivered to less preferred receivers.
`abstract void`	`sendOrderedBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` Version of `sendOrderedBroadcast(Intent, String, BroadcastReceiver, Handler, int, String, Bundle)` that allows you to specify the user the broadcast will be sent to.
`abstract void`	`sendStickyBroadcast(Intent intent)` This method was deprecated in API level 21. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`abstract void`	`sendStickyBroadcastAsUser(Intent intent, UserHandle user)` This method was deprecated in API level 21. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`abstract void`	`sendStickyOrderedBroadcast(Intent intent, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` This method was deprecated in API level 21. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`abstract void`	`sendStickyOrderedBroadcastAsUser(Intent intent, UserHandle user, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` This method was deprecated in API level 21. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`abstract void`	`setTheme(int resid)` Set the base theme for this context.
`abstract void`	`setWallpaper(Bitmap bitmap)` This method was deprecated in API level 5. Use `WallpaperManager.set()` instead. This method requires the caller to hold the permission `SET_WALLPAPER`.
`abstract void`	`setWallpaper(InputStream data)` This method was deprecated in API level 5. Use `WallpaperManager.set()` instead. This method requires the caller to hold the permission `SET_WALLPAPER`.
`abstract void`	`startActivities(Intent[] intents, Bundle options)` Launch multiple new activities.
`abstract void`	`startActivities(Intent[] intents)` Same as `startActivities(Intent[], Bundle)` with no options specified.
`abstract void`	`startActivity(Intent intent)` Same as `startActivity(Intent, Bundle)` with no options specified.
`abstract void`	`startActivity(Intent intent, Bundle options)` Launch a new activity.
`abstract boolean`	`startInstrumentation(ComponentName className, String profileFile, Bundle arguments)` Start executing an `Instrumentation` class.
`abstract void`	`startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags)` Same as `startIntentSender(IntentSender, Intent, int, int, int, Bundle)` with no options specified.
`abstract void`	`startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, Bundle options)` Like `startActivity(Intent, Bundle)`, but taking a IntentSender to start.
`abstract ComponentName`	`startService(Intent service)` Request that a given application service be started.
`abstract boolean`	`stopService(Intent service)` Request that a given application service be stopped.
`abstract void`	`unbindService(ServiceConnection conn)` Disconnect from an application service.
`void`	`unregisterComponentCallbacks(ComponentCallbacks callback)` Remove a `ComponentCallbacks` object that was previously registered with `registerComponentCallbacks(ComponentCallbacks)`.
`abstract void`	`unregisterReceiver(BroadcastReceiver receiver)` Unregister a previously registered BroadcastReceiver.

From class


  
    java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long millis, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void`	`wait(long millis)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void`	`wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

From interface


  
    android.content.ComponentCallbacks2

From interface


  
    android.content.ComponentCallbacks

Constants

EXTRA_PRINTER_INFO

Added in API level 21

String EXTRA_PRINTER_INFO

If you declared an optional activity with advanced print options via the advancedPrintOptionsActivity attribute, this extra is used to pass in the currently selected printer's PrinterInfo to your activity allowing you to inspect it.

See also:

EXTRA_PRINT_JOB_INFO

Constant Value: "android.intent.extra.print.EXTRA_PRINTER_INFO"

EXTRA_PRINT_DOCUMENT_INFO

Added in API level 23

String EXTRA_PRINT_DOCUMENT_INFO

If you declared an optional activity with advanced print options via the advancedPrintOptionsActivity attribute, this extra is used to pass in the meta-data for the currently printed document as a PrintDocumentInfo to your activity allowing you to inspect it.

See also:

Constant Value: "android.printservice.extra.PRINT_DOCUMENT_INFO"

EXTRA_PRINT_JOB_INFO

Added in API level 19

String EXTRA_PRINT_JOB_INFO

If you declared an optional activity with advanced print options via the advancedPrintOptionsActivity attribute, this extra is used to pass in the currently constructed PrintJobInfo to your activity allowing you to modify it. After you are done, you must return the modified PrintJobInfo via the same extra.

You cannot modify the passed in PrintJobInfo directly, rather you should build another one using the PrintJobInfo.Builder class. You can specify any standard properties and add advanced, printer specific, ones via PrintJobInfo.Builder.putAdvancedOption(String, String) and PrintJobInfo.Builder.putAdvancedOption(String, int). The advanced options are not interpreted by the system, they will not be visible to applications, and can only be accessed by your print service via PrintJob.getAdvancedStringOption(String) and PrintJob.getAdvancedIntOption(String).

If the advanced print options activity offers changes to the standard print options, you can get the current PrinterInfo using the EXTRA_PRINTER_INFO extra which will allow you to present the user with UI options supported by the current printer. For example, if the current printer does not support a given media size, you should not offer it in the advanced print options UI.

See also:

EXTRA_PRINTER_INFO

Constant Value: "android.intent.extra.print.PRINT_JOB_INFO"

SERVICE_INTERFACE

Added in API level 19

String SERVICE_INTERFACE

The Intent action that must be declared as handled by a service in its manifest for the system to recognize it as a print service.

Constant Value: "android.printservice.PrintService"

SERVICE_META_DATA

Added in API level 19

String SERVICE_META_DATA

Name under which a PrintService component publishes additional information about itself. This meta-data must reference a XML resource containing a <print-service> tag. This is a sample XML file configuring a print service:

 <print-service
     android:vendor="SomeVendor"
     android:settingsActivity="foo.bar.MySettingsActivity"
     andorid:addPrintersActivity="foo.bar.MyAddPrintersActivity."
     . . .
 />

For detailed configuration options that can be specified via the meta-data refer to android.R.styleable.PrintService.

If you declare a settings or add a printers activity, they have to be exported, by setting the exported activity attribute to true. Also in case you want only the system to be able to start any of these activities you can specify that they request the android.permission .START_PRINT_SERVICE_CONFIG_ACTIVITY permission by setting the permission activity attribute.

Constant Value: "android.printservice"

Public constructors

PrintService

Added in API level 19

PrintService ()

Public methods

generatePrinterId

Added in API level 19

PrinterId generatePrinterId (String localId)

Generates a global printer id given the printer's locally unique one.

Parameters
`localId`	`String`: A locally unique id in the context of your print service.

Returns
`PrinterId`	Global printer id.

getActivePrintJobs

Added in API level 19

List<PrintJob> getActivePrintJobs ()

Gets the active print jobs for the printers managed by this service. Active print jobs are ones that are not in a final state, i.e. whose state is queued or started.

Returns
`List<PrintJob>`	The active print jobs.

See also:

onBind

Added in API level 19

IBinder onBind (Intent intent)

Return the communication channel to the service. May return null if clients can not bind to the service. The returned IBinder is usually for a complex interface that has been described using aidl.

Note that unlike other application components, calls on to the IBinder interface returned here may not happen on the main thread of the process. More information about the main thread can be found in Processes and Threads.

Parameters
`intent`	`Intent`: The Intent that was used to bind to this service, as given to `Context.bindService`. Note that any extras that were included with the Intent at that point will not be seen here.

Returns
`IBinder`	Return an IBinder through which clients can call on to the service.

Protected methods

attachBaseContext

Added in API level 19

void attachBaseContext (Context base)

Set the base context for this ContextWrapper. All calls will then be delegated to the base context. Throws IllegalStateException if a base context has already been set.

Parameters
`base`	`Context`: The new base context for this wrapper.

onConnected

Added in API level 19

void onConnected ()

The system has connected to this service.

onCreatePrinterDiscoverySession

Added in API level 19

PrinterDiscoverySession onCreatePrinterDiscoverySession ()

Callback asking you to create a new PrinterDiscoverySession.

Returns
`PrinterDiscoverySession`	The created session.

See also:

PrinterDiscoverySession

onDisconnected

Added in API level 19

void onDisconnected ()

The system has disconnected from this service.

onPrintJobQueued

Added in API level 19

void onPrintJobQueued (PrintJob printJob)

Called when there is a queued print job for one of the printers managed by this print service.

Parameters
`printJob`	`PrintJob`: The new queued print job.

See also:

onRequestCancelPrintJob

Added in API level 19

void onRequestCancelPrintJob (PrintJob printJob)

Called when cancellation of a print job is requested. The service should do best effort to fulfill the request. After the cancellation is performed, the print job should be marked as cancelled state by calling cancel().

Parameters
`printJob`	`PrintJob`: The print job to cancel.

See also: