You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@pdfbox.apache.org by ti...@apache.org on 2016/11/24 16:38:29 UTC
svn commit: r1771183 -
/pdfbox/trunk/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/encryption/AccessPermission.java
Author: tilman
Date: Thu Nov 24 16:38:29 2016
New Revision: 1771183
URL: http://svn.apache.org/viewvc?rev=1771183&view=rev
Log:
PDFBOX-3590: improve javadoc
Modified:
pdfbox/trunk/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/encryption/AccessPermission.java
Modified: pdfbox/trunk/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/encryption/AccessPermission.java
URL: http://svn.apache.org/viewvc/pdfbox/trunk/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/encryption/AccessPermission.java?rev=1771183&r1=1771182&r2=1771183&view=diff
==============================================================================
--- pdfbox/trunk/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/encryption/AccessPermission.java (original)
+++ pdfbox/trunk/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/encryption/AccessPermission.java Thu Nov 24 16:38:29 2016
@@ -209,7 +209,8 @@ public class AccessPermission
/**
* Set if the user can print.
- * This method will have no effect if the object is in read only mode
+ * <p>
+ * This method will have no effect if the object is in read only mode.
*
* @param allowPrinting A boolean determining if the user can print.
*/
@@ -233,7 +234,8 @@ public class AccessPermission
/**
* Set if the user can modify the document.
- * This method will have no effect if the object is in read only mode
+ * <p>
+ * This method will have no effect if the object is in read only mode.
*
* @param allowModifications A boolean determining if the user can modify the document.
*/
@@ -258,7 +260,8 @@ public class AccessPermission
/**
* Set if the user can extract content from the document.
- * This method will have no effect if the object is in read only mode
+ * <p>
+ * This method will have no effect if the object is in read only mode.
*
* @param allowExtraction A boolean determining if the user can extract content
* from the document.
@@ -272,7 +275,11 @@ public class AccessPermission
}
/**
- * This will tell if the user can add/modify text annotations, fill in interactive forms fields.
+ * This will tell if the user can add or modify text annotations and fill in interactive forms
+ * fields and, if {@link #canModify() canModify()} returns true, create or modify interactive
+ * form fields (including signature fields). Note that if
+ * {@link #canFillInForm() canFillInForm()} returns true, it is still possible to fill in
+ * interactive forms (including signature fields) even if this method here returns false.
*
* @return true If supplied with the user password they are allowed to modify annotations.
*/
@@ -282,10 +289,15 @@ public class AccessPermission
}
/**
- * Set if the user can modify annotations.
- * This method will have no effect if the object is in read only mode
+ * Set if the user can add or modify text annotations and fill in interactive forms fields and,
+ * if {@link #canModify() canModify()} returns true, create or modify interactive form fields
+ * (including signature fields). Note that if {@link #canFillInForm() canFillInForm()} returns
+ * true, it is still possible to fill in interactive forms (including signature fields) even the
+ * parameter here is false.
+ * <p>
+ * This method will have no effect if the object is in read only mode.
*
- * @param allowAnnotationModification A boolean determining if the user can modify annotations.
+ * @param allowAnnotationModification A boolean determining the new setting.
*/
public void setCanModifyAnnotations( boolean allowAnnotationModification )
{
@@ -296,7 +308,8 @@ public class AccessPermission
}
/**
- * This will tell if the user can fill in interactive forms.
+ * This will tell if the user can fill in interactive form fields (including signature fields)
+ * even if {@link #canModifyAnnotations() canModifyAnnotations()} returns false.
*
* @return true If supplied with the user password they are allowed to fill in form fields.
*/
@@ -306,8 +319,12 @@ public class AccessPermission
}
/**
- * Set if the user can fill in interactive forms.
- * This method will have no effect if the object is in read only mode
+ * Set if the user can fill in interactive form fields (including signature fields) even if
+ * {@link #canModifyAnnotations() canModifyAnnotations()} returns false. Therefore, if you want
+ * to prevent a user from filling in interactive form fields, you need to call
+ * {@link #setCanModifyAnnotations(boolean) setCanModifyAnnotations(false)} as well.
+ *<p>
+ * This method will have no effect if the object is in read only mode.
*
* @param allowFillingInForm A boolean determining if the user can fill in interactive forms.
*/
@@ -333,7 +350,8 @@ public class AccessPermission
/**
* Set if the user can extract content from the document for accessibility purposes.
- * This method will have no effect if the object is in read only mode
+ * <p>
+ * This method will have no effect if the object is in read only mode.
*
* @param allowExtraction A boolean determining if the user can extract content
* from the document.
@@ -359,7 +377,8 @@ public class AccessPermission
/**
* Set if the user can insert/rotate/delete pages.
- * This method will have no effect if the object is in read only mode
+ * <p>
+ * This method will have no effect if the object is in read only mode.
*
* @param allowAssembly A boolean determining if the user can assemble the document.
*/
@@ -384,7 +403,8 @@ public class AccessPermission
/**
* Set if the user can print the document in a degraded format.
- * This method will have no effect if the object is in read only mode
+ * <p>
+ * This method will have no effect if the object is in read only mode.
*
* @param allowAssembly A boolean determining if the user can print the
* document in a degraded format.