Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека Разработчика iOS

Разработчик

Ссылка платформы UIKit ссылка класса UIPrintPageRenderer

Опции
Развертывание Target:

На этой странице
Язык:

UIPrintPageRenderer

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

Доступный в iOS 4.2 и позже.

A UIPrintPageRenderer объект рисует страницы содержания, которые должны быть распечатаны, с или без помощи средств форматирования печати.

Средство рендеринга страницы является экземпляром пользовательского подкласса UIPrintPageRenderer. Когда Вы составляете задание печати с помощью совместно используемого экземпляра UIPrintInteractionController, Вы присваиваете средство рендеринга страницы printPageRenderer свойство того экземпляра. Подкласс обычно переопределяет один или больше пяти draw... методы:

  • drawPageAtIndex:inRect: вызовами по умолчанию каждый из других методов получения, в порядке упоминается ниже. Ваше приложение может переопределить его, если Вы хотите иметь полный контроль над тем, что нарисовано для печати.

  • Переопределение drawHeaderForPageAtIndex:inRect: нарисовать содержание в заголовке.

  • Переопределение drawContentForPageAtIndex:inRect: нарисовать основное содержание задания печати в области между заголовком и нижним колонтитулом.

  • Переопределение drawPrintFormatter:forPageAtIndex: смешивать пользовательское получение с получением, выполняемым связанным средством форматирования печати. Этот метод вызывают для каждого средства форматирования печати, связанного с данной страницей.

  • Переопределение drawFooterForPageAtIndex:inRect: нарисовать содержание в нижнем колонтитуле.

UIPrintPageRenderer обычно требует, чтобы Вы указали число страниц печатаемого содержания путем переопределения numberOfPages. Это также позволяет Вам указывать высоты верхних колонтитулов страницы и нижних колонтитулов.

Можно присвоить одно или более средств форматирования печати — т.е. UIPrintFormatter объекты, которые могут разметить печатаемое содержание определенного вида — к определенным диапазонам страницы содержания. Например, если Вашим печатаемым содержанием является частично HTML, можно присвоить экземпляр UIMarkupTextPrintFormatter возразите против начальной страницы содержимого HTML. Вы присваиваете средство форматирования печати с помощью addPrintFormatter:startingAtPageAtIndex: метод и Вы можете получить средства форматирования печати для данной страницы путем вызова printFormattersForPageAtIndex:.

Доступ к информации о задании печати
  • numberOfPages () - numberOfPages

    Число страниц для рендеринга.

    Объявление

    Swift

    func numberOfPages() -> Int

    Objective C

    - (NSInteger)numberOfPages

    Обсуждение

    По умолчанию, если получатель использует средства форматирования печати, возвращает число страниц, как вычислено UIKit. Если средство рендеринга страницы не использует средств форматирования печати, возвращенное значение является нулем. Если Ваше средство рендеринга страницы делает какое-либо пользовательское получение за исключением заголовков и нижних колонтитулов, это должно переопределить этот метод.

    Когда UIKit нужно число страниц, этот метод вызывают в любой точке. Если запросы приложения управление диапазоном страницы, это вызывают вначале. Когда выбранный принтер или дуплексный режим изменяются, это можно также вызвать. Иначе, когда задание печати запускается, это вызывают.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 4.2 и позже.

    См. также

    paperRect
    printableRect
    pageCount (UIPrintFormatter)

  • paperRect Свойство

    Размер бумаги используется для печати. (только для чтения)

    Объявление

    Swift

    var paperRect: CGRect { get }

    Objective C

    @property(nonatomic, readonly) CGRect paperRect

    Обсуждение

    Значение этого свойства является прямоугольником, определяющим размер бумаги, выбранной для задания печати. Источник всегда (0,0).

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 4.2 и позже.

    См. также

    printableRect
    printPaper (UIPrintInteractionController)

  • printableRect Свойство

    Область, в которой может произойти печать. (только для чтения)

    Объявление

    Swift

    var printableRect: CGRect { get }

    Objective C

    @property(nonatomic, readonly) CGRect printableRect

    Обсуждение

    Значение этого свойства является прямоугольником, определяющим область, в которой принтер может распечатать содержание. Иногда это упоминается как область изображения бумаги.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 4.2 и позже.

    См. также

    paperRect
    printPaper (UIPrintInteractionController)

Указание высот заголовка и нижнего колонтитула
  • headerHeight Свойство

    Высота верхнего колонтитула страницы.

    Объявление

    Swift

    var headerHeight: CGFloat

    Objective C

    @property(nonatomic) CGFloat headerHeight

    Обсуждение

    Заголовок измеряется в точках от вершины printableRect и выше предметной области. Высота заголовка по умолчанию 0.0.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 4.2 и позже.

    См. также

    footerHeight

  • footerHeight Свойство

    Высота нижнего колонтитула страницы.

    Объявление

    Swift

    var footerHeight: CGFloat

    Objective C

    @property(nonatomic) CGFloat footerHeight

    Обсуждение

    Нижний колонтитул измеряется в точках от нижней части printableRect и ниже предметной области. Высота нижнего колонтитула по умолчанию 0.0

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 4.2 и позже.

    См. также

    headerHeight

Управление средствами форматирования печати
  • addPrintFormatter (_: startingAtPageAtIndex:) - addPrintFormatter:startingAtPageAtIndex:

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

    Объявление

    Swift

    func addPrintFormatter(_ formatter: UIPrintFormatter!, startingAtPageAtIndex pageIndex: Int)

    Objective C

    - (void)addPrintFormatter:(UIPrintFormatter *)formatter startingAtPageAtIndex:(NSInteger)pageIndex

    Параметры

    formatter

    UIPrintFormatter объект добавить к средству рендеринга страницы. Средство форматирования печати может быть экземпляром UISimpleTextPrintFormatter, UIMarkupTextPrintFormatter, или UIViewPrintFormatter.

    pageIndex

    Индекс, идентифицирующий первую страницу, с которой средство форматирования печати должно быть связано с. Это значение переопределяет startPage свойство средства форматирования печати.

    Обсуждение

    Можно отделить средство форматирования печати от его средства рендеринга страницы путем вызова removeFromPrintPageRenderer метод на средстве форматирования печати.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 4.2 и позже.

    См. также

    – printFormattersForPageAtIndex:
    printFormatters

  • printFormattersForPageAtIndex (_:) - printFormattersForPageAtIndex:

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

    Объявление

    Swift

    func printFormattersForPageAtIndex(_ pageIndex: Int) -> [AnyObject]!

    Objective C

    - (NSArray *)printFormattersForPageAtIndex:(NSInteger)pageIndex

    Параметры

    pageIndex

    Индекс страницы печатаемого содержания.

    Возвращаемое значение

    Массив UIPrintFormatter объекты. Средство форматирования печати может быть экземпляром UISimpleTextPrintFormatter, UIMarkupTextPrintFormatter, или UIViewPrintFormatter.

    Обсуждение

    Средство форматирования печати связано с начальной страницей печатаемого содержания через addPrintFormatter:startingAtPageAtIndex: метод или startPage свойство UIPrintFormatter. Число страниц от той страницы определяется pageCount свойство, который UIPrintFormatter вычисляет на основе метрик расположения и содержания.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 4.2 и позже.

  • printFormatters Свойство

    Средства форматирования печати связались со средством рендеринга страницы.

    Объявление

    Swift

    var printFormatters: [AnyObject]!

    Objective C

    @property(nonatomic, copy) NSArray *printFormatters

    Обсуждение

    Элементы массива UIPrintFormatter объекты. Средство форматирования печати может быть экземпляром UISimpleTextPrintFormatter, UIMarkupTextPrintFormatter, или UIViewPrintFormatter. Средства форматирования печати добавили, что этот путь к средству рендеринга страницы связан с диапазонами страницы через каждое средство форматирования печати startPage и pageCount свойства.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 4.2 и позже.

    См. также

    – addPrintFormatter:startingAtPageAtIndex:
    – printFormattersForPageAtIndex:

Подготовка к рисованию
  • prepareForDrawingPages (_:) - prepareForDrawingPages:

    Переопределенный средством рендеринга страницы для подготовки к рисованию диапазона страниц.

    Объявление

    Swift

    func prepareForDrawingPages(_ range: NSRange)

    Objective C

    - (void)prepareForDrawingPages:(NSRange)range

    Параметры

    range

    Диапазон страниц.

    Обсуждение

    UIKit вызывает этот метод, прежде чем это запросит получение на диапазон страниц. Можно дополнительно переопределить этот метод для выполнения задач установки. Реализация по умолчанию ничего не делает.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 4.2 и позже.

Рисование страницы
  • drawPageAtIndex (_: inRect:) - drawPageAtIndex:inRect:

    Переопределенный для рисования данной страницы содержания для принтера.

    Объявление

    Swift

    func drawPageAtIndex(_ index: Int, inRect pageRect: CGRect)

    Objective C

    - (void)drawPageAtIndex:(NSInteger)index inRect:(CGRect)pageRect

    Параметры

    index

    Индекс страницы для рисования.

    pageRect

    Прямоугольник, в котором может быть нарисовано печатаемое содержание.

    Обсуждение

    Реализация по умолчанию этого вызовы метода, в последовательности, drawHeaderForPageAtIndex:inRect:, drawContentForPageAtIndex:inRect:, drawPrintFormatter:forPageAtIndex:, и drawFooterForPageAtIndex:inRect:. Метод устанавливается для рисования к текущему графическому контексту (как возвращено UIGraphicsGetCurrentContext).

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 4.2 и позже.

  • drawHeaderForPageAtIndex (_: inRect:) - drawHeaderForPageAtIndex:inRect:

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

    Объявление

    Swift

    func drawHeaderForPageAtIndex(_ index: Int, inRect headerRect: CGRect)

    Objective C

    - (void)drawHeaderForPageAtIndex:(NSInteger)index inRect:(CGRect)headerRect

    Параметры

    index

    Индекс страницы, на которой можно нарисовать заголовок.

    headerRect

    Прямоугольник, в котором должно быть нарисовано содержание заголовка. Это указано в системе координат бумажного прямоугольника (paperRect); т.е. начало координат в верхнем левом углу листа.

    Обсуждение

    Реализация по умолчанию этого метода ничего не делает. Это не вызывают если headerHeight не положительное значение. Метод устанавливается для рисования к текущему графическому контексту (как возвращено UIGraphicsGetCurrentContext).

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 4.2 и позже.

    См. также

    – drawPageAtIndex:inRect:
    – drawContentForPageAtIndex:inRect:
    – drawPrintFormatter:forPageAtIndex:
    – drawFooterForPageAtIndex:inRect:

  • drawContentForPageAtIndex (_: inRect:) - drawContentForPageAtIndex:inRect:

    Переопределенный для рисования содержания данной страницы.

    Объявление

    Swift

    func drawContentForPageAtIndex(_ index: Int, inRect contentRect: CGRect)

    Objective C

    - (void)drawContentForPageAtIndex:(NSInteger)index inRect:(CGRect)contentRect

    Параметры

    index

    Индекс страницы, на которой можно нарисовать содержание.

    contentRect

    Область, в которой должно быть нарисовано содержание, указала в системе координат печатаемого прямоугольника. Это - область, определенная printableRect минус headerHeight и footerHeight.

    Обсуждение

    Реализация по умолчанию этого метода ничего не делает. Метод устанавливается для рисования к текущему графическому контексту (как возвращено UIGraphicsGetCurrentContext).

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 4.2 и позже.

    См. также

    – drawPageAtIndex:inRect:
    – drawHeaderForPageAtIndex:inRect:
    – drawPrintFormatter:forPageAtIndex:
    – drawFooterForPageAtIndex:inRect:

  • drawPrintFormatter (_: forPageAtIndex:) - drawPrintFormatter:forPageAtIndex:

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

    Объявление

    Swift

    func drawPrintFormatter(_ printFormatter: UIPrintFormatter!, forPageAtIndex index: Int)

    Objective C

    - (void)drawPrintFormatter:(UIPrintFormatter *)printFormatter forPageAtIndex:(NSInteger)index

    Параметры

    printFormatter

    A UIPrintFormatter объект связался со страницей index.

    index

    Индекс тот, страницы, в который printFormatter должен нарисовать.

    Обсуждение

    Этот метод вызывается для каждого средства форматирования печати, присвоенного указанной странице. Реализация по умолчанию вызывает drawInRect:forPageAtIndex: метод UIPrintFormatter объект, передающийся в. Вы можете переопределить этот метод для смешивания пользовательского получения с получением средства форматирования — например, путем добавления наложения или лежали в основе графический. Вызвать drawInRect:forPageAtIndex: для имения средства форматирования печати рисуют его часть страницы. Метод устанавливается для рисования к текущему графическому контексту (как возвращено UIGraphicsGetCurrentContext).

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 4.2 и позже.

    См. также

    – drawPageAtIndex:inRect:
    – drawHeaderForPageAtIndex:inRect:
    – drawContentForPageAtIndex:inRect:
    – drawFooterForPageAtIndex:inRect:

  • drawFooterForPageAtIndex (_: inRect:) - drawFooterForPageAtIndex:inRect:

    Переопределенный для рисования нижнего колонтитула данной страницы.

    Объявление

    Swift

    func drawFooterForPageAtIndex(_ index: Int, inRect footerRect: CGRect)

    Objective C

    - (void)drawFooterForPageAtIndex:(NSInteger)index inRect:(CGRect)footerRect

    Параметры

    index

    Индекс страницы, на которой можно нарисовать содержание нижнего колонтитула.

    footerRect

    Прямоугольник, в котором должно быть нарисовано содержание нижнего колонтитула. Это указано в системе координат бумажного прямоугольника (paperRect); т.е. начало координат в верхнем левом углу листа.

    Обсуждение

    Реализация по умолчанию этого метода ничего не делает. Это не вызывают если footerHeight не положительное значение. Метод устанавливается для рисования к текущему графическому контексту (как возвращено UIGraphicsGetCurrentContext).

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 4.2 и позже.

    См. также

    – drawPageAtIndex:inRect:
    – drawHeaderForPageAtIndex:inRect:
    – drawContentForPageAtIndex:inRect:
    – drawPrintFormatter:forPageAtIndex: