Platforms to show: All Mac Windows Linux Cross-Platform

Next items

PDFAnnotationMBS.Action as PDFActionMBS
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 21.1 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: Optional action performed when a user clicks / taps an annotation.
Notes:
PDF readers ignore actions except for those associated with Link or button Widget annotations.

Available in macOS 10.5 or newer
(Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.alignment as Integer
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 21.1 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: Alignment of text within annotation bounds. Supported: NSLeftTextAlignment, NSRightTextAlignment and NSCenterTextAlignment.
Notes:
Used by annotations type(s): /FreeText, /Widget (field type(s): /Tx).
(Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.allowsToggleToOff as Boolean
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 21.1 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: For radio buttons, indicates whether clicking on widget whose state is already On toggles it Off.
Notes:
Used by annotations type(s): /Widget (field type(s): /Btn).
(Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.annotationKeyValues as Dictionary
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 21.1 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: List all key-value pairs for this annotation; returns a deep copy of all pairs.
Notes:
Note that this method will not include a copy of the value for /Parent. This is by design as to avoid introducing a memory cycle. If you would like to get the /Parent propery, use valueForAnnotationKey with key PDFAnnotationKeyParent.
(Read only property)

Feedback, Comments & Corrections

PDFAnnotationMBS.backgroundColor as NSColorMBS
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 21.1 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: Background color characteristics.
Notes:
Used by annotations type(s): /Widget (field type(s): /Btn, /Ch, /Tx).
(Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.border as PDFBorderMBS
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 8.0 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: Optional border or border style that describes how to draw the annoation border (if any).
Example:
dim f as FolderItem = SpecialFolder.Desktop.Child("test.pdf")
dim doc as new PDFDocumentMBS(f)

dim page as PDFPageMBS = doc.pageAtIndex(0)
dim a as new PDFAnnotationSquareMBS(100,100,100,100)

a.interiorColor = NSColorMBS.greenColor
a.colorValue = NSColorMBS.redColor
a.border.lineWidth=5

page.addAnnotation(a)

dim o as FolderItem = SpecialFolder.Desktop.Child("testout.pdf")
call doc.write(o)
o.Launch
Notes: (Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.bounds as NSRectMBS
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 9.6 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: The bounding box for the annotation in page space.
Notes:
Page space is a 72-dpi coordinate system with the origin at the lower-left corner of the current page.

Available in Mac OS X v10.4 and later.
(Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.buttonWidgetState as Integer
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 21.1 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: The current state of a button widget annotation.
Notes:
Used by annotations type(s): /Widget (field type(s): /Btn).
(Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.buttonWidgetStateString as String
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 21.1 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: The string that represents the ON state of a button widget annotation.
Notes:
This should be set when trying to, for example, group together a set of radio buttons with the same field name.
When buttons share the same field name, their individual state strings set them apart from one another.
Used by annotations type(s): /Widget (field type(s): /Btn).
(Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.caption as String
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 21.1 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: Label for the button. Applies to kPDFWidgetPushButtonControl only.
Notes:
Used by annotations type(s): /Widget (field type(s): /Btn).
(Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.colorValue as NSColorMBS
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 8.0 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: For many annotations ("Circle", "Square") the stroke color.
Example:
dim f as FolderItem = SpecialFolder.Desktop.Child("test.pdf")
dim doc as new PDFDocumentMBS(f)

dim page as PDFPageMBS = doc.pageAtIndex(0)
dim a as new PDFAnnotationLineMBS(100,100,100,100)

a.colorValue = NSColorMBS.redColor
a.endLineStyle = a.kPDFLineStyleOpenArrow

page.addAnnotation(a)

dim o as FolderItem = SpecialFolder.Desktop.Child("testout.pdf")
call doc.write(o)
Notes:
Used for other annotations as well.
(Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.comb as Boolean
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 21.1 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: Used to configure combing for PDF text fields.
Notes:
If set, the field is automatically divided into as many equally spaced positions, or combs, as the value of the maximum length of the field. To get the maximum length, use annotaiton key: PDFAnnotationKeyWidgetMaxLen.
Used by annotations type(s): /Widget (field type(s): /Tx).
(Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.contents as string
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 8.0 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: A string of text associated with an annotation.
Example:
dim f as FolderItem = SpecialFolder.Desktop.Child("test.pdf")
dim doc as new PDFDocumentMBS(f)

dim page as PDFPageMBS = doc.pageAtIndex(0)
dim a as new PDFAnnotationTextMBS(100,100,100,100)

a.contents="Hello"
a.colorValue = NSColorMBS.redColor

page.addAnnotation(a)

dim o as FolderItem = SpecialFolder.Desktop.Child("testout.pdf")
call doc.write(o)
o.Launch
Notes:
Often to be displayed in a pop-up when the annotation is clicked on ("FreeText" and "Text" especially).
(Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.destination as PDFDestinationMBS
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 21.1 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: Destination for the link. May be nil if no destination associated with link; in this case the URL may be valid.
Notes:
The preferred way though is to use action property.
Used by annotations type(s): /Link.
(Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.endLineStyle as Integer
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 21.1 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: Style used for ornaments at the lines end (optional, PDF 1.4).
Notes:
Used by annotations type(s): /Line.
(Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.endPoint as NSPointMBS
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 21.1 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: Points specifying end points for line annotation (required).
Notes:
Points are specified in annotation space.
Used by annotations type(s): /Line.
(Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.fieldName as String
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 21.1 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: Widget annotations backed by form data have (internal) field names with which to associate a value or data.
Notes:
Can also be used for ResetForm actions.
Used by annotations type(s): /Widget (field type(s): /Btn, /Ch, /Tx).
(Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.font as NSFontMBS
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 21.1 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: Font and font color associated with the text field.
Notes:
Used by annotations type(s): /FreeText, /Popup, /Widget (field type(s): /Btn, /Ch, and /Tx).
(Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.fontColor as NSColorMBS
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 21.1 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: Width of line used to stroke border.
Notes:
Used by annotations type(s): /FreeText, /Widget (field type(s): /Btn, /Ch, and /Tx).
(Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.Handle as Integer
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 8.0 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: The handle used internally for the object reference.
Notes: (Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.hasAppearanceStream as boolean
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 8.0 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: Returns true if the annotation has an appearance stream.
Notes:
Annotations with appearance streams are drawn using their stream. As a result, setting many parameters (like 'setColor' above), will have no visible effect.
(Read only property)

Feedback, Comments & Corrections

PDFAnnotationMBS.iconType as Integer
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 21.1 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: The type of icon displayed in the PDF. Supported icons: "Comment", "Key", "Note", "Help", "NewParagraph", "Paragraph" and "Insert".
Notes:
Used by annotations type(s): /Text.
(Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.interiorColor as NSColorMBS
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 21.1 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: Interior color of the annotation.
Notes:
Used by annotations type(s): /Circle, /Line, /Square.
(Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.isHighlighted as Boolean
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 21.1 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: The highlight state dictates how the annotation is drawn.
Notes:
For example, if a user has clicked on a "Link" annotation, you should set highlighted to YES and redraw it. When the user lets up, set highlighted to false and redraw again.

Available in macOS 10.13 or newer or iOS 11.0 or newer.
(Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.isPasswordField as Boolean
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 21.1 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: Used to determine if a PDF text field is a password field.
Notes:
Used by annotations type(s): /Widget (field type(s): /Tx).
(Read only property)

Feedback, Comments & Corrections

PDFAnnotationMBS.ListChoice as Boolean
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 21.1 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: There are two flavors of Choice widget annotations, lists and pop-up menus. This method allow you to differentiate.
Notes:
Used by annotations type(s): /Widget (field type(s): /Ch).
(Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.markupType as Integer
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 21.1 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: Type of mark-up (highlight, strike-out or underline). Changing the markup type also changes the annotations type.
Notes:
Used by annotations type(s): /Highlight, /StrikeOut, /Underline.
(Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.maximumLength as Integer
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 21.1 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: Maximum characters allowed (optional, zero indicates no specified maximum).
Notes:
Used by annotations type(s): /Widget (field type(s): /Tx).
(Read and Write property)

Feedback, Comments & Corrections

PDFAnnotationMBS.modificationDate as date
Type Topic Plugin Version macOS Windows Linux iOS Targets
property PDFKit MBS MacControls Plugin 9.6 ✅ Yes ❌ No ❌ No ❌ No Desktop, Console & Web
Function: The modification date of the annotation.
Notes:
Available in Mac OS X v10.5 and later.
(Read and Write property)

Feedback, Comments & Corrections

Next items

The items on this page are in the following plugins: MBS MacControls Plugin.

The biggest plugin in space...




Links
MBS Xojo blog

Start Chat