pspdfkit/com.pspdfkit.ui/DocumentDescriptor

DocumentDescriptor

open class DocumentDescriptor : Parcelable

Describes a document and its UI state. The DocumentDescriptor is used by the 's DocumentCoordinator to handle multiple loaded documents and to manage their state.

Document is represented by the list of parcelable DocumentSources. Descriptor also holds loaded PdfDocument after it's loaded by the DocumentCoordinator. Note that this PdfDocument instance won't be restored after reading from the parcel - it must be loaded again in this case.

Properties

val CREATOR: Parcelable.Creator<DocumentDescriptor>

open val customTitle: String

Custom title that will be displayed in the UI instead of document title.

open var document: PdfDocument

documentSources

val documentSources: List<DocumentSource>

isImageDocument

val isImageDocument: Boolean

open var state: Bundle

Functions

describeContents

open fun describeContents(): Int

fromDataProvider

open fun fromDataProvider(@NonNull dataProvider: DataProvider): DocumentDescriptor

open fun fromDataProvider(@NonNull dataProvider: DataProvider, @Nullable password: String): DocumentDescriptor

open fun fromDataProvider(@NonNull dataProvider: DataProvider, @Nullable password: String, @Nullable contentSignature: String): DocumentDescriptor

Creates descriptor for document loaded from data provider.

fromDataProviders

open fun fromDataProviders(@NonNull dataProviders: List<DataProvider>, @Nullable passwords: List<String>, @Nullable contentSignatures: List<String>): DocumentDescriptor

Creates descriptor for compound document loaded from data providers.

open fun fromDocument(@NonNull document: PdfDocument): DocumentDescriptor

Creates descriptor for loaded document.

fromDocumentSource

open fun fromDocumentSource(@NonNull documentSource: DocumentSource): DocumentDescriptor

Creates descriptor for document loaded from document source.

fromDocumentSources

open fun fromDocumentSources(@NonNull documentSources: List<DocumentSource>): DocumentDescriptor

Creates descriptor for compound document loaded from document sources.

open fun fromUri(@NonNull documentUri: Uri): DocumentDescriptor

open fun fromUri(@NonNull documentUri: Uri, @Nullable password: String): DocumentDescriptor

Creates descriptor for document loaded from URI.

open fun fromUris(@NonNull documentUris: List<Uri>, @Nullable passwords: List<String>, @Nullable contentSignatures: List<String>): DocumentDescriptor

Creates descriptor for compound document loaded from multiple URIs.

getDocumentSource

open fun getDocumentSource(): DocumentSource

Returns source from which the document should be loaded.

open fun getTitle(@NonNull context: Context): String

Returns displayable document title.

open fun getUid(): String

Returns unique document ID.

imageDocumentFromDataProvider

open fun imageDocumentFromDataProvider(@NonNull dataProvider: DataProvider): DocumentDescriptor

Creates descriptor for image document loaded from data provider.

imageDocumentFromDocumentSource

open fun imageDocumentFromDocumentSource(@NonNull documentSource: DocumentSource): DocumentDescriptor

Creates descriptor for image document loaded from a document source.

imageDocumentFromUri

open fun imageDocumentFromUri(@NonNull uri: Uri): DocumentDescriptor

Creates descriptor for image document loaded from URI.

open fun setTitle(@Nullable title: String)

Sets a custom displayable document title.

open fun writeToParcel(@NonNull dest: Parcel, flags: Int)