PDFSelectionMBS.addSelection(selection as PDFSelectionMBS)

Selections do not have to be contiguous. If the selection added overlaps with this selection, overlaps are removed.

PDFSelectionMBS.addSelections(selection() as PDFSelectionMBS)

This method provides better performance than multiple calls to addSelection if you need to add several selections to an existing selection. This is because the normalization of the selection (the removal of any overlaps between selections) occurs only once, after all selections have been added.
Available in Mac OS X v10.5 and later.

PDFSelectionMBS.boundsForPage(page as PDFPageMBS) as NSRectMBS

The selection rectangle is given in page space.
Page space is a 72 dpi coordinate system with the origin at the lower-left corner of the current page.

Some examples using this method:

• /PDFKit/Search and Highlight/Search and Highlight

PDFSelectionMBS.Constructor(doc as PDFDocumentMBS)

Typically, you don't need to create a PDFSelection object, but you can use an empty PDFSelection object as a container into which you can place selections, using addSelection: and addSelections.
Available in Mac OS X v10.5 and later.

See also:

• Constructor(Handle as Integer)

PDFSelectionMBS.Constructor(Handle as Integer)

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

See also:

• Constructor(doc as PDFDocumentMBS)

PDFSelectionMBS.copy as PDFSelectionMBS

PDFSelectionMBS.drawForPage(page as PDFPageMBS, active as boolean)

The default value is kPDFDisplayBoxCropBox. If active is true, drawing uses selectedTextBackgroundColor. If false, it uses secondarySelectedControlColor.

See also:

• drawForPage(page as PDFPageMBS, box as Integer, active as boolean)

PDFSelectionMBS.drawForPage(page as PDFPageMBS, box as Integer, active as boolean)

The selection is drawn using the current highlight color. If active is true, drawing uses selectedTextBackgroundColor. If false, it uses secondarySelectedControlColor. Refer to the PDFPage class for the list of available box types.

Page space is a 72 dpi coordinate system with the origin at the lower-left corner of the current page.

See also:

• drawForPage(page as PDFPageMBS, active as boolean)

PDFSelectionMBS.extendSelectionAtEnd(chars as Integer)

dim s as PDFSelectionMBS // your selection

s.extendSelectionAtEnd(50)

Selections can be extended right off onto neighboring pages even to include the entire PDF document.

Some examples using this method:

• /PDFKit/Search and Highlight/Search and Highlight

PDFSelectionMBS.extendSelectionAtStart(chars as Integer)

dim s as PDFSelectionMBS // your selection

s.extendSelectionAtStart(50)

Selections can be extended right off onto neighboring pages even to include the entire PDF document.

Some examples using this method:

• /PDFKit/Search and Highlight/Search and Highlight

PDFSelectionMBS.extendSelectionForLineBoundaries

If the current selection is on a single line, then this will extend it to the entire line width. If the selection is across multiple lines, then the first and last lines are expected to wholly contain their respective rows of text.

Available in macOS 10.13 or newer or iOS 11.0 or newer.

PDFSelectionMBS.numberOfTextRangesOnPage(page as PDFPageMBS) as UInt32

Returns zero if page is not in selection.
A typical, simple selection will contain a single range of text.

Available in Mac OS X 10.7 and later.

PDFSelectionMBS.pages as PDFPageMBS()

These are sorted by page index.
Returns nil on any error.

PDFSelectionMBS.rangeAtIndex(page as PDFPageMBS, index as Integer) as NSRangeMBS

A simple selection. A typical, simple selection will contain a single range of text.
Available in Mac OS X 10.7 and later.

PDFSelectionMBS.selectionsByLine as PDFSelectionMBS()

If you call this method on a PDFSelection object that represents a paragraph, for example, selectionsByLine returns an array that contains one PDFSelection object for each line of text in the paragraph.
Available in Mac OS X v10.5 and later.