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.os.Bundle
12
import android.util.Log
13
import com.pspdfkit.catalog.R
14
import com.pspdfkit.catalog.SdkExample
15
import com.pspdfkit.catalog.SdkExample.Companion.TAG
16
import com.pspdfkit.catalog.ui.DocumentPickerActivity
17
import com.pspdfkit.compose.toolbar.state.ToolbarItem
18
import com.pspdfkit.compose.toolbar.state.ToolbarItem.ItemEdge
19
import com.pspdfkit.compose.toolbar.state.ToolbarItem.OverflowBehavior
20
import com.pspdfkit.configuration.activity.PdfActivityConfiguration
21
import com.pspdfkit.document.PdfDocument
22
import com.pspdfkit.ui.PdfActivity
23

24
/**
25
 * Playground example that opens an activity extending the [PdfActivity] class.
26
 */
27
class PlaygroundExample(context: Context) : SdkExample(context, R.string.playgroundExampleTitle, R.string.playgroundExampleDescription) {
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
    override fun onCreate(savedInstanceState: Bundle?) {
50
        super.onCreate(savedInstanceState)
51
        setToolbarItemsProvider { defaultItems ->
52
            defaultItems + ToolbarItem.Button(
53
                id = CUSTOM_MENU_ITEM_ID,
54
                actionId = "custom_menu_item",
55
                contentDescription = "Custom Menu Item",
56
                position = ItemEdge.End,
57
                overflowBehavior = OverflowBehavior.Never,
58
            )
59
        }
60
        setOnToolbarItemClickListener { itemId ->
61
            when (itemId) {
62
                CUSTOM_MENU_ITEM_ID -> {
63
                    menuItemClicked()
64
                    true
65
                }
66

67
                else -> false
68
            }
69
        }
70
    }
71

72
    override fun onDocumentLoaded(document: PdfDocument) {
73
        super.onDocumentLoaded(document)
74
        Log.d(TAG, "Document loaded.")
75
        // Do your magic here...
76
    }
77

78
    private fun menuItemClicked() {
79
        Log.d(TAG, "Menu item clicked.")
80
    }
81

82
    companion object {
83
        private const val CUSTOM_MENU_ITEM_ID = 1
84
    }
85
}