Custom Main Toolbar with Fragment

1
/*
2
 *   Copyright © 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

8
package com.pspdfkit.catalog.examples.kotlin
9

10
import android.content.Context
11
import android.content.Intent
12
import android.net.Uri
13
import android.os.Bundle
14
import android.view.Menu
15
import android.view.MenuItem
16
import android.widget.Toast
17
import androidx.appcompat.app.AppCompatActivity
18
import com.pspdfkit.catalog.R
19
import com.pspdfkit.catalog.SdkExample
20
import com.pspdfkit.catalog.tasks.ExtractAssetTask
21
import com.pspdfkit.configuration.activity.PdfActivityConfiguration
22
import com.pspdfkit.listeners.OnToolbarMenuChangedListener
23
import com.pspdfkit.ui.PdfUiFragment
24
import com.pspdfkit.ui.PdfUiFragmentBuilder
25
import com.pspdfkit.utils.getSupportParcelableExtra
26

27
/**
28
 * This example shows how to use [PdfUiFragment] inside an [AppCompatActivity] (not
29
 * [com.pspdfkit.ui.PdfActivity]) and customize the main toolbar by adding custom menu options
30
 * using [OnToolbarMenuChangedListener].
31
 */
32
class CustomMainToolbarExample(context: Context) :
33
    SdkExample(
34
        context,
35
        R.string.customMainToolbarExampleTitle,
36
        R.string.customMainToolbarExampleDescription,
37
    ) {
38
    override fun launchExample(context: Context, configuration: PdfActivityConfiguration.Builder) {
39
        ExtractAssetTask.extract(WELCOME_DOC, title, context) { documentFile ->
40
            val intent = Intent(context, CustomMainToolbarActivity::class.java)
41
            intent.putExtra(CustomMainToolbarActivity.EXTRA_URI, Uri.fromFile(documentFile))
42
            intent.putExtra(CustomMainToolbarActivity.EXTRA_CONFIGURATION, configuration.build())
43
            context.startActivity(intent)
44
        }
45
    }
46
}
47

48
/**
49
 * Activity that hosts a [PdfUiFragment] with custom main toolbar options.
50
 * Implements [OnToolbarMenuChangedListener] which is auto-discovered by the fragment in onAttach.
51
 * Extends [AppCompatActivity] instead of [com.pspdfkit.ui.PdfActivity] to demonstrate standalone
52
 * fragment usage.
53
 */
54
class CustomMainToolbarActivity :
55
    AppCompatActivity(),
56
    OnToolbarMenuChangedListener {
57

58
    private var pdfUiFragment: PdfUiFragment? = null
59
    private var optionsExpanded = false
60

61
    override fun onCreate(savedInstanceState: Bundle?) {
62
        super.onCreate(savedInstanceState)
63
        setContentView(R.layout.activity_custom_main_toolbar)
64

65
        if (supportFragmentManager.findFragmentByTag(FRAGMENT_TAG) == null) {
66
            var configuration: PdfActivityConfiguration? =
67
                intent.getSupportParcelableExtra(EXTRA_CONFIGURATION, PdfActivityConfiguration::class.java)
68
            if (configuration == null) {
69
                configuration = PdfActivityConfiguration.Builder(this).build()
70
            }
71

72
            val uri = intent.getSupportParcelableExtra(EXTRA_URI, Uri::class.java)
73

74
            pdfUiFragment = PdfUiFragmentBuilder.fromUri(this, uri)
75
                .configuration(configuration)
76
                .build()
77

78
            supportFragmentManager.beginTransaction()
79
                .add(R.id.fragmentContainer, pdfUiFragment!!, FRAGMENT_TAG)
80
                .commit()
81
        } else {
82
            pdfUiFragment = supportFragmentManager.findFragmentByTag(FRAGMENT_TAG) as PdfUiFragment
83
        }
84
    }
85

86
    override fun onCreateToolbarMenu(menu: Menu) {
87
        if (optionsExpanded) {
88
            menu.add(0, R.id.custom_action_hide, 0, "Hide")
89
                .setShowAsAction(MenuItem.SHOW_AS_ACTION_NEVER)
90
            menu.add(0, R.id.custom_action1, 0, "Option 1")
91
                .setShowAsAction(MenuItem.SHOW_AS_ACTION_NEVER)
92
            menu.add(0, R.id.custom_action2, 0, "Option 2")
93
                .setShowAsAction(MenuItem.SHOW_AS_ACTION_NEVER)
94
            menu.add(0, R.id.custom_action3, 0, "Option 3")
95
                .setShowAsAction(MenuItem.SHOW_AS_ACTION_NEVER)
96
        } else {
97
            menu.add(0, R.id.custom_action_show, 0, "Show")
98
                .setShowAsAction(MenuItem.SHOW_AS_ACTION_NEVER)
99
        }
100
    }
101
    override fun onPrepareToolbarMenu(menu: Menu) {
102
        // No-op: menu item state is set during creation.
103
    }
104

105
    override fun onToolbarMenuItemClick(item: MenuItem): Boolean = when (item.itemId) {
106
        R.id.custom_action_show -> {
107
            optionsExpanded = true
108
            pdfUiFragment?.invalidateMenu()
109
            true
110
        }
111

112
        R.id.custom_action_hide -> {
113
            optionsExpanded = false
114
            pdfUiFragment?.invalidateMenu()
115
            true
116
        }
117

118
        R.id.custom_action1 -> {
119
            Toast.makeText(this, "Option 1 selected", Toast.LENGTH_SHORT).show()
120
            true
121
        }
122

123
        R.id.custom_action2 -> {
124
            Toast.makeText(this, "Option 2 selected", Toast.LENGTH_SHORT).show()
125
            true
126
        }
127

128
        R.id.custom_action3 -> {
129
            Toast.makeText(this, "Option 3 selected", Toast.LENGTH_SHORT).show()
130
            true
131
        }
132

133
        else -> false
134
    }
135

136
    companion object {
137
        const val EXTRA_URI = "CustomMainToolbarActivity.DocumentUri"
138
        const val EXTRA_CONFIGURATION = "CustomMainToolbarActivity.PdfConfiguration"
139
        private const val FRAGMENT_TAG = "customPdfUiFragment"
140
    }
141
}