Skip to content
Open
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,8 @@
package com.pspdfkit.flutter.pspdfkit

import android.graphics.RectF
import com.pspdfkit.configuration.PdfConfiguration
import com.pspdfkit.configuration.activity.PdfActivityConfiguration
import com.pspdfkit.document.formatters.DocumentJsonFormatter
import com.pspdfkit.document.formatters.XfdfFormatter
import com.pspdfkit.document.processor.PdfProcessor
Expand Down Expand Up @@ -724,4 +726,20 @@ class PspdfkitViewImpl : PspdfkitWidgetControllerApi {
)
}
}

override fun enableAnnotationEditing(
enable: Boolean,
annotationType: AnnotationType?,
toolName: String?
) {
// Create a new PdfActivityConfiguration with the updated annotation editing settings.
PdfActivityConfiguration
pdfUiFragment?.let {
val oldConfig = it.configuration
val newConfig = PdfActivityConfiguration.Builder(oldConfig)
.annotationEditingEnabled(enable)
.build()
it.configuration = newConfig
}
}
}
Copy link
Collaborator Author

@mutumbakato mutumbakato May 30, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Generated by pigeon.

Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
// AND MAY NOT BE RESOLD OR REDISTRIBUTED. USAGE IS BOUND TO THE PSPDFKIT LICENSE AGREEMENT.
// UNAUTHORIZED REPRODUCTION OR DISTRIBUTION IS SUBJECT TO CIVIL AND CRIMINAL PENALTIES.
// This notice may not be removed from this file.
// Autogenerated from Pigeon (v24.2.1), do not edit directly.
// Autogenerated from Pigeon (v24.2.2), do not edit directly.
// See also: https://pub.dev/packages/pigeon
@file:Suppress("UNCHECKED_CAST", "ArrayInDataClass")

Expand Down Expand Up @@ -1635,6 +1635,7 @@ interface PspdfkitWidgetControllerApi {
* exiting annotation creation mode was successful.
*/
fun exitAnnotationCreationMode(callback: (Result<Boolean?>) -> Unit)
fun enableAnnotationEditing(enable: Boolean, annotationType: AnnotationType?, toolName: String?)

companion object {
/** The codec used by PspdfkitWidgetControllerApi. */
Expand Down Expand Up @@ -2040,6 +2041,26 @@ interface PspdfkitWidgetControllerApi {
channel.setMessageHandler(null)
}
}
run {
val channel = BasicMessageChannel<Any?>(binaryMessenger, "dev.flutter.pigeon.pspdfkit_flutter.PspdfkitWidgetControllerApi.enableAnnotationEditing$separatedMessageChannelSuffix", codec)
if (api != null) {
channel.setMessageHandler { message, reply ->
val args = message as List<Any?>
val enableArg = args[0] as Boolean
val annotationTypeArg = args[1] as AnnotationType?
val toolNameArg = args[2] as String?
val wrapped: List<Any?> = try {
api.enableAnnotationEditing(enableArg, annotationTypeArg, toolNameArg)
listOf(null)
} catch (exception: Throwable) {
wrapError(exception)
}
reply.reply(wrapped)
}
} else {
channel.setMessageHandler(null)
}
}
}
}
}
Expand Down
70 changes: 70 additions & 0 deletions example/lib/diable_annotation_edditing_example.dart
Original file line number Diff line number Diff line change
@@ -0,0 +1,70 @@
///
/// Copyright © 2024-2025 PSPDFKit GmbH. All rights reserved.
///
/// THIS SOURCE CODE AND ANY ACCOMPANYING DOCUMENTATION ARE PROTECTED BY INTERNATIONAL COPYRIGHT LAW
/// AND MAY NOT BE RESOLD OR REDISTRIBUTED. USAGE IS BOUND TO THE PSPDFKIT LICENSE AGREEMENT.
/// UNAUTHORIZED REPRODUCTION OR DISTRIBUTION IS SUBJECT TO CIVIL AND CRIMINAL PENALTIES.
/// This notice may not be removed from this file.
///

import 'package:flutter/material.dart';
import 'package:pspdfkit_flutter/pspdfkit.dart';

class DisableAnnotationEditingExample extends StatefulWidget {
final String documentPath;

const DisableAnnotationEditingExample(
{super.key, required this.documentPath});

@override
State<DisableAnnotationEditingExample> createState() =>
_DisableAnnotationEditingExampleState();
}

class _DisableAnnotationEditingExampleState
extends State<DisableAnnotationEditingExample> {
PspdfkitWidgetController? _pspdfkitWidgetController;
var isAnnotationEditingEnabled = true;

@override
Widget build(BuildContext context) {
return Scaffold(
body: SafeArea(
top: false,
bottom: false,
child: Stack(
children: [
PspdfkitWidget(
documentPath: widget.documentPath,
onPspdfkitWidgetCreated: (view) {
_pspdfkitWidgetController = view;
// Disable annotation editing
},
),
Positioned(
bottom: 16,
left: 16,
child: ElevatedButton(
onPressed: () async {
if (_pspdfkitWidgetController != null) {
// Disable annotation editing
await _pspdfkitWidgetController
?.enableAnnotationEditing(
enable: !isAnnotationEditingEnabled);
setState(() {
isAnnotationEditingEnabled =
!isAnnotationEditingEnabled;
});
ScaffoldMessenger.of(context).showSnackBar(
const SnackBar(
content: Text('Annotation editing disabled')),
);
}
},
child: const Text('Disable Annotation Editing'),
),
),
],
)));
}
}
11 changes: 10 additions & 1 deletion example/lib/examples.dart
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ import 'package:flutter/cupertino.dart';
import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:pspdfkit_example/diable_annotation_edditing_example.dart';
import 'package:pspdfkit_example/models/papsdkit_example_item.dart';
import 'package:pspdfkit_example/pspdfkit_toolbar_customization.dart';

Expand Down Expand Up @@ -210,7 +211,15 @@ List<PspdfkitExampleItem> examples(BuildContext context) => [
NutrientAnnotationCreationModeExampleWidget(
documentPath: value.path),
context));
})
}),
PspdfkitExampleItem(
title: 'Disable Annotation Editing',
description: 'Shows how to disable annotation editing.',
onTap: () async {
await extractAsset(context, _documentPath).then((value) => goTo(
DisableAnnotationEditingExample(documentPath: value.path),
context));
}),
];

List<PspdfkitExampleItem> globalExamples(BuildContext context) => [
Expand Down
21 changes: 19 additions & 2 deletions ios/Classes/PspdfkitPlatformViewImpl.swift
Original file line number Diff line number Diff line change
Expand Up @@ -335,8 +335,25 @@ public class PspdfkitPlatformViewImpl: NSObject, PspdfkitWidgetControllerApi, PD
completion(.failure(PspdfkitApiError(code: "error", message: "Error exiting annotation creation mode: \(error.localizedDescription)", details: nil)))
}
}



func enableAnnotationEditing(enable: Bool, annotationType: AnnotationType?, toolName: String?) throws {
guard let pdfViewController = pdfViewController else {
throw PspdfkitApiError(code: "error", message: "PDF view controller is null", details: nil)
}
pdfViewController.updateConfiguration { builder in
if enable {
// Enable all annotation types - set to a comprehensive set of annotation tools
builder.editableAnnotationTypes = [
.ink, .highlight, .strikeOut, .underline, .squiggly, .note, .freeText,
.square, .circle, .line, .polygon, .polyLine, .stamp, .image,
.signature, .eraser, .sound, .redaction
]
} else {
// Disable all annotation editing by setting to nil
builder.editableAnnotationTypes = nil
}
}
}

@objc func spreadIndexDidChange(_ notification: Notification) {
if let newSpreadIndex = notification.userInfo?["PSPDFDocumentViewControllerSpreadIndexKey"] as? Int,
Expand Down
20 changes: 19 additions & 1 deletion ios/Classes/api/PspdfkitApi.g.swift
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Generated by pigeon.

Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
// AND MAY NOT BE RESOLD OR REDISTRIBUTED. USAGE IS BOUND TO THE PSPDFKIT LICENSE AGREEMENT.
// UNAUTHORIZED REPRODUCTION OR DISTRIBUTION IS SUBJECT TO CIVIL AND CRIMINAL PENALTIES.
// This notice may not be removed from this file.
// Autogenerated from Pigeon (v24.2.1), do not edit directly.
// Autogenerated from Pigeon (v24.2.2), do not edit directly.
// See also: https://pub.dev/packages/pigeon

import Foundation
Expand Down Expand Up @@ -1560,6 +1560,7 @@ protocol PspdfkitWidgetControllerApi {
/// Returns a [Future] that completes with a boolean indicating whether
/// exiting annotation creation mode was successful.
func exitAnnotationCreationMode(completion: @escaping (Result<Bool?, Error>) -> Void)
func enableAnnotationEditing(enable: Bool, annotationType: AnnotationType?, toolName: String?) throws
}

/// Generated setup class from Pigeon to handle messages through the `binaryMessenger`.
Expand Down Expand Up @@ -1945,6 +1946,23 @@ class PspdfkitWidgetControllerApiSetup {
} else {
exitAnnotationCreationModeChannel.setMessageHandler(nil)
}
let enableAnnotationEditingChannel = FlutterBasicMessageChannel(name: "dev.flutter.pigeon.pspdfkit_flutter.PspdfkitWidgetControllerApi.enableAnnotationEditing\(channelSuffix)", binaryMessenger: binaryMessenger, codec: codec)
if let api = api {
enableAnnotationEditingChannel.setMessageHandler { message, reply in
let args = message as! [Any?]
let enableArg = args[0] as! Bool
let annotationTypeArg: AnnotationType? = nilOrValue(args[1])
let toolNameArg: String? = nilOrValue(args[2])
do {
try api.enableAnnotationEditing(enable: enableArg, annotationType: annotationTypeArg, toolName: toolNameArg)
reply(wrapResult(nil))
} catch {
reply(wrapError(error))
}
}
} else {
enableAnnotationEditingChannel.setMessageHandler(nil)
}
}
}
/// Generated protocol from Pigeon that represents a handler of messages from Flutter.
Expand Down
33 changes: 30 additions & 3 deletions lib/src/api/pspdfkit_api.g.dart
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Generated by pigeon.

Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
// AND MAY NOT BE RESOLD OR REDISTRIBUTED. USAGE IS BOUND TO THE PSPDFKIT LICENSE AGREEMENT.
// UNAUTHORIZED REPRODUCTION OR DISTRIBUTION IS SUBJECT TO CIVIL AND CRIMINAL PENALTIES.
// This notice may not be removed from this file.
// Autogenerated from Pigeon (v24.2.1), do not edit directly.
// Autogenerated from Pigeon (v24.2.2), do not edit directly.
// See also: https://pub.dev/packages/pigeon
// ignore_for_file: public_member_api_docs, non_constant_identifier_names, avoid_as, unused_import, unnecessary_parenthesis, prefer_null_aware_operators, omit_local_variable_types, unused_shown_name, unnecessary_import, no_leading_underscores_for_local_identifiers

Expand Down Expand Up @@ -2480,6 +2480,33 @@ class PspdfkitWidgetControllerApi {
return (pigeonVar_replyList[0] as bool?);
}
}

Future<void> enableAnnotationEditing(
bool enable, AnnotationType? annotationType, String? toolName) async {
final String pigeonVar_channelName =
'dev.flutter.pigeon.pspdfkit_flutter.PspdfkitWidgetControllerApi.enableAnnotationEditing$pigeonVar_messageChannelSuffix';
final BasicMessageChannel<Object?> pigeonVar_channel =
BasicMessageChannel<Object?>(
pigeonVar_channelName,
pigeonChannelCodec,
binaryMessenger: pigeonVar_binaryMessenger,
);
final Future<Object?> pigeonVar_sendFuture =
pigeonVar_channel.send(<Object?>[enable, annotationType, toolName]);
final List<Object?>? pigeonVar_replyList =
await pigeonVar_sendFuture as List<Object?>?;
if (pigeonVar_replyList == null) {
throw _createConnectionError(pigeonVar_channelName);
} else if (pigeonVar_replyList.length > 1) {
throw PlatformException(
code: pigeonVar_replyList[0]! as String,
message: pigeonVar_replyList[1] as String?,
details: pigeonVar_replyList[2],
);
} else {
return;
}
}
}

class PdfDocumentApi {
Expand Down Expand Up @@ -3147,7 +3174,7 @@ abstract class PspdfkitWidgetCallbacks {
assert(arg_pageIndex != null,
'Argument for dev.flutter.pigeon.pspdfkit_flutter.PspdfkitWidgetCallbacks.onPageClick was null, expected non-null int.');
final PointF? arg_point = (args[2] as PointF?);
final Object? arg_annotation = args[3];
final Object? arg_annotation = (args[3] as Object?);
try {
api.onPageClick(
arg_documentId!, arg_pageIndex!, arg_point, arg_annotation);
Expand Down Expand Up @@ -3223,7 +3250,7 @@ abstract class NutrientEventsCallbacks {
final NutrientEvent? arg_event = (args[0] as NutrientEvent?);
assert(arg_event != null,
'Argument for dev.flutter.pigeon.pspdfkit_flutter.NutrientEventsCallbacks.onEvent was null, expected non-null NutrientEvent.');
final Object? arg_data = args[1];
final Object? arg_data = (args[1] as Object?);
try {
api.onEvent(arg_event!, arg_data);
return wrapResponse(empty: true);
Expand Down
10 changes: 10 additions & 0 deletions lib/src/widgets/pspdfkit_flutter_widget_controller_impl.dart
Original file line number Diff line number Diff line change
Expand Up @@ -291,4 +291,14 @@ class PspdfkitFlutterWidgetControllerImpl
void onDocumentSaved(String documentId, String? path) {
onPdfDocumentSaved?.call(documentId, path);
}

@override
Future<void> enableAnnotationEditing(
{bool enable = true, AnnotationType? annotationType, String? toolName}) {
return _pspdfkitWidgetControllerApi.enableAnnotationEditing(
enable,
annotationType,
toolName,
);
}
}
3 changes: 3 additions & 0 deletions lib/src/widgets/pspdfkit_widget_controller.dart
Original file line number Diff line number Diff line change
Expand Up @@ -115,4 +115,7 @@ abstract class PspdfkitWidgetController {
/// Returns a [Future] that completes with a boolean indicating whether
/// exiting annotation creation mode was successful.
Future<bool?> exitAnnotationCreationMode();

Future<void> enableAnnotationEditing(
{bool enable = true, AnnotationType? annotationType});
}
7 changes: 7 additions & 0 deletions lib/src/widgets/pspdfkit_widget_controller_native.dart
Original file line number Diff line number Diff line change
Expand Up @@ -192,4 +192,11 @@ class PspdfkitWidgetControllerNative extends PspdfkitWidgetController {
throw UnimplementedError(
'Annotation creation mode is not supported in legacy mode');
}

@override
Future<void> enableAnnotationEditing(
{bool enable = true, AnnotationType? annotationType}) {
// TODO: ignore this method in legacy mode.
throw UnimplementedError();
}
}
7 changes: 7 additions & 0 deletions lib/src/widgets/pspdfkit_widget_controller_web.dart
Original file line number Diff line number Diff line change
Expand Up @@ -251,4 +251,11 @@ class PspdfkitWidgetControllerWeb extends PspdfkitWidgetController
Future<double> getZoomScale(int pageIndex) {
return pspdfkitInstance.getZoomScale(pageIndex);
}

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pigeon method definition.

@override
Future<void> enableAnnotationEditing(
{bool enable = true, AnnotationType? annotationType}) {
// TODO: Implement if you use web.
throw UnimplementedError();
}
}
3 changes: 3 additions & 0 deletions pigeons/pspdfkit.dart
Original file line number Diff line number Diff line change
Expand Up @@ -566,6 +566,9 @@ abstract class PspdfkitWidgetControllerApi {
/// exiting annotation creation mode was successful.
@async
bool? exitAnnotationCreationMode();

void enableAnnotationEditing(
bool enable, AnnotationType? annotationType, String? toolName);
}

@HostApi()
Expand Down