Thumbnail Bar Example

1
/*
2
 *   Copyright © 2017-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.net.Uri
12
import android.os.Bundle
13
import android.view.Menu
14
import android.view.MenuItem
15
import com.pspdfkit.catalog.R
16
import com.pspdfkit.catalog.SdkExample
17
import com.pspdfkit.catalog.tasks.ExtractAssetTask
18
import com.pspdfkit.configuration.activity.PdfActivityConfiguration
19
import com.pspdfkit.configuration.activity.ThumbnailBarMode
20
import com.pspdfkit.ui.PdfActivity
21
import com.pspdfkit.ui.PdfActivityIntentBuilder
22

23
/**
24
 * This example demonstrates different thumbnail bar modes available in the SDK.
25
 * It allows toggling between Floating, Pinned, Scrollable, and None modes via the options menu.
26
 */
27
class ThumbnailBarExample(context: Context) :
28
    SdkExample(
29
        context,
30
        R.string.thumbnailBarExampleTitle,
31
        R.string.thumbnailBarExampleDescription,
32
    ) {
33
    override fun launchExample(context: Context, configuration: PdfActivityConfiguration.Builder) {
34
        // Start with floating thumbnail bar mode (default)
35
        configuration.setThumbnailBarMode(ThumbnailBarMode.THUMBNAIL_BAR_MODE_FLOATING)
36

37
        ExtractAssetTask.extract(WELCOME_DOC, title, context) { documentFile ->
38
            val intent = PdfActivityIntentBuilder.fromUri(context, Uri.fromFile(documentFile))
39
                .configuration(configuration.build())
40
                .activityClass(ThumbnailBarExampleActivity::class)
41
                .build()
42

43
            context.startActivity(intent)
44
        }
45
    }
46
}
47

48
/**
49
 * Activity that demonstrates switching between different thumbnail bar modes.
50
 */
51
class ThumbnailBarExampleActivity : PdfActivity() {
52

53
    private var currentMode = ThumbnailBarMode.THUMBNAIL_BAR_MODE_FLOATING
54

55
    companion object {
56
        private const val KEY_THUMBNAIL_BAR_MODE = "thumbnail_bar_mode"
57
    }
58

59
    override fun onCreateOptionsMenu(menu: Menu): Boolean {
60
        super.onCreateOptionsMenu(menu)
61
        menuInflater.inflate(R.menu.thumbnail_bar_modes_menu, menu)
62
        return true
63
    }
64

65
    override fun onPrepareOptionsMenu(menu: Menu): Boolean {
66
        // Update checked state based on current mode
67
        menu.findItem(R.id.thumbnail_bar_mode_floating)?.isChecked =
68
            currentMode == ThumbnailBarMode.THUMBNAIL_BAR_MODE_FLOATING
69
        menu.findItem(R.id.thumbnail_bar_mode_pinned)?.isChecked =
70
            currentMode == ThumbnailBarMode.THUMBNAIL_BAR_MODE_PINNED
71
        menu.findItem(R.id.thumbnail_bar_mode_scrollable)?.isChecked =
72
            currentMode == ThumbnailBarMode.THUMBNAIL_BAR_MODE_SCROLLABLE
73
        menu.findItem(R.id.thumbnail_bar_mode_none)?.isChecked =
74
            currentMode == ThumbnailBarMode.THUMBNAIL_BAR_MODE_NONE
75
        return super.onPrepareOptionsMenu(menu)
76
    }
77

78
    override fun onSaveInstanceState(outState: Bundle) {
79
        super.onSaveInstanceState(outState)
80
        outState.putString(KEY_THUMBNAIL_BAR_MODE, currentMode.name)
81
    }
82

83
    override fun onRestoreInstanceState(savedInstanceState: Bundle) {
84
        super.onRestoreInstanceState(savedInstanceState)
85
        currentMode = savedInstanceState.getString(KEY_THUMBNAIL_BAR_MODE)
86
            ?.let { ThumbnailBarMode.valueOf(it) }
87
            ?: ThumbnailBarMode.THUMBNAIL_BAR_MODE_FLOATING
88
        pspdfKitViews.thumbnailBarView?.setThumbnailBarMode(currentMode)
89
        invalidateOptionsMenu()
90
    }
91

92
    override fun onOptionsItemSelected(item: MenuItem): Boolean {
93
        val newMode = when (item.itemId) {
94
            R.id.thumbnail_bar_mode_floating -> ThumbnailBarMode.THUMBNAIL_BAR_MODE_FLOATING
95
            R.id.thumbnail_bar_mode_pinned -> ThumbnailBarMode.THUMBNAIL_BAR_MODE_PINNED
96
            R.id.thumbnail_bar_mode_scrollable -> ThumbnailBarMode.THUMBNAIL_BAR_MODE_SCROLLABLE
97
            R.id.thumbnail_bar_mode_none -> ThumbnailBarMode.THUMBNAIL_BAR_MODE_NONE
98
            else -> null
99
        } ?: return super.onOptionsItemSelected(item)
100

101
        currentMode = newMode
102
        pspdfKitViews.thumbnailBarView?.setThumbnailBarMode(newMode)
103
        invalidateOptionsMenu()
104
        return true
105
    }
106
}