Playground

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 com.pspdfkit.catalog.R
15
import com.pspdfkit.catalog.SdkExample
16
import com.pspdfkit.catalog.SdkExample.Companion.TAG
17
import com.pspdfkit.catalog.ui.DocumentPickerActivity
18
import com.pspdfkit.configuration.activity.PdfActivityConfiguration
19
import com.pspdfkit.document.PdfDocument
20
import com.pspdfkit.ui.PdfActivity
21

22
/**
23
 * Playground example that opens an activity extending the [PdfActivity] class.
24
 */
25
class PlaygroundExample(context: Context) : SdkExample(context, R.string.playgroundExampleTitle, R.string.playgroundExampleDescription) {
26
    override fun launchExample(context: Context, configuration: PdfActivityConfiguration.Builder) {
27
        // Launch the picker activity to let users choose between default or custom document.
28
        val intent = Intent(context, PlaygroundExamplePickerActivity::class.java)
29
        intent.putExtra(DocumentPickerActivity.EXTRA_CONFIGURATION, configuration.build())
30
        context.startActivity(intent)
31
    }
32
}
33

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

41
/**
42
 * Playground activity that provides an options menu accessible via the overflow menu (the three dots)
43
 * with a customizable button action, see [menuItemClicked]; and a callback when the document is successfully
44
 * loaded, see [onDocumentLoaded].
45
 */
46
class PlaygroundActivity : PdfActivity() {
47
    override fun onCreateOptionsMenu(menu: Menu): Boolean {
48
        super.onCreateOptionsMenu(menu)
49
        menu.add(0, CUSTOM_MENU_ITEM_ID, 0, "Custom Menu Item")
50
        menu.add(0, FREEZE_UI_MENU_ITEM_ID, 0, "Freeze UI thread (15s)")
51
        return true
52
    }
53

54
    override fun onOptionsItemSelected(item: MenuItem): Boolean = when (item.itemId) {
55
        CUSTOM_MENU_ITEM_ID -> {
56
            menuItemClicked()
57
            true
58
        }
59

60
        FREEZE_UI_MENU_ITEM_ID -> {
61
            freezeUiThread()
62
            true
63
        }
64

65
        else -> super.onOptionsItemSelected(item)
66
    }
67

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

74
    private fun menuItemClicked() {
75
        Log.d(TAG, "Menu item clicked.")
76
    }
77

78
    private fun freezeUiThread() {
79
        Log.d(TAG, "Freezing UI thread for 15s — watch logcat for tag \"FreezeDetector\".")
80
        Thread.sleep(15_000)
81
    }
82

83
    companion object {
84
        private const val CUSTOM_MENU_ITEM_ID = 1
85
        private const val FREEZE_UI_MENU_ITEM_ID = 2
86
    }
87
}