PDFPageMBS.addAnnotation(annotation as PDFAnnotationMBS)

PDFPageMBS.annotationAtPoint(x as single, y as single) as PDFAnnotationMBS

The point is in page-space.

PDFPageMBS.annotations as PDFAnnotationMBS()

Var f as FolderItem = SpecialFolder.Desktop.Child("test.pdf")
Var doc as new PDFDocumentMBS(f)
Var page as PDFPageMBS = doc.pageAtIndex(0)
Var annotations(-1) as PDFAnnotationMBS = page.annotations

// show a msgbox with the types of all annotations
Var types(-1) as string

for each a as PDFAnnotationMBS in annotations
  types.Append a.type
next

MsgBox Join(types)

The elements of the array will most likely be typed to subclasses of the PDFAnnotation class.

Available in Mac OS X v10.4 and later.

PDFPageMBS.boundsForBox(box as Integer) as NSRectMBS

The PDFDisplayBox enumeration defines the various box types.

Note that only the media box is required for a PDF. If you request the bounds for the crop box, but the PDF does not include a crop box, the bounds for the media box are returned instead. If you request the bounds for other box types, and the PDF does not includes these types, the bounds for the crop box are returned instead.

The coordinates for the box are in page space, so you might need to transform the points if the page has a rotation on it. Also, note that the bounds boundsForBox returns are intersected with the page's media box.

boundsForBox throws a range exception if box is not in range.
(Read and Write computed property)

Some examples using this property:

• /PDFKit/Create Page
• /PDFKit/Create Page with custom stamp annotation
• /PDFKit/Create Page with Page
• /PDFKit/PDFView/PDFView overlay/PDFView overlay
• /PDFKit/PDFView/PDFView overlay/PDFViewControl overlay

PDFPageMBS.CalcTransformForBox(box as Integer) as Variant

Returns NSAffineTransformMBS object.

PDFPageMBS.characterBoundsAtIndex(index as Integer) as NSRectMBS

In the unlikely event that more than one character are at the specified point, only the first character encountered is returned.

PDFPageMBS.characterIndexAtPoint(x as single, y as single) as Integer

Returns -1 if no character at point.

PDFPageMBS.Constructor

Var doc as new PDFDocumentMBS
Var page as PDFPageMBS
Var f as FolderItem

page=new MyPDFPageMBS

doc.Creator="Xojo"
doc.Title="Test file"

doc.insertPage page,0

f=SpecialFolder.Desktop.Child("test.pdf")

if doc.write(f) then
  f.launch
end if

You draw the content using drawRect event.

See also:

• Constructor(Handle as Integer)
• Constructor(image as NSImageMBS)

PDFPageMBS.Constructor(Handle as Integer)

Please pass in a non zero handle which points to a PDFPage object.
For use with declares.

See also:

• Constructor
• Constructor(image as NSImageMBS)

PDFPageMBS.Constructor(image as NSImageMBS)

An easy way to create a PDFPage from an image to add to a PDFDocument.

Mac OS X 10.5 only.

See also:

• Constructor
• Constructor(Handle as Integer)

PDFPageMBS.copy as PDFPageMBS

Var f as FolderItem = SpecialFolder.Desktop.Child("test.pdf")
Var p as new PDFDocumentMBS(f)

// make a new PDF
Var c as new PDFDocumentMBS

// get first page
Var page as PDFPageMBS = p.pageAtIndex(0)

// add copy of page to new pdf
c.insertPage page.copy, 0

// c now has one page
MsgBox str(p.pageCount)+" "+str(c.pageCount)

PDFPageMBS.Destructor

PDFPageMBS.Draw(g as NSGraphicsMBS, box as Integer = 0)

Use kPDFDisplay*Box constants for box parameter.

PDFPageMBS.drawWithBox(box as Integer)

This method takes into account the page rotation and draws clipped to the specified box. If the page is set to display annotations, this method also draws them. This method does not clear the background. To clear the background before drawing, use NSRectFill with NSColor set (typically) to white.

PDFPageMBS.removeAnnotation(annotation as PDFAnnotationMBS)

PDFPageMBS.Render(dpi as Double = 72.0, box as Integer = 0, background as NSColorMBS = nil) as NSImageMBS

Var f as FolderItem = GetFolderItem("Castles.pdf")
Var doc as new PDFDocumentMBS(f)
Var page as PDFPageMBS = doc.pageAtIndex(0)
Var image as NSImageMBS = page.Render

Backdrop = image.CopyPicture

dpi: The resolution you want to have on the image. Default 72.0. To get a scaled image with factor x, pass 72.0*x.
box: The display box. Use one of the kPDFDisplayBox* constants.
background: optional NSColorMBS object to fill the background before drawing the PDF. This will affect only PDFs with transparent background.

Returns nil on any error.

Version 11.1pr8 adds code here to handle rotation better.
Due to bugs in Apple’s PDFKit you may see memory leaks with JPEG data from PDF pages (seen in macOS 10.12).

PDFPageMBS.selectionForLineAtPoint(left as single, top as single) as PDFSelectionMBS

May return nil if no character (and by extension no line) under point.

PDFPageMBS.selectionForRange(position as Integer, length as Integer) as PDFSelectionMBS

Var MyPDFView as PDFViewMBS // your view

Var doc as PDFDocumentMBS = MyPDFView.document
Var page as PDFPageMBS = doc.pageAtIndex(0)
Var sel as PDFSelectionMBS = page.selectionForRange(0,5)
MyPDFView.currentSelection = sel

Will raise an exception if the range length is zero or if the range is outside the range of the characters on the page.

PDFPageMBS.selectionForRect(left as single, top as single, width as single, height as single) as PDFSelectionMBS

PDFPageMBS.selectionForWordAtPoint(left as single, top as single) as PDFSelectionMBS

May return nil if no character (and by extension no word) under point.

PDFPageMBS.selectionFromPointToPoint(startleft as single, starttop as single, endleft as single, endtop as single) as PDFSelectionMBS

Point are sorted first top to bottom, left to right.

PDFPageMBS.thumbnailOfSize(size as NSSizeMBS, box as integer) as NSImageMBS

Note that the produced image is "size to fit": it retains the original page aspect-ratio. The size you give may not match the size of the returned image, but the returned image is guaranteed to be equal or less.

Available in macOS 10.13 or newer.

PDFPageMBS.transformContextForBox(box as Integer)

This is a convenient method to call from within drawPage or from within the draw method a PDFAnnotation subclass.

Mac OS X 10.5 only.

Some examples using this method:

• /PDFKit/Create Page with custom stamp annotation

PDFPageMBS.transformForBox(box as integer) as variant

Available in macOS 10.13 or newer.