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

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

Разработчик

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

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

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

UIPrintFormatter

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

UIPrintFormatter абстрактный базовый класс для средств форматирования печати: объекты, размечающие пользовательское печатаемое содержание, которое может пересечь границы страницы. Учитывая средство форматирования печати, система печати может автоматизировать печать типа содержания, связанного со средством форматирования печати.

Примерами такого содержания могло быть веб-представление, соединение изображений и текста или документа длинного текста. Платформа UIKit обеспечивает несколько конкретных подклассов UIPrintFormatter: UISimpleTextPrintFormatter, UIMarkupTextPrintFormatter, и UIViewPrintFormatter.

Можно присвоить единственное средство форматирования печати для задания печати через printFormatter свойство UIPrintInteractionController совместно используемый экземпляр; или можно указать одно или более средств форматирования печати, связанных с определенными страницами средства рендеринга страницы через addPrintFormatter:startingAtPageAtIndex:метод UIPrintPageRenderer. Средство рендеринга страницы является экземпляром пользовательского подкласса UIPrintPageRenderer это рисует содержание для печати.

UIPrintFormatter публикует интерфейс, позволяющий Вам указывать начальную страницу для задания печати и полей вокруг печатного содержания; учитывая, что информация плюс содержание, средство форматирования печати вычисляет число страниц для задания печати. Рисунок 1 изображает свойства средства форматирования печати, вместе с определенным UIPrintPaper и UIPrintPageRenderer свойства, определяющие расположение многостраничного задания печати.

Рисунок 1Layout печатного содержания image: ../Art/print_formatter_attrs.jpg

Сторонние подклассы UIPrintFormatter не рекомендуются. Если у Вас есть пользовательское содержание для печати, используйте пользовательское UIPrintPageRenderer объект.

Разметка содержания
  • contentInsets Свойство

    Расстояния края содержания вставляются от прямоугольника печати.

    Объявление

    Swift

    var contentInsets: UIEdgeInsets

    Objective C

    @property(nonatomic) UIEdgeInsets contentInsets

    Обсуждение

    Это свойство приводит поля в соответствие с содержанием, распечатанным средством форматирования. Прямоугольник печати определяет область, в которой принтер способен к печати; каждая вставка является входящим расстоянием, в точках, со стороны области печати. Главная вставка используется только на первой странице, которую рисует средство форматирования. Нижняя вставка не используется. Можно использовать UIEdgeInsetsMake макрос для создания a UIEdgeInsets структура.

    Значение по умолчанию этого свойства UIEdgeInsetsZero.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    maximumContentHeight
    maximumContentWidth

  • perPageContentInsets Свойство

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

    Объявление

    Swift

    var perPageContentInsets: UIEdgeInsets

    Objective C

    @property(nonatomic) UIEdgeInsets perPageContentInsets

    Обсуждение

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

    Значение по умолчанию этого свойства UIEdgeInsetsZero.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • maximumContentHeight Свойство

    Максимальная высота предметной области.

    Объявление

    Swift

    var maximumContentHeight: CGFloat

    Objective C

    @property(nonatomic) CGFloat maximumContentHeight

    Обсуждение

    UIPrintFormatter использование это значение для определения, где прямоугольник содержания начинается на первой странице. Это сравнивает значение этого свойства с высотой прямоугольника печати минус заголовок и высотами нижнего колонтитула и главное значение вставки ( contentInsets); это использует ниже двух значений. Значение по умолчанию этого свойства является максимальным значением плавающим.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    contentInsets
    maximumContentWidth

  • maximumContentWidth Свойство

    Максимальная ширина предметной области.

    Объявление

    Swift

    var maximumContentWidth: CGFloat

    Objective C

    @property(nonatomic) CGFloat maximumContentWidth

    Обсуждение

    UIPrintFormatter использование это значение для определения максимальной ширины прямоугольника содержания. Это сравнивает значение этого свойства с шириной прямоугольника печати минус левые и правые значения вставки и использует ниже двух. Значение по умолчанию этого свойства является максимальным значением плавающим.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    contentInsets
    maximumContentHeight

Управление разбиением на страницы
  • startPage Свойство

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

    Объявление

    Swift

    var startPage: Int

    Objective C

    @property(nonatomic) NSInteger startPage

    Обсуждение

    Значение является основанным на нуле индексом. Можно установить начальную страницу средства форматирования печати путем присвоения индекса этому свойству или путем передачи один как второй параметр addPrintFormatter:startingAtPageAtIndex: метод UIPrintPageRenderer.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    pageCount

  • pageCount Свойство

    Число страниц, которые будут распечатаны. (только для чтения)

    Объявление

    Swift

    var pageCount: Int { get }

    Objective C

    @property(nonatomic, readonly) NSInteger pageCount

    Обсуждение

    UIPrintFormatter вычисляет это значение на основе метрик расположения и содержания.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    начальная страница

Рисование содержания
  • drawInRect (_: forPageAtIndex:) - drawInRect:forPageAtIndex:

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

    Объявление

    Swift

    func drawInRect(_ rect: CGRect, forPageAtIndex pageIndex: Int)

    Objective C

    - (void)drawInRect:(CGRect)rect forPageAtIndex:(NSInteger)pageIndex

    Параметры

    rect

    Область, в которой можно нарисовать содержание.

    pageIndex

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

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – rectForPageAtIndex:

  • rectForPageAtIndex (_:) - rectForPageAtIndex:

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

    Объявление

    Swift

    func rectForPageAtIndex(_ pageIndex: Int) -> CGRect

    Objective C

    - (CGRect)rectForPageAtIndex:(NSInteger)pageIndex

    Параметры

    pageIndex

    Индекс страницы.

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

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

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – drawInRect:forPageAtIndex:

Связь со средством рендеринга страницы
  • removeFromPrintPageRenderer () - removeFromPrintPageRenderer

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

    Объявление

    Swift

    func removeFromPrintPageRenderer()

    Objective C

    - (void)removeFromPrintPageRenderer

    Обсуждение

    Средство форматирования печати обычно связывается со страницы a UIPrintPageRenderer объект через addPrintFormatter:startingAtPageAtIndex: метод.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • printPageRenderer Свойство

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

    Объявление

    Swift

    unowned(unsafe) var printPageRenderer: UIPrintPageRenderer! { get }

    Objective C

    @property(nonatomic, readonly, assign) UIPrintPageRenderer *printPageRenderer

    Обсуждение

    Если средство форматирования печати получения не было добавлено к средству рендеринга страницы — т.е. оно было присвоено printFormatter свойство UIPrintInteractionController класс — значение возвратилось, nil.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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