Playground Example

1
/*
2
 *   Copyright © 2020-2026 PSPDFKit GmbH. All rights reserved.
3
 *
4
 *   The PSPDFKit Sample applications are licensed with a modified BSD license.
5
 *   Please see License for details. This notice may not be removed from this file.
6
 */
7
package com.pspdfkit.catalog.examples.kotlin
8

9
import android.content.Context
10
import android.content.Intent
11
import android.util.Log
12
import android.view.Menu
13
import android.view.MenuItem
14
import android.widget.Toast
15
import com.pspdfkit.catalog.R
16
import com.pspdfkit.catalog.SdkExample
17
import com.pspdfkit.catalog.SdkExample.Companion.TAG
18
import com.pspdfkit.catalog.ui.DocumentPickerActivity
19
import com.pspdfkit.configuration.activity.PdfActivityConfiguration
20
import com.pspdfkit.document.PdfDocument
21
import com.pspdfkit.ui.PdfActivity
22

23
/**
24
 * Playground example that opens an activity extending the [PdfActivity] class.
25
 */
26
class PlaygroundExample(context: Context) : SdkExample(context, R.string.playgroundExampleTitle, R.string.playgroundExampleDescription) {
27

28
    override fun launchExample(context: Context, configuration: PdfActivityConfiguration.Builder) {
29
        // Launch the picker activity to let users choose between default or custom document.
30
        val intent = Intent(context, PlaygroundExamplePickerActivity::class.java)
31
        intent.putExtra(DocumentPickerActivity.EXTRA_CONFIGURATION, configuration.build())
32
        context.startActivity(intent)
33
    }
34
}
35

36
/**
37
 * Activity that lets the user choose between picking a PDF and using the default document.
38
 */
39
class PlaygroundExamplePickerActivity : DocumentPickerActivity() {
40
    override val targetActivityClass = PlaygroundActivity::class.java
41
}
42

43
/**
44
 * Playground activity that provides an options menu accessible via the overflow menu (the three dots)
45
 * with a customizable button action, see [menuItemClicked]; and a callback when the document is successfully
46
 * loaded, see [onDocumentLoaded].
47
 */
48
class PlaygroundActivity : PdfActivity() {
49

50
    override fun onCreateOptionsMenu(menu: Menu): Boolean {
51
        super.onCreateOptionsMenu(menu)
52
        menu.add(0, CUSTOM_MENU_ITEM_ID, 0, "Custom Menu Item")
53
        return true
54
    }
55

56
    override fun onOptionsItemSelected(item: MenuItem): Boolean {
57
        return if (item.itemId == CUSTOM_MENU_ITEM_ID) {
58
            menuItemClicked()
59
            true
60
        } else {
61
            super.onOptionsItemSelected(item)
62
        }
63
    }
64

65
    override fun onDocumentLoaded(document: PdfDocument) {
66
        super.onDocumentLoaded(document)
67
        Log.d(TAG, "Document loaded.")
68
        // Do your magic here...
69
    }
70

71
    private fun menuItemClicked() {
72
        Toast.makeText(this, "Menu item clicked!", Toast.LENGTH_SHORT).show()
73
    }
74

75
    companion object {
76
        private const val CUSTOM_MENU_ITEM_ID = 1
77
    }
78
}