PDFPage

PDFPage, подкласс NSObject, определяет методы, используемые, чтобы представить страницы PDF и работать с аннотациями, текстом и выборами.

PDFPage объекты гибки и мощны. С ними можно представить содержание PDF на экране или к принтеру, добавить аннотации, символы количества, определить выборы и получить текстовое содержание страницы как NSString объект.

Ваше приложение инстанцирует a PDFPage объект путем выяснения один от a PDFDocument объект.

Для простого дисплея и навигации документов в формате PDF в Вашем приложении, Вы не должны использовать PDFPage. Вы должны только использовать PDFView.

Наследование

NSObject
PDFPage

NSObject
PDFPage

Соответствует

AnyObject
CVarArgType
Сопоставимый
Hashable
NSCopying
NSObjectProtocol
Печатаемый
NSCopying
NSObject

Оператор импорта

Swift

import Quartz

Objective C

@import Quartz;

Доступность

Доступный в OS X v10.4 и позже.

Инициализация страницы

initWithDocument: - initWithDocument:

Инициализатор для подклассов PDFPage.

Использовать [PDFPage init] или initWithImage: вместо этого.

Объявление

Objective C

- (id)initWithDocument:(PDFDocument *)document

Обсуждение

Подклассы PDFPage должен обработать несколько методов, прозрачно обрабатывающихся при использовании PDFPage классифицируйте непосредственно, включая boundsForBox и drawInRect:withBox:.

Оператор импорта

Objective C

@import Quartz;

Доступность

Доступный в OS X v10.4 и позже.
Не доступный 64-разрядным приложениям.
init (изображение:) - initWithImage:

Создает новое PDFPage возразите и инициализирует его с указанным NSImage объект.

Объявление

Swift

init!(image image: NSImage!)

Objective C

- (id)initWithImage:(NSImage *)image

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.5 и позже.

Получение информации приблизительно страница

документ () - документ

Возвраты PDFDocument объект, с которым связана страница.

Объявление

Swift

func document() -> PDFDocument!

Objective C

- (PDFDocument *)document

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.
метка () - метка

Возвращает метку для страницы.

Объявление

Swift

func label() -> String!

Objective C

- (NSString *)label

Обсуждение

Как правило, метка «1» для первой страницы, «2» для второй страницы, и т.д., но нечисловые метки также возможны (такие как «xxi», «4-1» и т.д.).

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.

См. также

– документ
boundsForBox (_:) - boundsForBox:

Возвращает границы для указанного поля дисплея PDF.

Объявление

Swift

func boundsForBox(_ box: PDFDisplayBox) -> NSRect

Objective C

- (NSRect)boundsForBox:(PDFDisplayBox)box

Обсуждение

PDFDisplayBox перечисление определяет различные типы поля (см. Константы для получения дополнительной информации о типах поля).

Обратите внимание на то, что только поле носителей требуется для PDF. Если Вы запрашиваете границы на поле обрезки, но PDF не включает поле обрезки, границы для поля носителей возвращаются вместо этого. Если Вы запрашиваете границы на другие типы поля, и PDF не делает включает эти типы, границы для поля обрезки возвращаются вместо этого.

Координаты для поля находятся в пространстве страницы, таким образом, Вы, возможно, должны были бы преобразовать точки, если страница имеет вращение на нем. Кроме того, отметьте что границы boundsForBox возвраты пересечены с полем носителей страницы.

boundsForBox выдает исключение диапазона если box не находится в диапазоне.

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.

См. также

– setBounds:forBox:
setBounds (_: forBox:) - setBounds:forBox:

Устанавливает границы для указанного поля.

Объявление

Swift

func setBounds(_ bounds: NSRect, forBox box: PDFDisplayBox)

Objective C

- (void)setBounds:(NSRect)bounds forBox:(PDFDisplayBox)box

Обсуждение

Если поле не существует, этот метод создает его для Вас.

Удалить поле, передачу NSZeroRect для границ (отмечают, что Вы не можете удалить поле носителей). Если границы поля не находятся в диапазоне, этот метод выдает исключение диапазона.

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.

См. также

– boundsForBox:
вращение () - вращение

Возвращает угол вращения страницы в градусах.

Объявление

Swift

func rotation() -> Int

Objective C

- (NSInteger)rotation

Обсуждение

Вращение является положительным кратным числом 90: 0, 90, 180, или 270. Вращение страниц с отрицательным вращением преобразовывается в соответствующее положительное вращение.

Если Вы разделяете на подклассы PDFView и отображение страниц самостоятельно, не принимайте вращение 0. Страницы со свойственным дисплеем вращения вращались, когда открыто, если Вы не обнуляете их вращение. Независимо от свойственного угла вращения это до автора страницы, соответствует ли нулевое вращение вертикальному тексту, когда выведено на экран на мониторе.

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.

См. также

– setRotation:
setRotation (_:) - setRotation:

Устанавливает угол вращения для страницы в градусах.

Объявление

Swift

func setRotation(_ angle: Int)

Objective C

- (void)setRotation:(NSInteger)angle

Обсуждение

Вращение должно быть положительным или отрицательным кратным числом 90 (отрицательные углы преобразовываются в их положительные эквиваленты; например,-90 изменяется на 270); иначе этот метод выдает исключение.

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.

См. также

– вращение

Работа с аннотациями

аннотации () - аннотации

Возвращает массив, содержащий аннотации страницы.

Объявление

Swift

func annotations() -> [AnyObject]!

Objective C

- (NSArray *)annotations

Обсуждение

Элементы массива будут наиболее вероятно введены к подклассам PDFAnnotation класс.

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.

См. также

– displaysAnnotations
– setDisplaysAnnotations:
– addAnnotation:
– removeAnnotation:
– annotationAtPoint:
displaysAnnotations () - displaysAnnotations

Возвращает булево значение, указывающее, выведены ли аннотации на экран для страницы.

Объявление

Swift

func displaysAnnotations() -> Bool

Objective C

- (BOOL)displaysAnnotations

Обсуждение

Если YEStrue, когда метод рисования вызовут, страница составит аннотации.

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.

См. также

– аннотации
– setDisplaysAnnotations:
– addAnnotation:
– removeAnnotation:
– annotationAtPoint:
– drawWithBox:
setDisplaysAnnotations (_:) - setDisplaysAnnotations:

Указывает, вывести ли на экран аннотации для страницы.

Объявление

Swift

func setDisplaysAnnotations(_ display: Bool)

Objective C

- (void)setDisplaysAnnotations:(BOOL)display

Обсуждение

Если display YEStrue, когда метод рисования вызовут, страница составит аннотации.

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.

См. также

– аннотации
– displaysAnnotations
– addAnnotation:
– removeAnnotation:
– annotationAtPoint:
addAnnotation (_:) - addAnnotation:

Добавляет указанный объект пометок к странице.

Объявление

Swift

func addAnnotation(_ annotation: PDFAnnotation!)

Objective C

- (void)addAnnotation:(PDFAnnotation *)annotation

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.

См. также

– аннотации
– displaysAnnotations
– setDisplaysAnnotations:
– removeAnnotation:
– annotationAtPoint:
removeAnnotation (_:) - removeAnnotation:

Удаляет указанную аннотацию из страницы.

Объявление

Swift

func removeAnnotation(_ annotation: PDFAnnotation!)

Objective C

- (void)removeAnnotation:(PDFAnnotation *)annotation

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.

См. также

– аннотации
– displaysAnnotations
– setDisplaysAnnotations:
– addAnnotation:
– annotationAtPoint:
annotationAtPoint (_:) - annotationAtPoint:

Если существует один в указанной точке, возвращает аннотацию.

Объявление

Swift

func annotationAtPoint(_ point: NSPoint) -> PDFAnnotation!

Objective C

- (PDFAnnotation *)annotationAtPoint:(NSPoint)point

Обсуждение

Используйте этот метод для тестирования хита на основе текущей позиции курсора. Если больше чем одна аннотация совместно использует указанную точку, frontmost (или самый верхний), каждый возвращается (аннотации ищутся в обратном порядке их появления в файле данных PDF). Возвраты NULL если нет никакой аннотации в point.

Укажите точку в пространстве страницы. Пространство страницы является системой координат на 72 точки на дюйм с источником в нижнем левом углу текущей страницы.

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.

См. также

– аннотации
– displaysAnnotations
– setDisplaysAnnotations:
– addAnnotation:
– removeAnnotation:

Рендеринг страниц

drawWithBox (_:) - drawWithBox:

Рисует страницу в указанном поле.

Объявление

Swift

func drawWithBox(_ box: PDFDisplayBox)

Objective C

- (void)drawWithBox:(PDFDisplayBox)box

Обсуждение

Этот метод принимает во внимание вращение страницы и рисует отсеченный к указанному полю. Если страница установлена вывести на экран аннотации, этот метод также рисует их. Этот метод не очищает фон. Для очистки фона перед получением использовать NSRectFill с NSColor набор (обычно) белому.

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.

См. также

– displaysAnnotations
transformContextForBox (_:) - transformContextForBox:

Преобразовывает текущий контекст, учитывая указанное поле.

Объявление

Swift

func transformContextForBox(_ box: PDFDisplayBox)

Objective C

- (void)transformContextForBox:(PDFDisplayBox)box

Обсуждение

При преобразовании текущего контекста этот метод принимает во внимание вращение страницы, а также источник поля относительно основной системы координат страницы. Это - удобный метод для вызова в PDFView drawPage: метод или из метода получения a PDFAnnotation подкласс.

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.5 и позже.

См. также

– drawWithBox:

Работа с текстовым содержанием

numberOfCharacters () - numberOfCharacters

Возвращает число символов на странице, включая пробельные символы.

Объявление

Swift

func numberOfCharacters() -> Int

Objective C

- (NSUInteger)numberOfCharacters

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.

См. также

– строка
строка () - строка

Возвраты NSString объект, представляющий текст на странице.

Объявление

Swift

func string() -> String!

Objective C

- (NSString *)string

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.

См. также

– numberOfCharacters
– attributedString
attributedString () - attributedString

Возвраты NSAttributedString объект, представляющий текст на странице.

Объявление

Swift

func attributedString() -> NSAttributedString!

Objective C

- (NSAttributedString *)attributedString

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.

См. также

– numberOfCharacters
– строка
characterBoundsAtIndex (_:) - characterBoundsAtIndex:

Возвращает границы, в пространстве страницы, символа в указанном индексе.

Объявление

Swift

func characterBoundsAtIndex(_ index: Int) -> NSRect

Objective C

- (NSRect)characterBoundsAtIndex:(NSInteger)index

Обсуждение

В маловероятном случае, что существует больше чем один символ в указанной индексной точке, только границы первого символа возвращаются.

Пространство страницы является системой координат на 72 точки на дюйм с источником в нижнем левом углу текущей страницы. Обратите внимание на то, что границы возвратились, как, гарантируют, не будут иметь целочисленные координаты.

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.

См. также

– characterIndexAtPoint:
characterIndexAtPoint (_:) - characterIndexAtPoint:

Возвращает значение индекса символа для указанной точки в пространстве страницы.

Объявление

Swift

func characterIndexAtPoint(_ point: NSPoint) -> Int

Objective C

- (NSInteger)characterIndexAtPoint:(NSPoint)point

Обсуждение

Если нет никакого символа в указанной точке, возвратах метода -1.

Пространство страницы является системой координат на 72 точки на дюйм с источником в нижнем левом углу текущей страницы.

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.

См. также

– characterBoundsAtIndex:

Работа с выборами

selectionForRect (_:) - selectionForRect:

Возвращает текст, включенный в указанном прямоугольнике, выраженном на странице (пользователь) координаты.

Объявление

Swift

func selectionForRect(_ rect: NSRect) -> PDFSelection!

Objective C

- (PDFSelection *)selectionForRect:(NSRect)rect

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.

См. также

– selectionForWordAtPoint:
– selectionForLineAtPoint:
– selectionFromPoint:toPoint:
– selectionForRange:
selectionForWordAtPoint (_:) - selectionForWordAtPoint:

Возвращает целое слово, включающее указанную точку.

Объявление

Swift

func selectionForWordAtPoint(_ point: NSPoint) -> PDFSelection!

Objective C

- (PDFSelection *)selectionForWordAtPoint:(NSPoint)point

Обсуждение

Возвраты NULL если никакое слово не содержит point.

Используйте этот метод для ответа на двойной щелчок.

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.

См. также

– selectionForRect:
– selectionForLineAtPoint:
– selectionFromPoint:toPoint:
– selectionForRange:
selectionForLineAtPoint (_:) - selectionForLineAtPoint:

Возвращает целую строку текста, включающего указанную точку.

Объявление

Swift

func selectionForLineAtPoint(_ point: NSPoint) -> PDFSelection!

Objective C

- (PDFSelection *)selectionForLineAtPoint:(NSPoint)point

Обсуждение

Возвраты NULL если никакая строка текста не содержит point.

Используйте этот метод для ответа на тройной щелчок.

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.

См. также

– selectionForRect:
– selectionForWordAtPoint:
– selectionFromPoint:toPoint:
– selectionForRange:
selectionFromPoint (_: toPoint:) - selectionFromPoint:toPoint:

Возвращает текст между двумя указанными точками в пространстве страницы.

Объявление

Swift

func selectionFromPoint(_ startPoint: NSPoint, toPoint endPoint: NSPoint) -> PDFSelection!

Objective C

- (PDFSelection *)selectionFromPoint:(NSPoint)startPoint toPoint:(NSPoint)endPoint

Обсуждение

Любая точка может быть одной ближе к запуску страницы. В определении выбора точки сортируются сначала от начала до конца и затем слева направо.

Пространство страницы является системой координат на 72 точки на дюйм с источником в нижнем левом углу текущей страницы.

Для визуализации выбора изобразите прямоугольник, определенный startPoint и endPoint. Выбор начинается в первом символе полностью в определенном прямоугольнике и самый близкий к его верхнему левому углу. Выбор заканчивается в последнем знаке полностью в определенном прямоугольнике и самый близкий к его нижнему правому углу.

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.

См. также

– selectionForRect:
– selectionForWordAtPoint:
– selectionForLineAtPoint:
– selectionForRange:
selectionForRange (_:) - selectionForRange:

Возвращает текст, содержавший в указанном диапазоне.

Объявление

Swift

func selectionForRange(_ range: NSRange) -> PDFSelection!

Objective C

- (PDFSelection *)selectionForRange:(NSRange)range

Обсуждение

Если длина диапазона, этот метод повышает исключение 0 или если любой конец диапазона вне диапазона символов на странице.

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.

См. также

– selectionForRect:
– selectionForWordAtPoint:
– selectionForLineAtPoint:
– selectionFromPoint:toPoint:

Прочие условия

dataRepresentation () - dataRepresentation

Возвращает данные PDF (т.е. документ в формате PDF) представляющий эту страницу. Этот метод не сохраняет внешние ссылки страницы.

Объявление

Swift

func dataRepresentation() -> NSData!

Objective C

- (NSData *)dataRepresentation

Оператор импорта

Objective C

@import Quartz;

Swift

import Quartz

Доступность

Доступный в OS X v10.4 и позже.

PDFPage

Инициализация страницы

Объявление

Обсуждение

Оператор импорта

Доступность

Объявление

Оператор импорта

Доступность

Получение информации приблизительно страница

Объявление

Оператор импорта

Доступность

Объявление

Обсуждение

Оператор импорта

Доступность

См. также

Объявление

Обсуждение

Оператор импорта

Доступность

См. также

Объявление

Обсуждение

Оператор импорта

Доступность

См. также

Объявление

Обсуждение

Оператор импорта

Доступность

См. также

Объявление

Обсуждение

Оператор импорта

Доступность

См. также

Работа с аннотациями

Объявление

Обсуждение

Оператор импорта

Доступность

См. также

Объявление

Обсуждение

Оператор импорта

Доступность

См. также

Объявление

Обсуждение

Оператор импорта

Доступность

См. также

Объявление

Оператор импорта

Доступность

См. также

Объявление

Оператор импорта

Доступность

См. также

Объявление

Обсуждение

Оператор импорта

Доступность

См. также

Рендеринг страниц

Объявление

Обсуждение

Оператор импорта

Доступность

См. также

Объявление

Обсуждение

Оператор импорта

Доступность

См. также

Работа с текстовым содержанием

Объявление