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

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

Разработчик

Ссылка платформы ApplicationServices базовая ссылка печати

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

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

Базовая ссылка печати

Базовой Печатью является API C, который приложения Mac и инструменты командной строки могут использовать для выполнения задач печати, не выводящих на экран пользовательский интерфейс. Базовая Печать определяет ряд непрозрачных типов и богатого набора операций на экземплярах этих типов. Базовые Распечатывающие непрозрачные типы включают:

  • PMPrintSession для получения общей информации о задании печати

  • PMPrintSettings для параметров задания печати

  • PMPageFormat для формата страниц печатного документа

  • PMPaper для получения информации о типе бумаги

  • PMPrinter для получения информации о принтере

В приложениях Углерода Базовая Печать используется вместе с Печатью Углерода для реализования опций печати. Для получения дополнительной информации о Печати Углерода, посмотрите, что Углерод Распечатывает Ссылку.

В приложениях Какао Базовая Печать может использоваться для расширения функциональности в классах печати Какао. NSPrintInfo класс обеспечивает прямой доступ к некоторым Базовым объектам Печати.

Функции

Выпуск и сохранение распечатывающих объектов
  • PMRelease (_:) PMRelease

    Выпускает объект печати путем постепенного уменьшения его подсчета ссылок.

    Объявление

    Swift

    func PMRelease(_ object: PMObject) -> OSStatus

    Objective C

    OSStatus PMRelease ( PMObject object );

    Параметры

    object

    Объект печати Вы хотите выпустить.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

    Например, для завершения сеанса печати, создаваемого с функцией PMCreateSession, передайте связанное PMPrintSession объект к PMRelease. Выпускать объекты печати, создаваемые с функциями PMCreatePageFormat и PMCreatePrintSettings, передайте связанное PMPageFormat и PMPrintSettings объекты к PMRelease.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMRetain

  • PMRetain (_:) PMRetain

    Сохраняет объект печати путем постепенного увеличения его подсчета ссылок.

    Объявление

    Swift

    func PMRetain(_ object: PMObject) -> OSStatus

    Objective C

    OSStatus PMRetain ( PMObject object );

    Параметры

    object

    Объект печати Вы хотите сохранить.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо сохранить объект печати при получении его откуда-либо (т.е. Вы не создавали или копировали его), и Вы хотите, чтобы он сохранился. При сохранении объекта печати Вы ответственны за выпуск его. (См. PMRelease.) Можно использовать функцию PMRetain постепенно увеличить подсчет ссылок объекта печати так, чтобы многократные потоки или подпрограммы могли использовать объект без риска другого потока или подпрограммы, освобождающей объект.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMRelease

Создавая и Используя объекты формата страниц
  • PMCreatePageFormat (_:) PMCreatePageFormat

    Создает новый объект формата страниц.

    Объявление

    Swift

    func PMCreatePageFormat(_ pageFormat: UnsafeMutablePointer<PMPageFormat>) -> OSStatus

    Objective C

    OSStatus PMCreatePageFormat ( PMPageFormat *pageFormat );

    Параметры

    pageFormat

    Указатель на Ваш PMPageFormat переменная. По возврату переменная относится к новому объекту формата страниц. Вы ответственны за выпуск объекта формата страниц с функцией PMRelease.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Эта функция выделяет память для нового объекта формата страниц в пространстве памяти Вашего приложения и устанавливает его подсчет ссылок в 1. Новый объект формата страниц пуст и неприменим, пока Вы не вызываете PMSessionDefaultPageFormat или PMCopyPageFormat.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMCreatePageFormatWithPMPaper (_: _:) PMCreatePageFormatWithPMPaper

    Создает объект формата страниц с указанной газетой.

    Объявление

    Swift

    func PMCreatePageFormatWithPMPaper(_ pageFormat: UnsafeMutablePointer<PMPageFormat>, _ paper: PMPaper) -> OSStatus

    Objective C

    OSStatus PMCreatePageFormatWithPMPaper ( PMPageFormat *pageFormat, PMPaper paper );

    Параметры

    pageFormat

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

    paper

    Тип бумаги для нового объекта формата страниц.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMCopyPageFormat (_: _:) PMCopyPageFormat

    Копирует настройки с одного объекта формата страниц в другого.

    Объявление

    Swift

    func PMCopyPageFormat(_ formatSrc: PMPageFormat, _ formatDest: PMPageFormat) -> OSStatus

    Objective C

    OSStatus PMCopyPageFormat ( PMPageFormat formatSrc, PMPageFormat formatDest );

    Параметры

    formatSrc

    Объект формата страниц копировать.

    formatDest

    Объект формата страниц получить скопированные настройки. По возврату этот объект содержит те же настройки как formatSrc объект.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMSessionDefaultPageFormat (_: _:) PMSessionDefaultPageFormat

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

    Объявление

    Swift

    func PMSessionDefaultPageFormat(_ printSession: PMPrintSession, _ pageFormat: PMPageFormat) -> OSStatus

    Objective C

    OSStatus PMSessionDefaultPageFormat ( PMPrintSession printSession, PMPageFormat pageFormat );

    Параметры

    printSession

    Сеанс печати для указанного объекта формата страниц.

    pageFormat

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

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать функцию PMSessionDefaultPageFormat между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMSessionValidatePageFormat (_: _: _:) PMSessionValidatePageFormat

    Обновляет значения в объекте формата страниц и проверяет их против текущего принтера форматирования.

    Объявление

    Swift

    func PMSessionValidatePageFormat(_ printSession: PMPrintSession, _ pageFormat: PMPageFormat, _ result: UnsafeMutablePointer<Boolean>) -> OSStatus

    Objective C

    OSStatus PMSessionValidatePageFormat ( PMPrintSession printSession, PMPageFormat pageFormat, Boolean *result );

    Параметры

    printSession

    Сеанс печати для указанного объекта формата страниц.

    pageFormat

    Объект формата страниц проверить.

    result

    Указатель на Вашу Логическую переменную. По возврату, true если функция установила объект формата страниц в значения по умолчанию; иначе, false.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession.

    Функция PMSessionValidatePageFormat проверяет объект формата страниц против текущего принтера форматирования. Принтер форматирования выведен на экран в Формате для всплывающего меню в диалоговом окне Установки Страницы. Принтер форматирования значения по умолчанию является обобщением Любой Принтер. Если объект формата страниц содержит значения, которые не допустимы для принтера форматирования, объект формата страниц установлен в значения по умолчанию и result параметр устанавливается на true.

    Проверка объекта формата страниц также заставляет вычисляемые поля (такие как скорректированная бумага и прямоугольники страницы) быть обновленными на основе измененных настроек (таких как разрешение, масштабирование и ориентация страницы). Если объект формата страниц содержит значения, которые допустимы для принтера форматирования, но должны быть обновлены, result параметр устанавливается на false.

    После того, как Вы вызовете любую функцию, вносящую изменения в объект формата страниц (такой как PMSetOrientation), необходимо вызвать функцию PMSessionValidatePageFormat для проверки формата страниц возражают перед использованием того объекта.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMSessionCreatePageFormatList (_: _: _:) PMSessionCreatePageFormatList

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

    Объявление

    Swift

    func PMSessionCreatePageFormatList(_ printSession: PMPrintSession, _ printer: PMPrinter, _ pageFormatList: UnsafeMutablePointer<Unmanaged<CFArray>?>) -> OSStatus

    Objective C

    OSStatus PMSessionCreatePageFormatList ( PMPrintSession printSession, PMPrinter printer, CFArrayRef *pageFormatList );

    Параметры

    printSession

    Текущий сеанс печати.

    printer

    Принтер, чей список размеров страницы Вы хотите перечислить.

    pageFormatList

    Указатель на Ваш CFArrayRef переменная. По возврату переменная относится к Базовому массиву Основы, содержащему формат страниц (PMPageFormat) объекты связались с указанным принтером. Вы ответственны за выпуск массива. Каждый объект формата страниц описывает формат бумаги, доступный для указанного принтера. Если функция перестала работать, то по возврату массив NULL.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession.

    Можно использовать эту функцию для нахождения доступных размеров листа (и область изображения для них) для данного принтера. После получения списка формата страниц можно вызвать функцию PMGetUnadjustedPaperRect поскольку каждый формат страниц возражает в списке для получения прямоугольного размера листа. Как только Вы находите формат бумаги, Вы хотите, вызываете PMGetUnadjustedPageRect получить область изображения для того формата бумаги.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPageFormatCreateDataRepresentation (_: _: _:) PMPageFormatCreateDataRepresentation

    Создает представление данных объекта формата страниц.

    Объявление

    Swift

    func PMPageFormatCreateDataRepresentation(_ pageFormat: PMPageFormat, _ data: UnsafeMutablePointer<Unmanaged<CFData>?>, _ format: PMDataFormat) -> OSStatus

    Objective C

    OSStatus PMPageFormatCreateDataRepresentation ( PMPageFormat pageFormat, CFDataRef *data, PMDataFormat format );

    Параметры

    pageFormat

    Объект формата страниц преобразовать.

    data

    Указатель на Ваш CFDataRef переменная. По возврату переменная относится к новому Базовому объекту данных Основы, содержащему представление указанного объекта формата страниц в указанном формате данных. Вы ответственны за выпуск объекта данных.

    format

    Константа, указывающая формат представления данных. Поддерживаемые значения:

    • kPMDataFormatXMLDefault (совместимый со всеми версиями OS X)

    • kPMDataFormatXMLMinimal (приблизительно в 3-5 раз меньший; совместимый с OS X v10.5 и позже)

    • kPMDataFormatXMLCompressed (приблизительно в 20 раз меньший; совместимый с OS X v10.5 и позже)

    Посмотрите Форматы Представления данных для полного описания этих форматов.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Эта функция обычно используется для преобразования объекта формата страниц в представление данных, подходящее для хранения в пользовательском документе. Для получения информации об использовании Базового объекта данных Основы см. Ссылку CFData.

    Прежде, чем вызвать эту функцию, необходимо вызвать функцию PMSessionValidatePageFormat для проверки объект формата страниц содержит допустимые значения.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMPageFormatCreateWithDataRepresentation

  • PMPageFormatCreateWithDataRepresentation (_: _:) PMPageFormatCreateWithDataRepresentation

    Создает объект формата страниц из представления данных.

    Объявление

    Swift

    func PMPageFormatCreateWithDataRepresentation(_ data: CFData!, _ pageFormat: UnsafeMutablePointer<PMPageFormat>) -> OSStatus

    Objective C

    OSStatus PMPageFormatCreateWithDataRepresentation ( CFDataRef data, PMPageFormat *pageFormat );

    Параметры

    data

    Представление данных объекта формата страниц. Представление данных, должно быть, было ранее создано с функцией PMPageFormatCreateDataRepresentation.

    pageFormat

    Указатель на Ваш PMPageFormat переменная. По возврату переменная относится к новому объекту формата страниц, содержащему информацию, хранившую в указанном объекте данных. Вы ответственны за выпуск объекта формата страниц с функцией PMRelease.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Эта функция обычно используется для преобразования представления данных, сохраненного в пользовательском документе назад в объект формата страниц. Для получения информации о создании Базового объекта данных Основы от необработанных данных см. Ссылку CFData.

    После вызывания этой функции необходимо вызвать функцию PMSessionValidatePageFormat для проверки объект формата страниц содержит допустимые значения.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMPageFormatCreateDataRepresentation

  • PMFlattenPageFormat PMFlattenPageFormat Доступный в OS X v10.0 через OS X v10.9

    Сглаживает объект формата страниц в дескриптор Диспетчера памяти для хранения в пользовательском документе.

    Оператор осуждения

    Использовать PMPageFormatCreateDataRepresentation вместо этого.

    Объявление

    Objective C

    OSStatus PMFlattenPageFormat ( PMPageFormat pageFormat, Handle *flatFormat );

    Параметры

    pageFormat

    Объект формата страниц сгладиться.

    flatFormat

    Указатель на Ваш Handle переменная. По возврату переменная относится к дескриптору Диспетчера памяти, содержащему сглаженный объект формата страниц. Дескриптор выделяется функцией. Вы ответственны за избавление от дескриптора.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    Не доступный 64-разрядным приложениям.

  • PMFlattenPageFormatToCFData PMFlattenPageFormatToCFData Доступный в OS X v10.4 через OS X v10.9

    Сглаживает объект формата страниц в Базовый объект данных Основы для хранения в пользовательском документе.

    Оператор осуждения

    Использовать PMPageFormatCreateDataRepresentation вместо этого.

    Объявление

    Objective C

    OSStatus PMFlattenPageFormatToCFData ( PMPageFormat pageFormat, CFDataRef *flatFormat );

    Параметры

    pageFormat

    Объект формата страниц сгладиться.

    flatFormat

    Указатель на Ваш CFDataRef переменная. По возврату переменная относится к Базовому объекту данных Основы, содержащему сглаженное представление указанного объекта формата страниц. Вы ответственны за выпуск объекта данных.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.4 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    См. также

    PMUnflattenPageFormatWithCFData

  • PMFlattenPageFormatToURL PMFlattenPageFormatToURL Доступный в OS X v10.4 через OS X v10.9

    Сглаживает объект формата страниц в файл для хранения в пользовательском документе.

    Оператор осуждения

    Использовать PMPageFormatCreateDataRepresentation и запишите получающиеся данные своему месту назначения.

    Объявление

    Objective C

    OSStatus PMFlattenPageFormatToURL ( PMPageFormat pageFormat, CFURLRef flattenFileURL );

    Параметры

    pageFormat

    Объект формата страниц сгладиться.

    flatFormat

    Базовая Основа URL, указывающий файл для содержания сглаженное представление указанного объекта формата страниц. Если файл уже существует, он перезаписывается. Только основанный на файле URLs поддерживается.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.4 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    См. также

    PMUnflattenPageFormatWithURL

  • PMUnflattenPageFormat PMUnflattenPageFormat Доступный в OS X v10.0 через OS X v10.9

    Восстанавливает объект формата страниц от дескриптора Диспетчера памяти, содержащего сглаженные данные формата страниц.

    Оператор осуждения

    Использовать PMPageFormatCreateWithDataRepresentation вместо этого.

    Объявление

    Objective C

    OSStatus PMUnflattenPageFormat ( Handle flatFormat, PMPageFormat *pageFormat );

    Параметры

    flatFormat

    Дескриптор к ранее сглаженному объекту формата страниц. Вы ответственны за избавление от дескриптора.

    pageFormat

    Указатель на Ваш PMPageFormat переменная. По возврату переменная относится к объекту формата страниц, содержащему полученные данные от сглаженных данных формата страниц. Вы ответственны за выпуск объекта формата страниц с функцией PMRelease.

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

    Код результата. Посмотрите Базовые Коды Результата Печати. Код результата kPMInvalidParameter возвращается если сглаженный PMPageFormat объект создавался несовместимой версией Базовой Печати.

    Обсуждение

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

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

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    Не доступный 64-разрядным приложениям.

  • PMUnflattenPageFormatWithCFData PMUnflattenPageFormatWithCFData Доступный в OS X v10.4 через OS X v10.9

    Восстанавливает объект формата страниц от Базового объекта данных Основы, содержащего сглаженные данные формата страниц.

    Оператор осуждения

    Использовать PMPageFormatCreateWithDataRepresentation вместо этого.

    Объявление

    Objective C

    OSStatus PMUnflattenPageFormatWithCFData ( CFDataRef flattenCFData, PMPageFormat *pageFormat );

    Параметры

    flattenCFData

    Базовый объект данных Основы, содержащий сглаженное представление объекта формата страниц.

    pageFormat

    Указатель на Ваш PMPageFormat переменная. По возврату переменная относится к объекту формата страниц, восстановленному от указанного Базового объекта данных Основы. Вы ответственны за выпуск объекта формата страниц с функцией PMRelease.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.4 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    См. также

    PMFlattenPageFormatToCFData

  • PMUnflattenPageFormatWithURL PMUnflattenPageFormatWithURL Доступный в OS X v10.4 через OS X v10.9

    Восстанавливает объект формата страниц от файловой системы URL, содержащий сглаженные данные формата страниц.

    Оператор осуждения

    Вместо этого считайте данные в объект CFData и использование PMPageFormatCreateWithDataRepresentation.

    Объявление

    Objective C

    OSStatus PMUnflattenPageFormatWithURL ( CFURLRef flattenFileURL, PMPageFormat *pageFormat );

    Параметры

    flattenFileURL

    Базовый URL Основы, указывающий файл, содержащий сглаженное представление объекта формата страниц.

    pageFormat

    Указатель на Ваш PMPageFormat переменная. По возврату переменная относится к объекту формата страниц, восстановленному от указанного файла. Вы ответственны за выпуск объекта формата страниц с функцией PMRelease.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.4 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    См. также

    PMFlattenPageFormatToURL

Доступ к данным в объектах формата страниц
  • PMGetPageFormatExtendedData (_: _: _: _:) PMGetPageFormatExtendedData

    Получает расширенные данные формата страниц, ранее хранившие Вашим приложением.

    Объявление

    Swift

    func PMGetPageFormatExtendedData(_ pageFormat: PMPageFormat, _ dataID: OSType, _ size: UnsafeMutablePointer<UInt32>, _ extendedData: UnsafeMutablePointer<Void>) -> OSStatus

    Objective C

    OSStatus PMGetPageFormatExtendedData ( PMPageFormat pageFormat, OSType dataID, UInt32 *size, void *extendedData );

    Параметры

    pageFormat

    Объект формата страниц, содержащий Ваши расширенные данные.

    dataID

    4 кода символа, идентифицирующие Ваши данные. Это обычно - код создателя Вашего приложения. Если Ваш код создателя является вне ASCII 7-разрядным диапазоном символов 0x20–0x7F, необходимо использовать различный 4 кода символа.

    size

    Указатель на значение, указывающее размер буфера, который Вы выделили для расширенных данных формата страниц. По возврату эта переменная содержит число чтения байтов в буфер или размер расширенных данных. Можно передать константу kPMDontWantSize если Вам не нужна эта информация. (См. Данные Не Требуемые Константы для получения дополнительной информации.)

    extendedData

    Указатель на буфер для получения расширенных данных. Передайте константу kPMDontWantData если Вы не хотите считывать данные. (См. Данные Не Требуемые Константы для получения дополнительной информации.)

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMSetPageFormatExtendedData

  • PMSetPageFormatExtendedData (_: _: _: _:) PMSetPageFormatExtendedData

    Хранит Ваши специализированные данные в объекте формата страниц.

    Объявление

    Swift

    func PMSetPageFormatExtendedData(_ pageFormat: PMPageFormat, _ dataID: OSType, _ size: UInt32, _ extendedData: UnsafeMutablePointer<Void>) -> OSStatus

    Objective C

    OSStatus PMSetPageFormatExtendedData ( PMPageFormat pageFormat, OSType dataID, UInt32 size, void *extendedData );

    Параметры

    pageFormat

    Объект формата страниц, в котором можно хранить Ваши расширенные данные.

    dataID

    4 кода символа, идентифицирующие Ваши данные. Это обычно - код создателя Вашего приложения. Если Ваш код создателя является вне ASCII 7-разрядным диапазоном символов 0x20–0x7F, необходимо использовать различный 4 кода символа.

    size

    Размер, в байтах, данных, которые будут сохранены в объекте формата страниц.

    extendedData

    Указатель на специализированные данные Вы хотите сохранить в объекте формата страниц.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Можно получить данные, которые Вы храните с функцией PMSetPageFormatExtendedData путем вызывания функции PMGetPageFormatExtendedData.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMGetPageFormatExtendedData

  • PMGetPageFormatPaper (_: _:) PMGetPageFormatPaper

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

    Объявление

    Swift

    func PMGetPageFormatPaper(_ pageFormat: PMPageFormat, _ paper: UnsafeMutablePointer<PMPaper>) -> OSStatus

    Objective C

    OSStatus PMGetPageFormatPaper ( PMPageFormat format, PMPaper *paper );

    Параметры

    pageFormat

    Объект формата страниц, бумагу которого Вы хотите получить.

    paper

    Указатель на Ваш PMPaper переменная. По возврату переменная относится к бумажному объекту, представляющему бумагу, связанную с указанным форматом страниц. Вы не должны выпускать бумажный объект без первого сохранения его.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPageFormatGetPrinterID (_: _:) PMPageFormatGetPrinterID

    Получает идентификатор принтера форматирования для объекта формата страниц.

    Объявление

    Swift

    func PMPageFormatGetPrinterID(_ pageFormat: PMPageFormat, _ printerID: UnsafeMutablePointer<Unmanaged<CFString>?>) -> OSStatus

    Objective C

    OSStatus PMPageFormatGetPrinterID ( PMPageFormat pageFormat, CFStringRef *printerID );

    Параметры

    pageFormat

    Объект формата страниц, идентификатор принтера которого Вы хотите получить.

    printerID

    Указатель на Ваш CFStringRef переменная. По возврату переменная относится к Базовой строке Основы, содержащей идентификатор принтера форматирования для указанного объекта формата страниц. Если объект формата страниц не имеет той информации, переменная установлена в NULL. Вы не должны выпускать строку без первого сохранения его.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Объекты формата страниц могут быть созданы, много различных путей и некоторые из них не требуют определенного принтера. Если принтер в Формате диалогового окна Установки Страницы для всплывающего меню, ID известен, принтер выведен на экран. Если принтер обобщением Какой-либо Принтер, ID не известен, принтер форматирования значения по умолчанию является, система печати обеспечивает страницу по умолчанию и форматы бумаги для универсального принтера.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMGetOrientation (_: _:) PMGetOrientation

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

    Объявление

    Swift

    func PMGetOrientation(_ pageFormat: PMPageFormat, _ orientation: UnsafeMutablePointer<PMOrientation>) -> OSStatus

    Objective C

    OSStatus PMGetOrientation ( PMPageFormat pageFormat, PMOrientation *orientation );

    Параметры

    pageFormat

    Объект формата страниц, ориентацию которого Вы хотите получить.

    orientation

    Указатель на Ваш PMOrientation переменная. По возврату переменная содержит постоянное значение, указывающее ориентацию страницы. Поддерживаемые значения:

    • kPMPortrait

    • kPMLandscape

    • kPMReversePortrait (поддерживаемый в OS X v10.5 и позже)

    • kPMReverseLandscape

    Посмотрите Константы Ориентации Страницы для полного описания констант ориентации страницы.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMSetOrientation

  • PMSetOrientation (_: _: _:) PMSetOrientation

    Устанавливает ориентацию страницы для печати.

    Объявление

    Swift

    func PMSetOrientation(_ pageFormat: PMPageFormat, _ orientation: PMOrientation, _ lock: Boolean) -> OSStatus

    Objective C

    OSStatus PMSetOrientation ( PMPageFormat pageFormat, PMOrientation orientation, Boolean lock );

    Параметры

    pageFormat

    Объект формата страниц, ориентацию страницы которого Вы хотите установить.

    orientation

    Постоянное указание желаемой ориентации страницы. Поддерживаемые значения:

    • kPMPortrait

    • kPMLandscape

    • kPMReversePortrait (OS X v10.5 и позже)

    • kPMReverseLandscape

    Посмотрите Константы Ориентации Страницы для полного описания значений, которые можно использовать для указания ориентации страницы.

    lock

    Состояние блокировки установки. Необходимо передать kPMUnlocked. В это время не поддерживается блокировка.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Специальные замечания

    В OS X v10.4 и ранее, если Вы хотите установить ориентацию страницы, необходимо вызвать эту функцию прежде, чем инициировать задание печати (например, путем вызова PMSessionBeginCGDocument). Ориентация страницы, которую Вы устанавливаете, применяется ко всему заданию печати. В OS X v10.5 и позже, можно использовать эту функцию для изменения ориентации отдельной страницы в задании печати путем передачи обновленного формата страниц PMSessionBeginPage или PMSessionBeginPageNoDialog.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMGetOrientation

  • PMGetResolution PMGetResolution Доступный в OS X v10.0 через OS X v10.9

    Получает разрешение получения текущего приложения.

    Оператор осуждения

    Нарисуйте 2D Кварц использования и вызов CGContextScaleCTM вместо этого.

    Объявление

    Objective C

    OSStatus PMGetResolution ( PMPageFormat pageFormat, PMResolution *res );

    Параметры

    pageFormat

    Объект формата страниц, рисование которого разрешения Вы хотите получить.

    res

    Указатель на Ваш PMResolution структура. По возврату структура содержит разрешение получения текущего приложения.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Эта функция получает разрешение получения, указанное в формате страниц, не разрешении текущего принтера. Можно использовать PMPrinterGetPrinterResolutionCount и PMPrinterGetIndexedPrinterResolution исследовать доступные разрешения принтера.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    Не доступный 64-разрядным приложениям.

  • PMSetResolution PMSetResolution Доступный в OS X v10.0 через OS X v10.9

    Устанавливает приложение, получающее разрешение.

    Оператор осуждения

    Нарисуйте 2D Кварц использования и вызов CGContextScaleCTM вместо этого.

    Объявление

    Objective C

    OSStatus PMSetResolution ( PMPageFormat pageFormat, const PMResolution *res );

    Параметры

    pageFormat

    Объект формата страниц, рисование которого разрешения Вы хотите установить.

    res

    Указатель на структуру типа PMResolution это указывает желаемое разрешение получения для Вашего приложения. Необходимо указать лучшее разрешение для данных. Система печати обрабатывает отображение между разрешением, которое Вы указываете и разрешение принтера.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

    Специальные замечания

    Эта функция была необходима в прошлом, потому что QuickDraw использует целочисленные координаты и не имеет никакого понятия масштабирования систем координат. Для Кварцевого получения эта функция является устаревшей. Для изменения разрешения нарисуйте с дробными координатами или масштабируйте систему координат и нарисуйте с целочисленными координатами.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    Не доступный 64-разрядным приложениям.

  • PMGetScale (_: _:) PMGetScale

    Получает масштабный коэффициент, в настоящее время применялся к бумажные прямоугольники и страница.

    Объявление

    Swift

    func PMGetScale(_ pageFormat: PMPageFormat, _ scale: UnsafeMutablePointer<Double>) -> OSStatus

    Objective C

    OSStatus PMGetScale ( PMPageFormat pageFormat, double *scale );

    Параметры

    pageFormat

    Объект формата страниц, масштабный коэффициент которого Вы хотите получить.

    scale

    Указатель на Вашу переменную двойной точности. По возврату переменная содержит масштабный коэффициент, выраженный как процент. Например, значение 100,0 средних значений 100 процентов (т.е. никакое масштабирование); значение 50,0 средних масштабирований 50 процентов.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMSetScale

  • PMSetScale (_: _:) PMSetScale

    Устанавливает масштабный коэффициент для бумажных прямоугольников и страницы.

    Объявление

    Swift

    func PMSetScale(_ pageFormat: PMPageFormat, _ scale: Double) -> OSStatus

    Objective C

    OSStatus PMSetScale ( PMPageFormat pageFormat, double scale );

    Параметры

    pageFormat

    Объект формата страниц, масштабный коэффициент которого Вы хотите установить.

    scale

    Желаемый масштабный коэффициент, выраженный как процент. Например, для масштабирования 50 процентов, передайте значение 50,0; ни для какого масштабирования передайте 100.0.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Можно вызвать функцию PMSetScale изменить масштабный коэффициент, появляющийся, когда Ваше приложение вызывает диалоговое окно Установки Страницы.

    Если Вы вызываете PMSetScale после вызова PMSessionPageSetupDialog, удостоверьтесь, что Вы вызываете PMSessionValidatePageFormat перед вызовом PMSessionBeginCGDocument или PMSessionBeginDocument.

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMGetScale

  • PMGetAdjustedPageRect (_: _:) PMGetAdjustedPageRect

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

    Объявление

    Swift

    func PMGetAdjustedPageRect(_ pageFormat: PMPageFormat, _ pageRect: UnsafeMutablePointer<PMRect>) -> OSStatus

    Objective C

    OSStatus PMGetAdjustedPageRect ( PMPageFormat pageFormat, PMRect *pageRect );

    Параметры

    pageFormat

    Объект формата страниц, скорректированный прямоугольник страницы которого Вы хотите получить.

    pageRect

    Указатель на Ваш PMRect структура. По возврату структура содержит текущую область изображения, в точках, принимая во внимание масштабирование, вращение и настройки разрешения приложения. Прямоугольник страницы является областью страницы, к которой приложение может нарисовать. Координаты для верхнего левого угла прямоугольника страницы (0,0). Посмотрите, что Поддержка Распечатывает в Вашем Приложении Углерода для получения дополнительной информации о бумажных прямоугольниках и странице.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMSetAdjustedPageRect PMSetAdjustedPageRect Доступный в OS X v10.0 через OS X v10.9

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

    Оператор осуждения

    Для установки определенного формата бумаги и полей получите или создайте a PMPaper объект и вызов PMCreatePageFormatWithPMPaper.

    Объявление

    Objective C

    OSStatus PMSetAdjustedPageRect ( PMPageFormat pageFormat, const PMRect *pageRect );

    Параметры

    pageFormat

    Объект формата страниц, прямоугольник страницы которого Вы хотите установить.

    pageRect

    Указатель на Ваш PMRect структура данных, указывающая желаемый размер прямоугольника страницы в точках. Верхние левые координаты должны быть (0,0). Посмотрите, что Поддержка Распечатывает в Вашем Приложении Углерода для получения дополнительной информации о бумажных прямоугольниках и странице.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Эта функция не рекомендуется. Необходимо вызвать эту функцию, только если приложение обеспечивает настольную издательскую систему, и диалоговое окно Установки Страницы не обеспечивает достаточное управление. Как правило, такие приложения выводят на экран свое собственное специализированное диалоговое окно формата документа.

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

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

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    Не доступный 64-разрядным приложениям.

  • PMGetAdjustedPaperRect (_: _:) PMGetAdjustedPaperRect

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

    Объявление

    Swift

    func PMGetAdjustedPaperRect(_ pageFormat: PMPageFormat, _ paperRect: UnsafeMutablePointer<PMRect>) -> OSStatus

    Objective C

    OSStatus PMGetAdjustedPaperRect ( PMPageFormat pageFormat, PMRect *paperRect );

    Параметры

    pageFormat

    Объект формата страниц, скорректированный бумажный прямоугольник которого Вы хотите получить.

    paperRect

    Указатель на Ваш PMRect структура. По возврату структура описывает текущий формат бумаги, в точках, принимая во внимание масштабирование, вращение и настройки разрешения приложения. Координаты верхнего левого угла бумажного прямоугольника указаны относительно прямоугольника страницы. Координаты верхнего левого угла прямоугольника страницы всегда (0,0), что означает, что координаты верхнего левого угла бумажного прямоугольника всегда отрицательны или (0,0). Посмотрите, что Поддержка Распечатывает в Вашем Приложении Углерода для получения дополнительной информации о бумажных прямоугольниках и странице.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMGetUnadjustedPageRect (_: _:) PMGetUnadjustedPageRect

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

    Объявление

    Swift

    func PMGetUnadjustedPageRect(_ pageFormat: PMPageFormat, _ pageRect: UnsafeMutablePointer<PMRect>) -> OSStatus

    Objective C

    OSStatus PMGetUnadjustedPageRect ( PMPageFormat pageFormat, PMRect *pageRect );

    Параметры

    pageFormat

    Объект формата страниц, неприспособленный прямоугольник страницы которого Вы хотите получить.

    pageRect

    Указатель на Ваш PMRect структура данных. По возврату структура содержит размер прямоугольника страницы в точках. Прямоугольник страницы является областью страницы, к которой приложение может нарисовать. Координаты для верхнего левого угла прямоугольника страницы (0,0). Посмотрите, что Поддержка Распечатывает в Вашем Приложении Углерода для получения дополнительной информации о бумажных прямоугольниках и странице.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMGetUnadjustedPaperRect (_: _:) PMGetUnadjustedPaperRect

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

    Объявление

    Swift

    func PMGetUnadjustedPaperRect(_ pageFormat: PMPageFormat, _ paperRect: UnsafeMutablePointer<PMRect>) -> OSStatus

    Objective C

    OSStatus PMGetUnadjustedPaperRect ( PMPageFormat pageFormat, PMRect *paperRect );

    Параметры

    pageFormat

    Объект формата страниц, неприспособленный бумажный прямоугольник которого Вы хотите получить.

    paperRect

    Указатель на Ваш PMRect структура данных. По возврату структура содержит физический размер бумаги в точках. Координаты верхнего левого угла бумажного прямоугольника указаны относительно прямоугольника страницы. Координаты верхнего левого угла прямоугольника страницы всегда (0,0), что означает, что координаты верхнего левого угла бумажного прямоугольника всегда отрицательны или (0,0). Посмотрите, что Поддержка Распечатывает в Вашем Приложении Углерода для получения дополнительной информации о бумажных прямоугольниках и странице.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMSetUnadjustedPaperRect PMSetUnadjustedPaperRect Доступный в OS X v10.0 через OS X v10.9

    Запрашивает определенный формат бумаги, незатронутый попеременно, разрешение или масштабирование.

    Оператор осуждения

    Для установки определенного формата бумаги получите или создайте a PMPaper объект и вызов PMCreatePageFormatWithPMPaper.

    Объявление

    Objective C

    OSStatus PMSetUnadjustedPaperRect ( PMPageFormat pageFormat, const PMRect *paperRect );

    Параметры

    pageFormat

    Объект формата страниц, неприспособленный бумажный прямоугольник которого Вы хотите установить.

    paperRect

    Указатель на структуру типа PMRect это указывает желаемый формат бумаги в точках. Координаты верхнего левого угла бумажного прямоугольника указаны относительно прямоугольника страницы. Посмотрите, что Поддержка Распечатывает в Вашем Приложении Углерода для получения дополнительной информации о бумажных прямоугольниках и странице.

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

    Код результата. Посмотрите Базовые Коды Результата Печати. Код результата kPMValueOutOfRange указывает, что драйвер принтера не поддерживает требуемый размер страницы.

    Обсуждение

    Эта функция не рекомендуется. Необходимо вызвать эту функцию, только если приложение обеспечивает настольную издательскую систему, и диалоговое окно Установки Страницы не обеспечивает достаточное управление. Как правило, такие приложения выводят на экран свое собственное специализированное диалоговое окно формата документа.

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

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

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    Не доступный 64-разрядным приложениям.

Создавая и Используя объекты настроек печати
  • PMCreatePrintSettings (_:) PMCreatePrintSettings

    Создает новый объект настроек печати.

    Объявление

    Swift

    func PMCreatePrintSettings(_ printSettings: UnsafeMutablePointer<PMPrintSettings>) -> OSStatus

    Objective C

    OSStatus PMCreatePrintSettings ( PMPrintSettings *printSettings );

    Параметры

    printSettings

    Указатель на Ваш PMPrintSettings переменная. По возврату переменная относится к новому объекту настроек печати. Вы ответственны за выпуск объекта настроек печати с функцией PMRelease.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Эта функция выделяет память для нового объекта настроек печати в пространстве памяти Вашего приложения и устанавливает его подсчет ссылок в 1. Новый объект настроек печати пуст и неприменим, пока Вы не вызываете PMSessionDefaultPrintSettings или PMCopyPrintSettings.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMSessionDefaultPrintSettings (_: _:) PMSessionDefaultPrintSettings

    Присваивает значения параметров по умолчанию объекту настроек печати для указанного сеанса печати.

    Объявление

    Swift

    func PMSessionDefaultPrintSettings(_ printSession: PMPrintSession, _ printSettings: PMPrintSettings) -> OSStatus

    Objective C

    OSStatus PMSessionDefaultPrintSettings ( PMPrintSession printSession, PMPrintSettings printSettings );

    Параметры

    printSession

    Сеанс печати для указанного объекта настроек печати.

    printSettings

    Настройки печати возражают, которому Вы хотите присвоить значения по умолчанию.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать функцию PMSessionDefaultPrintSettings между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMSessionValidatePrintSettings (_: _: _:) PMSessionValidatePrintSettings

    Проверяет объект настроек печати в контексте указанного сеанса печати.

    Объявление

    Swift

    func PMSessionValidatePrintSettings(_ printSession: PMPrintSession, _ printSettings: PMPrintSettings, _ result: UnsafeMutablePointer<Boolean>) -> OSStatus

    Objective C

    OSStatus PMSessionValidatePrintSettings ( PMPrintSession printSession, PMPrintSettings printSettings, Boolean *result );

    Параметры

    printSession

    Сеанс печати для указанного объекта настроек печати.

    printSettings

    Настройки печати возражают для проверки.

    result

    Указатель на Вашу Логическую переменную. По возврату, true если какие-либо параметры изменились, или false если не изменились никакие параметры.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrintSettingsCreateDataRepresentation (_: _: _:) PMPrintSettingsCreateDataRepresentation

    Создает представление данных объекта настроек печати.

    Объявление

    Swift

    func PMPrintSettingsCreateDataRepresentation(_ printSettings: PMPrintSettings, _ data: UnsafeMutablePointer<Unmanaged<CFData>?>, _ format: PMDataFormat) -> OSStatus

    Objective C

    OSStatus PMPrintSettingsCreateDataRepresentation ( PMPrintSettings printSettings, CFDataRef *data, PMDataFormat format );

    Параметры

    printSettings

    Настройки печати возражают для преобразования.

    data

    Указатель на Ваш CFDataRef переменная. По возврату переменная относится к новому Базовому объекту данных Основы, содержащему представление указанного объекта настроек печати в указанном формате данных. Вы ответственны за выпуск объекта данных.

    format

    Константа, указывающая формат представления данных. Поддерживаемые значения:

    • kPMDataFormatXMLDefault (совместимый со всеми версиями OS X)

    • kPMDataFormatXMLMinimal (приблизительно в 3-5 раз меньший; совместимый с OS X v10.5 и позже)

    • kPMDataFormatXMLCompressed (приблизительно в 20 раз меньший; совместимый с OS X v10.5 и позже)

    Посмотрите Форматы Представления данных для полного описания этих форматов.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Эта функция обычно используется для преобразования объекта настроек печати в представление данных, подходящее для хранения в пользовательском документе. Для получения информации об использовании Базового объекта данных Основы см. Ссылку CFData.

    Прежде, чем вызвать эту функцию, необходимо вызвать функцию PMSessionValidatePrintSettings для проверки объект настроек печати содержит допустимые значения.

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMPrintSettingsCreateWithDataRepresentation

  • PMPrintSettingsCreateWithDataRepresentation (_: _:) PMPrintSettingsCreateWithDataRepresentation

    Создает объект настроек печати из представления данных.

    Объявление

    Swift

    func PMPrintSettingsCreateWithDataRepresentation(_ data: CFData!, _ printSettings: UnsafeMutablePointer<PMPrintSettings>) -> OSStatus

    Objective C

    OSStatus PMPrintSettingsCreateWithDataRepresentation ( CFDataRef data, PMPrintSettings *printSettings );

    Параметры

    data

    Представление данных объекта настроек печати. Представление данных, должно быть, было ранее создано с функцией PMPrintSettingsCreateDataRepresentation.

    printSettings

    Указатель на Ваш PMPrintSettings переменная. По возврату переменная относится к новому объекту настроек печати, содержащему информацию печати, хранившую в указанном объекте данных. Вы ответственны за выпуск объекта настроек печати с функцией PMRelease.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Эта функция обычно используется для преобразования представления данных, сохраненного в пользовательском документе назад в объект настроек печати. Для получения информации о создании Базового объекта данных Основы от необработанных данных см. Ссылку CFData.

    После вызывания этой функции необходимо вызвать функцию PMSessionValidatePrintSettings для проверки объект настроек печати содержит допустимые значения.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMPrintSettingsCreateDataRepresentation

  • PMFlattenPrintSettings PMFlattenPrintSettings Доступный в OS X v10.0 через OS X v10.9

    Сглаживает объект настроек печати в дескриптор Диспетчера памяти для хранения в пользовательском документе.

    Оператор осуждения

    Использовать PMPrintSettingsCreateDataRepresentation вместо этого.

    Объявление

    Objective C

    OSStatus PMFlattenPrintSettings ( PMPrintSettings printSettings, Handle *flatSettings );

    Параметры

    printSettings

    Настройки печати возражают для выравнивания.

    flatSettings

    Указатель на Ваш Handle переменная. По возврату переменная относится к дескриптору Диспетчера памяти, содержащему сглаженный объект настроек печати. Дескриптор выделяется функцией. Вы ответственны за избавление от дескриптора.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

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

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    Не доступный 64-разрядным приложениям.

  • PMFlattenPrintSettingsToCFData PMFlattenPrintSettingsToCFData Доступный в OS X v10.4 через OS X v10.9

    Сглаживает объект настроек печати в Базовый объект данных Основы для хранения в пользовательском документе.

    Оператор осуждения

    Использовать PMPrintSettingsCreateDataRepresentation вместо этого.

    Объявление

    Objective C

    OSStatus PMFlattenPrintSettingsToCFData ( PMPrintSettings printSettings, CFDataRef *flatSetting );

    Параметры

    printSettings

    Настройки печати возражают для выравнивания.

    flatSetting

    Указатель на Ваш CFDataRef переменная. По возврату переменная относится к Базовому объекту данных Основы, содержащему сглаженное представление указанного объекта настроек печати. Вы ответственны за выпуск объекта данных.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.4 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    См. также

    PMUnflattenPrintSettingsWithCFData

  • PMFlattenPrintSettingsToURL PMFlattenPrintSettingsToURL Доступный в OS X v10.4 через OS X v10.9

    Сглаживает объект настроек печати в URL для хранения в пользовательском документе.

    Оператор осуждения

    Вместо этого используйте PMPrintSettingsCreateDataRepresentation и запишите получающиеся данные своему месту назначения.

    Объявление

    Objective C

    OSStatus PMFlattenPrintSettingsToURL ( PMPrintSettings printSettings, CFURLRef flattenFileURL );

    Параметры

    printSettings

    Настройки печати возражают для выравнивания.

    flattenFileURL

    Базовая Основа URL, указывающий файл для содержания сглаженное представление указанного объекта настроек печати. Если файл уже существует, он перезаписывается. Только основанный на файле URLs поддерживается.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.4 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    См. также

    PMUnflattenPrintSettingsWithURL

  • PMUnflattenPrintSettings PMUnflattenPrintSettings Доступный в OS X v10.0 через OS X v10.9

    Восстанавливает объект настроек печати от дескриптора Диспетчера памяти, содержащего сглаженные данные настроек печати.

    Оператор осуждения

    Использовать PMPrintSettingsCreateWithDataRepresentation вместо этого.

    Объявление

    Objective C

    OSStatus PMUnflattenPrintSettings ( Handle flatSettings, PMPrintSettings *printSettings );

    Параметры

    flatSettings

    Дескриптор к сглаженному представлению объекта настроек печати.

    printSettings

    Указатель на Ваш PMPrintSettings переменная. По возврату переменная относится к объекту настроек печати, содержащему полученные данные от сглаженных настроек печати. Вы ответственны за выпуск объекта настроек печати с функцией PMRelease.

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

    Код результата. Посмотрите Базовые Коды Результата Печати. Код результата kPMInvalidParameter возвращается если сглаженный PMPrintSettings объект создавался несовместимой версией Базовой Печати.

    Обсуждение

    PMUnflattenPrintSettings функция создает новое PMPrintSettings объект, содержащий данные от сглаженных настроек печати. Необходимо вызвать функцию PMSessionValidatePrintSettings, поскольку некоторые значения в объекте настроек печати больше могут не быть допустимыми.

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

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

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    Не доступный 64-разрядным приложениям.

  • PMUnflattenPrintSettingsWithCFData PMUnflattenPrintSettingsWithCFData Доступный в OS X v10.4 через OS X v10.9

    Восстанавливает объект настроек печати от Базового объекта данных Основы, содержащего сглаженные данные настроек печати.

    Оператор осуждения

    Использовать PMPrintSettingsCreateWithDataRepresentation вместо этого.

    Объявление

    Objective C

    OSStatus PMUnflattenPrintSettingsWithCFData ( CFDataRef flattenCFData, PMPrintSettings *printSettings );

    Параметры

    flattenCFData

    Сглаженное представление объекта настроек печати.

    printSettings

    Указатель на Ваш PMPrintSettings переменная. По возврату переменная относится к объекту настроек печати, восстановленному от указанного Базового объекта данных Основы. Вы ответственны за выпуск объекта настроек печати с функцией PMRelease.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.4 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    См. также

    PMFlattenPrintSettingsToCFData

  • PMUnflattenPrintSettingsWithURL PMUnflattenPrintSettingsWithURL Доступный в OS X v10.4 через OS X v10.9

    Восстанавливает объект настроек печати от файла, содержащего сглаженные данные настроек печати.

    Оператор осуждения

    Вместо этого считайте данные в объект CFData и использование PMPrintSettingsCreateWithDataRepresentation.

    Объявление

    Objective C

    OSStatus PMUnflattenPrintSettingsWithURL ( CFURLRef flattenFileURL, PMPrintSettings *printSettings );

    Параметры

    flattenFileURL

    Файл, содержащий сглаженное представление объекта настроек печати.

    printSettings

    Указатель на Ваш PMPrintSettings переменная. По возврату переменная относится к объекту настроек печати, восстановленному от указанного файла. Вы ответственны за выпуск объекта настроек печати с функцией PMRelease.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.4 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    См. также

    PMFlattenPrintSettingsToURL

  • PMCopyPrintSettings (_: _:) PMCopyPrintSettings

    Копирует настройки с одного объекта настроек печати в другого.

    Объявление

    Swift

    func PMCopyPrintSettings(_ settingSrc: PMPrintSettings, _ settingDest: PMPrintSettings) -> OSStatus

    Objective C

    OSStatus PMCopyPrintSettings ( PMPrintSettings settingSrc, PMPrintSettings settingDest );

    Параметры

    settingSrc

    Настройки печати возражают для дублирования.

    settingDest

    Настройки печати возражают для получения скопированных настроек. По возврату этот объект содержит те же настройки как settingSrc объект.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrintSettingsToOptions (_: _:) PMPrintSettingsToOptions

    Преобразовывает настройки печати в строку опций CUPS.

    Объявление

    Swift

    func PMPrintSettingsToOptions(_ settings: PMPrintSettings, _ options: UnsafeMutablePointer<UnsafeMutablePointer<Int8>>) -> OSStatus

    Objective C

    OSStatus PMPrintSettingsToOptions ( PMPrintSettings settings, char **options );

    Параметры

    settings

    Настройки печати для преобразования.

    options

    Указатель на струну до. По возврату, строка опций CUPS, описывающая настройки печати, или NULL если не могли бы быть преобразованы настройки печати. Функция выделяет хранение для строки. Вы ответственны за освобождение хранения.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Эта функция создает строку опций CUPS, получающую данные в указанном объекте настроек печати. В OS X v10.5 и позже, Apple рекомендует использовать PMPrintSettingsToOptionsWithPrinterAndPageFormat функция вместо этого.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrintSettingsToOptionsWithPrinterAndPageFormat (_: _: _: _:) PMPrintSettingsToOptionsWithPrinterAndPageFormat

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

    Объявление

    Swift

    func PMPrintSettingsToOptionsWithPrinterAndPageFormat(_ settings: PMPrintSettings, _ printer: PMPrinter, _ pageFormat: PMPageFormat, _ options: UnsafeMutablePointer<UnsafeMutablePointer<Int8>>) -> OSStatus

    Objective C

    OSStatus PMPrintSettingsToOptionsWithPrinterAndPageFormat ( PMPrintSettings settings, PMPrinter printer, PMPageFormat pageFormat, char **options );

    Параметры

    settings

    Настройки печати для преобразования.

    printer

    Принтер для использования для преобразования настроек печати. Этот параметр не должен быть NULL.

    pageFormat

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

    options

    Указатель на струну до. По возврату, строке опции CUPS с указанными настройками печати и данными формата страниц, или NULL если не могли бы быть преобразованы данные. Функция выделяет хранение для строки. Вы ответственны за освобождение хранения.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Эта функция создает строку опций CUPS для целевого принтера, получающего данные в указанных настройках печати и объектах формата страниц. Например, Вы могли передать эту строку функции PMWorkflowSubmitPDFWithOptions представить файл PDF для обработки потока операций. Вы могли также использовать строку опций для выполнения фильтра CUPS непосредственно.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

Доступ к данным в объектах настроек печати
  • PMGetPrintSettingsExtendedData PMGetPrintSettingsExtendedData Доступный в OS X v10.0 через OS X v10.9

    Получает расширенные данные настроек печати, ранее хранившие Вашим приложением.

    Объявление

    Objective C

    OSStatus PMGetPrintSettingsExtendedData ( PMPrintSettings printSettings, OSType dataID, UInt32 *size, void *extendedData );

    Параметры

    printSettings

    Настройки печати возражают, чьи расширенные данные Вы хотите получить.

    dataID

    Уникальный 4 кода символа данных для получения. Это обычно - код создателя Вашего приложения. Однако, если Ваш код создателя является вне ASCII 7-разрядным диапазоном символов 0x20–0x7F, необходимо использовать различный 4 кода символа.

    size

    Указатель на значение, указывающее размер буфера, который Вы выделили для расширенных данных настроек печати. По возврату эта переменная содержит число чтения байтов в буфер или размер расширенных данных. Можно передать константу kPMDontWantSize если Вам не нужна эта информация. (См. Данные Не Требуемые Константы для получения дополнительной информации.)

    extendedData

    Указатель на буфер для получения расширенных данных. Передайте константу kPMDontWantData если Вы не хотите считывать данные. (См. Данные Не Требуемые Константы для получения дополнительной информации.)

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

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

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.6.

    См. также

    PMSetPrintSettingsExtendedData

  • PMSetPrintSettingsExtendedData PMSetPrintSettingsExtendedData Доступный в OS X v10.0 через OS X v10.9

    Хранит Ваши специализированные данные в объекте настроек печати.

    Объявление

    Objective C

    OSStatus PMSetPrintSettingsExtendedData ( PMPrintSettings printSettings, OSType dataID, UInt32 size, void *extendedData );

    Параметры

    printSettings

    Настройки печати возражают, в котором можно хранить Ваши специализированные данные.

    dataID

    4 кода символа, которые будут использоваться для идентификации данных. 4 кода символа не должны содержать символы вне стандартного ASCII 7-разрядный диапазон символов 0x20–0x7F. Это обычно - код создателя Вашего приложения.

    size

    Размер, в байтах, данных, которые будут сохранены в объекте настроек печати.

    extendedData

    Указатель на буфер, содержащий расширенные данные, которые Вы хотите хранить.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Можно получить данные, которые Вы храните с функцией PMSetPrintSettingsExtendedData путем вызывания функции PMGetPrintSettingsExtendedData.

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

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.6.

    См. также

    PMGetPrintSettingsExtendedData

  • PMGetFirstPage (_: _:) PMGetFirstPage

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

    Объявление

    Swift

    func PMGetFirstPage(_ printSettings: PMPrintSettings, _ first: UnsafeMutablePointer<UInt32>) -> OSStatus

    Objective C

    OSStatus PMGetFirstPage ( PMPrintSettings printSettings, UInt32 *first );

    Параметры

    printSettings

    Настройки печати возражают, чей первый номер страницы Вы хотите получить.

    first

    Указатель на Ваш UInt32 переменная. По возврату переменная содержит номер страницы первой страницы для печати. Первый номер страницы по умолчанию равняется 1.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Можно использовать эту функцию для получения номера страницы, вводимого пользователем в поле From диалогового окна Печати. Если пользователь нажимает Всю кнопку, функция возвращает значение 1. Если пользователь не вводил значение, функция возвращает значение предыдущего вызова к PMSetFirstPage, если таковые имеются, или значение по умолчанию 1.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMSetFirstPage

  • PMSetFirstPage (_: _: _:) PMSetFirstPage

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

    Объявление

    Swift

    func PMSetFirstPage(_ printSettings: PMPrintSettings, _ first: UInt32, _ lock: Boolean) -> OSStatus

    Objective C

    OSStatus PMSetFirstPage ( PMPrintSettings printSettings, UInt32 first, Boolean lock );

    Параметры

    printSettings

    Настройки печати возражают, чей первый номер страницы Вы хотите установить.

    first

    Номер страницы первой страницы, которая распечатает. Это значение появляется в поле From диалогового окна Печати.

    lock

    Состояние блокировки установки. В это время не поддерживается блокировка.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Как правило, эта функция не используется. В OS X, если Вы вызываете функцию PMSetPageRange и затем вызовите PMSetFirstPage или PMSetLastPage использование той же страницы располагается, Вы указали для PMSetPageRange, тогда диалоговое окно Печати показывает нажатую кнопку From. Если Вы используете константу kPMPrintAllPages для установки страницы располагаются с функцией PMSetPageRange, тогда диалоговое окно Печати открывается Всей кнопкой, нажатой независимо от того, вызываете ли Вы также PMSetFirstPage или PMSetLastPage.

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMGetFirstPage

  • PMGetLastPage (_: _:) PMGetLastPage

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

    Объявление

    Swift

    func PMGetLastPage(_ printSettings: PMPrintSettings, _ last: UnsafeMutablePointer<UInt32>) -> OSStatus

    Objective C

    OSStatus PMGetLastPage ( PMPrintSettings printSettings, UInt32 *last );

    Параметры

    printSettings

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

    last

    Указатель на Ваш UInt32 переменная. По возврату переменная содержит номер страницы последней страницы для печати.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Вы используете эту функцию для получения номера страницы, вводимого пользователем в поле To диалогового окна Печати. Если пользователь не вводил значение, функция возвращает значение предыдущего вызова к PMSetLastPage, если таковые имеются, или значение по умолчанию.

    Вы не должны искать константу kPMPrintAllPages. Та константа используется только с PMSetLastPage и PMSetPageRange функции для указания последней страницы. Это не возвращается PMGetLastPage функция.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMSetLastPage

  • PMSetLastPage (_: _: _:) PMSetLastPage

    Устанавливает номер страницы последней страницы, которая будет распечатана.

    Объявление

    Swift

    func PMSetLastPage(_ printSettings: PMPrintSettings, _ last: UInt32, _ lock: Boolean) -> OSStatus

    Objective C

    OSStatus PMSetLastPage ( PMPrintSettings printSettings, UInt32 last, Boolean lock );

    Параметры

    printSettings

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

    last

    Номер страницы последней страницы, которая распечатает. Это значение появляется в поле To диалогового окна Печати. Передайте константу kPMPrintAllPages распечатать весь документ.

    lock

    Состояние блокировки установки. В это время не поддерживается блокировка.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

    Если Вы вызываете функцию PMSetPageRange и затем вызовите PMSetFirstPage или PMSetLastPage использование той же страницы располагается, Вы указали для PMSetPageRange, тогда диалоговое окно Печати показывает нажатую кнопку From. Если Вы используете константу kPMPrintAllPages для установки страницы располагаются с функцией PMSetPageRange, тогда диалоговое окно Печати открывается Всей кнопкой, нажатой независимо от того, вызываете ли Вы также PMSetFirstPage или PMSetLastPage.

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMGetLastPage

  • PMGetPageRange (_: _: _:) PMGetPageRange

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

    Объявление

    Swift

    func PMGetPageRange(_ printSettings: PMPrintSettings, _ minPage: UnsafeMutablePointer<UInt32>, _ maxPage: UnsafeMutablePointer<UInt32>) -> OSStatus

    Objective C

    OSStatus PMGetPageRange ( PMPrintSettings printSettings, UInt32 *minPage, UInt32 *maxPage );

    Параметры

    printSettings

    Настройки печати возражают, чей диапазон страницы Вы хотите получить.

    minPage

    Указатель на Ваш UInt32 переменная. По возврату переменная содержит минимальный позволенный номер страницы.

    maxPage

    Указатель на Ваш UInt32 переменная. По возврату переменная содержит максимальный позволенный номер страницы.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Диапазон страницы, возвращенный функцией PMGetPageRange независимо от первых и последних значений страницы, возвращенных PMGetFirstPage и PMGetLastPage. Посмотрите PMSetPageRange для получения дополнительной информации.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMSetPageRange

  • PMSetPageRange (_: _: _:) PMSetPageRange

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

    Объявление

    Swift

    func PMSetPageRange(_ printSettings: PMPrintSettings, _ minPage: UInt32, _ maxPage: UInt32) -> OSStatus

    Objective C

    OSStatus PMSetPageRange ( PMPrintSettings printSettings, UInt32 minPage, UInt32 maxPage );

    Параметры

    printSettings

    Настройки печати возражают, чей диапазон страницы Вы хотите установить.

    minPage

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

    maxPage

    Максимальный номер страницы позволяется. Это значение появляется как значение по умолчанию в поле To диалогового окна Печати. Передайте константу kPMPrintAllPages позволить пользователю распечатывать весь документ. Если первая страница установлена в 1, то передача kPMPrintAllPages поскольку максимальный номер страницы заставляет Всю кнопку быть выбранной.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Функция PMSetPageRange позволяет приложениям устанавливать минимальные и максимальные номера страниц, которые могут быть распечатаны для документа. Если пользователь вводит значение за пределами этого диапазона в диалоговом окне Печати, значение установлено в самое близкое позволенное значение. Можно использовать PMGetFirstPage и PMGetLastPage функции для получения значений, вводимых пользователем в диалоговое окно Печати.)

    Если Вы вызываете функцию PMSetPageRange установить максимальную страницу в значение кроме константы kPMPrintAllPages, функция PMSetPageRange заставляет диапазон страницы в диалоговом окне Печати быть должным образом ограниченным указанным диапазоном. Если Вы вызываете функцию PMSetPageRange также не вызывая функции PMSetFirstPage или PMSetLastPage, тогда диалоговое окно Печати показывает указанный диапазон страницы в полях From и To, но со Всей нажатой кнопкой. Если Вы вызываете функцию PMSetPageRange и затем вызовите PMSetFirstPage или PMSetLastPage использование той же страницы располагается, Вы указали для PMSetPageRange, тогда диалоговое окно Печати показывает нажатую кнопку From.

    Во всех случаях, если Ваше приложение устанавливает диапазон с PMSetPageRange и впоследствии вызовы PMSetFirstPage или PMSetLastPage со значениями за пределами указанного диапазона Базовая Печать возвращает код результата kPMValueOutOfRange. С другой стороны, если Ваше приложение вызывает PMSetPageRange после вызова PMSetFirstPage или PMSetLastPage (или после отображения диалогового окна Печати), диапазон страницы, указанный PMSetPageRange имеет приоритет, и первые и последние значения страницы корректируются соответственно.

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMGetPageRange

  • PMPrintSettingsGetJobName (_: _:) PMPrintSettingsGetJobName

    Получает имя задания печати.

    Объявление

    Swift

    func PMPrintSettingsGetJobName(_ printSettings: PMPrintSettings, _ name: UnsafeMutablePointer<Unmanaged<CFString>?>) -> OSStatus

    Objective C

    OSStatus PMPrintSettingsGetJobName ( PMPrintSettings printSettings, CFStringRef *name );

    Параметры

    printSettings

    Настройки печати для текущего задания печати.

    name

    Указатель на Ваш CFStringRef переменная. По возврату переменная относится к Базовой строке Основы, содержащей имя задания печати. Это - то же имя задания, Вы устанавливаете использование функции PMPrintSettingsSetJobName. Вы не должны выпускать строку без первого сохранения его.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMPrintSettingsSetJobName

  • PMPrintSettingsSetJobName (_: _:) PMPrintSettingsSetJobName

    Указывает имя задания печати.

    Объявление

    Swift

    func PMPrintSettingsSetJobName(_ printSettings: PMPrintSettings, _ name: CFString!) -> OSStatus

    Objective C

    OSStatus PMPrintSettingsSetJobName ( PMPrintSettings printSettings, CFStringRef name );

    Параметры

    printSettings

    Настройки печати возражают, чье имя задания Вы хотите определить.

    name

    Новое имя для задания печати.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMPrintSettingsGetJobName

  • PMGetCopies (_: _:) PMGetCopies

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

    Объявление

    Swift

    func PMGetCopies(_ printSettings: PMPrintSettings, _ copies: UnsafeMutablePointer<UInt32>) -> OSStatus

    Objective C

    OSStatus PMGetCopies ( PMPrintSettings printSettings, UInt32 *copies );

    Параметры

    printSettings

    Настройки печати возражают, чье число копий Вы хотите получить.

    copies

    Указатель на Ваш UInt32 переменная. По возврату переменная содержит число копий, которые требует пользователь.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMSetCopies

  • PMSetCopies (_: _: _:) PMSetCopies

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

    Объявление

    Swift

    func PMSetCopies(_ printSettings: PMPrintSettings, _ copies: UInt32, _ lock: Boolean) -> OSStatus

    Objective C

    OSStatus PMSetCopies ( PMPrintSettings printSettings, UInt32 copies, Boolean lock );

    Параметры

    printSettings

    Настройки печати возражают, что Вы хотите инициализировать.

    copies

    Начальное значение числа копий для печати.

    lock

    Состояние блокировки установки. В это время не поддерживается блокировка.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMGetCopies

  • PMGetCollate (_: _:) PMGetCollate

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

    Объявление

    Swift

    func PMGetCollate(_ printSettings: PMPrintSettings, _ collate: UnsafeMutablePointer<Boolean>) -> OSStatus

    Objective C

    OSStatus PMGetCollate ( PMPrintSettings printSettings, Boolean *collate );

    Параметры

    printSettings

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

    collate

    Указатель на Вашу Логическую переменную. По возврату, true если задание сопоставляет опцию, выбран; иначе, false.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Флажок Collated выведен на экран в области Copies & Pages диалогового окна Печати. Эта опция определяет, как организован печатный материал. Например, если у Вас есть документ, который три страницы длиной, и Вы распечатываете многократные копии с выбранной опцией Collated, задание распечатывает страницы 1, 2, и 3 в том порядке и затем повторяется. Однако, если опция Collated не выбрана, и Вы распечатываете многократные копии тех тех же трех страниц, задание распечатывает копии страницы 1, затем копии страницы 2, и наконец копии страницы 3.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMSetCollate

  • PMSetCollate (_: _:) PMSetCollate

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

    Объявление

    Swift

    func PMSetCollate(_ printSettings: PMPrintSettings, _ collate: Boolean) -> OSStatus

    Objective C

    OSStatus PMSetCollate ( PMPrintSettings printSettings, Boolean collate );

    Параметры

    printSettings

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

    collate

    Если true, задание сопоставляет опцию, выбран; если false опция не выбрана.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Флажок Collated выведен на экран в области Copies & Pages диалогового окна Печати. Эта опция определяет, как организован печатный материал. Например, если у Вас есть документ, который три страницы длиной, и Вы распечатываете многократные копии с выбранной опцией Collated, задание распечатывает страницы 1, 2, и 3 в том порядке и затем повторяется. Однако, если опция Collated не выбрана, и Вы распечатываете многократные копии тех тех же трех страниц, задание распечатывает копии страницы 1, затем копии страницы 2, и наконец копии страницы 3.

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMGetCollate

  • PMGetDuplex (_: _:) PMGetDuplex

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

    Объявление

    Swift

    func PMGetDuplex(_ printSettings: PMPrintSettings, _ duplexSetting: UnsafeMutablePointer<PMDuplexMode>) -> OSStatus

    Objective C

    OSStatus PMGetDuplex ( PMPrintSettings printSettings, PMDuplexMode *duplexSetting );

    Параметры

    printSettings

    Настройки печати возражают, чей дуплексный режим Вы хотите получить.

    duplexSetting

    Указатель на Ваш PMDuplexMode переменная. По возврату переменная содержит установку дуплексного режима в текущем задании печати. Возможные значения включают:

    • kPMDuplexNone (односторонняя печать)

    • kPMDuplexNoTumble (двухсторонняя печать)

    • kPMDuplexTumble (двухсторонняя печать с акробатическими прыжками)

    Посмотрите Дуплексные Режимы для полного описания констант дуплексного режима.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Двусторонняя печать является заданием печати, распечатывающим с обеих сторон бумаги. Двухстороннее управление печатью выведено на экран в области Layout диалогового окна Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMSetDuplex (_: _:) PMSetDuplex

    Устанавливает дуплексный режим.

    Объявление

    Swift

    func PMSetDuplex(_ printSettings: PMPrintSettings, _ duplexSetting: PMDuplexMode) -> OSStatus

    Objective C

    OSStatus PMSetDuplex ( PMPrintSettings printSettings, PMDuplexMode duplexSetting );

    Параметры

    printSettings

    Настройки печати возражают, чей дуплексный режим Вы хотите установить.

    duplexSetting

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

    • kPMDuplexNone (односторонняя печать)

    • kPMDuplexNoTumble (двухсторонняя печать)

    • kPMDuplexTumble (двухсторонняя печать с акробатическими прыжками)

    Посмотрите Дуплексные Режимы для полного описания констант, которые можно использовать для указания новой установки.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMGetDuplex

  • PMPrintSettingsGetValue (_: _: _:) PMPrintSettingsGetValue

    Получает значение установки в объекте настроек печати.

    Объявление

    Swift

    func PMPrintSettingsGetValue(_ printSettings: PMPrintSettings, _ key: CFString!, _ value: UnsafeMutablePointer<Unmanaged<AnyObject>?>) -> OSStatus

    Objective C

    OSStatus PMPrintSettingsGetValue ( PMPrintSettings printSettings, CFStringRef key, CFTypeRef *value );

    Параметры

    printSettings

    Настройки печати возражают, что Вы хотите получить доступ.

    key

    Строковая константа, указывающая ключ для желаемой установки. Некоторые ключи в настоящее время определяются в PMTicket.h; другие ключи являются определяемыми пользователем.

    value

    Указатель на Вашу Базовую переменную Основы. По возврату переменная относится к Базовому объекту Основы, соответствующему указанному ключу. Если никакой соответствующий объект не существует, переменная установлена в NULL.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Эта функция, вместе с функцией PMPrintSettingsSetValue, позволяет получить доступ к настройкам печати непосредственно.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMPrintSettingsSetValue

  • PMPrintSettingsSetValue (_: _: _: _:) PMPrintSettingsSetValue

    Хранит значение установки в объекте настроек печати.

    Объявление

    Swift

    func PMPrintSettingsSetValue(_ printSettings: PMPrintSettings, _ key: CFString!, _ value: AnyObject!, _ locked: Boolean) -> OSStatus

    Objective C

    OSStatus PMPrintSettingsSetValue ( PMPrintSettings printSettings, CFStringRef key, CFTypeRef value, Boolean locked );

    Параметры

    printSettings

    Настройки печати возражают, что Вы хотите обновить.

    key

    Строковая константа, указывающая ключ для желаемой установки. Некоторые ключи в настоящее время определяются в PMTicket.h; другие ключи являются определяемыми пользователем.

    value

    Базовый объект Основы, соответствующий указанному ключу. Если Вы передаете NULL, любая существующая установка для указанного ключа удалена.

    locked

    Если true, устанавливаемый элемент должен быть заблокирован; иначе, false. В настоящее время необходимо всегда передавать false.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Эта функция позволяет добавить, изменить, или удалить настройки печати непосредственно. Настройки печати сохранены как пары ключ/значение. Ключи являются Базовыми строками Основы, и соответствующие значения являются Базовыми объектами Основы.

    Можно использовать эту функцию, чтобы хранить определяемые пользователем данные в объекте настроек печати. Необходимо удостовериться, что пользовательские ключи, которые Вы определяете для своих частных данных, не конфликтуют ни с какими другими ключами в объекте. Каждый элемент данных Вы храните потребности быть Базовым объектом Основы. Можно использовать функцию PMPrintSettingsGetValue получать Ваши частные данные.

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMPrintSettingsGetValue

  • PMPrintSettingsCopyAsDictionary (_: _:) PMPrintSettingsCopyAsDictionary

    Создает словарь, содержащий настройки в объекте настроек печати.

    Объявление

    Swift

    func PMPrintSettingsCopyAsDictionary(_ printSettings: PMPrintSettings, _ settingsDictionary: UnsafeMutablePointer<Unmanaged<CFDictionary>?>) -> OSStatus

    Objective C

    OSStatus PMPrintSettingsCopyAsDictionary ( PMPrintSettings printSettings, CFDictionaryRef *settingsDictionary );

    Параметры

    printSettings

    Настройки печати возражают с желаемыми настройками.

    settingsDictionary

    Указатель на Ваш CFDictionaryRef переменная. По возврату переменная обращается к Базовому словарю Основы, содержащему настройки в указанном объекте настроек печати. Некоторые ключи в этом словаре в настоящее время определяются в PMTicket.h; другие ключи являются определяемыми пользователем. Вы ответственны за выпуск словаря. Если ошибка происходит, переменная установлена в NULL.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrintSettingsCopyKeys (_: _:) PMPrintSettingsCopyKeys

    Получает ключи для элементов в объекте настроек печати.

    Объявление

    Swift

    func PMPrintSettingsCopyKeys(_ printSettings: PMPrintSettings, _ settingsKeys: UnsafeMutablePointer<Unmanaged<CFArray>?>) -> OSStatus

    Objective C

    OSStatus PMPrintSettingsCopyKeys ( PMPrintSettings printSettings, CFArrayRef *settingsKeys );

    Параметры

    printSettings

    Настройки печати возражают с желаемыми ключами.

    settingsKeys

    Указатель на Ваш CFArrayRef переменная. По возврату переменная относится к Базовому массиву Основы, содержащему ключи для элементов в указанном объекте настроек печати. Каждый из этих ключей может быть передан функции PMPrintSettingsGetValue получить значение. Вы ответственны за выпуск массива. Если ошибка происходит, переменная установлена в NULL.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMGetJobNameCFString PMGetJobNameCFString Доступный в OS X v10.0 через OS X v10.9

    Получает имя задания печати.

    Оператор осуждения

    Использовать PMPrintSettingsGetJobName вместо этого.

    Объявление

    Objective C

    OSStatus PMGetJobNameCFString ( PMPrintSettings printSettings, CFStringRef *name );

    Параметры

    printSettings

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

    name

    Указатель на Ваш CFStringRef переменная. По возврату переменная относится к строке, содержащей имя задания печати. Несмотря на какой ее имя подразумевает, функция PMGetJobNameCFString имеет Создают/Копируют семантику, что означает, что Ваше приложение должно выпустить строку, возвращенную к ней.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    Не доступный 64-разрядным приложениям.

    См. также

    PMSetJobNameCFString

  • PMSetJobNameCFString PMSetJobNameCFString Доступный в OS X v10.0 через OS X v10.9

    Указывает имя задания печати.

    Оператор осуждения

    Использовать PMPrintSettingsSetJobName вместо этого.

    Объявление

    Objective C

    OSStatus PMSetJobNameCFString ( PMPrintSettings printSettings, CFStringRef name );

    Параметры

    printSettings

    Настройки печати возражают, чье имя задания Вы хотите определить.

    name

    Новое имя для задания печати.

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

    Код результата. Посмотрите Базовые Коды Результата Печати. Код результата kPMInvalidParameter если Вы передаете, возвращается NULL или пустая строка в name параметр.

    Обсуждение

    Необходимо вызвать эту функцию перед открытием диалогового окна Печати.

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

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    Не доступный 64-разрядным приложениям.

    См. также

    PMGetJobNameCFString

Создание объектов сеанса печати
  • PMCreateSession (_:) PMCreateSession

    Создает и инициализирует объект сеанса печати и создает контекст для печати операций.

    Объявление

    Swift

    func PMCreateSession(_ printSession: UnsafeMutablePointer<PMPrintSession>) -> OSStatus

    Objective C

    OSStatus PMCreateSession ( PMPrintSession *printSession );

    Параметры

    printSession

    Указатель на Ваш PMPrintSession переменная. По возврату переменная относится к новому объекту сеанса печати. Вы ответственны за выпуск объекта сеанса печати с функцией PMRelease.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

Доступ к данным в печати объектов сеанса
  • PMSessionGetDataFromSession (_: _: _:) PMSessionGetDataFromSession

    Получает специализированные данные, ранее хранившие в объекте сеанса печати.

    Объявление

    Swift

    func PMSessionGetDataFromSession(_ printSession: PMPrintSession, _ key: CFString!, _ data: UnsafeMutablePointer<Unmanaged<AnyObject>?>) -> OSStatus

    Objective C

    OSStatus PMSessionGetDataFromSession ( PMPrintSession printSession, CFStringRef key, CFTypeRef *data );

    Параметры

    printSession

    Сеанс печати, данные которого Вы хотите получить.

    key

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

    data

    Указатель на Ваш CFTypeRef переменная. По возврату переменная относится к полученным данным от сеанса печати.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMSessionSetDataInSession

  • PMSessionSetDataInSession (_: _: _:) PMSessionSetDataInSession

    Хранит Ваши специализированные данные в объекте сеанса печати.

    Объявление

    Swift

    func PMSessionSetDataInSession(_ printSession: PMPrintSession, _ key: CFString!, _ data: AnyObject!) -> OSStatus

    Objective C

    OSStatus PMSessionSetDataInSession ( PMPrintSession printSession, CFStringRef key, CFTypeRef data );

    Параметры

    printSession

    Сеанс печати, в котором Вы хотите хранить специализированные данные.

    key

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

    data

    Данные, которые будут сохранены в сеансе печати.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMSessionGetDataFromSession

  • PMSessionGetCurrentPrinter (_: _:) PMSessionGetCurrentPrinter

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

    Объявление

    Swift

    func PMSessionGetCurrentPrinter(_ printSession: PMPrintSession, _ currentPrinter: UnsafeMutablePointer<PMPrinter>) -> OSStatus

    Objective C

    OSStatus PMSessionGetCurrentPrinter ( PMPrintSession printSession, PMPrinter *currentPrinter );

    Параметры

    printSession

    Сеанс печати, принтер которого Вы хотите получить.

    currentPrinter

    Указатель на Ваш PMPrinter переменная. По возврату переменная относится к принтеру, связанному с указанным сеансом печати. Объект принтера допустим, пока сеанс печати допустим, или текущий принтер не изменился. Вы не должны выпускать этот объект без первого сохранения его.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMSessionSetCurrentPMPrinter

  • PMSessionSetCurrentPrinter PMSessionSetCurrentPrinter Доступный в OS X v10.1 через OS X v10.9

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

    Оператор осуждения

    Использовать PMSessionSetCurrentPMPrinter вместо этого.

    Объявление

    Objective C

    OSStatus PMSessionSetCurrentPrinter ( PMPrintSession session, CFStringRef printerName );

    Параметры

    session

    Сеанс печати, принтер которого Вы хотите изменить.

    printerName

    Имя принтера Вы хотите установить как текущий принтер.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.1 через OS X v10.9.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

  • PMSessionSetCurrentPMPrinter (_: _:) PMSessionSetCurrentPMPrinter

    Изменяет текущий принтер для сеанса печати.

    Объявление

    Swift

    func PMSessionSetCurrentPMPrinter(_ session: PMPrintSession, _ printer: PMPrinter) -> OSStatus

    Objective C

    OSStatus PMSessionSetCurrentPMPrinter ( PMPrintSession session, PMPrinter printer );

    Параметры

    session

    Сеанс печати, принтер которого Вы хотите изменить.

    printer

    Новый принтер для сеанса печати.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMSessionGetCurrentPrinter

  • PMSessionGetDocumentFormatGeneration PMSessionGetDocumentFormatGeneration Доступный в OS X v10.0 через OS X v10.9

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

    Оператор осуждения

    При рисовании Кварца использования, 2D вместо QuickDraw использовать PMSessionBeginCGDocument или PMSessionBeginCGDocumentNoDialog; для представления данных PostScript использовать PMPrinterPrintWithFile или PMPrinterPrintWithProvider; для рисования данных EPS использовать PMCGImageCreateWithEPSDataProvider.

    Объявление

    Objective C

    OSStatus PMSessionGetDocumentFormatGeneration ( PMPrintSession printSession, CFArrayRef *docFormats );

    Параметры

    printSession

    Сеанс печати, форматы буферного файла которого Вы хотите получить.

    docFormats

    Указатель на Ваш CFArrayRef переменная. По возврату переменная относится к Базовому массиву Основы, содержащему типы MIME для доступных форматов буферного файла. Каждый элемент в массиве является Базовой строкой Основы. Несмотря на какой ее имя подразумевает, функция PMSessionGetDocumentFormatGeneration имеет Создают/Копируют семантику, что означает, что Вы ответственны за выпуск массива.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать функцию PMSessionGetDocumentFormatGeneration между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession. Необходимо вызвать PMSessionGetDocumentFormatGeneration только после того, как диалоговое окно Печати отклонено.

    Функция PMSessionGetDocumentFormatGeneration определяет форматы буферного файла, которые поддерживает определенное задание печати. Форматы буферного файла представлены типами MIME. Спулер печати OS X поддерживает PDF и PICT + PS. Форматом буферного файла по умолчанию является PDF. PICT + PS поддерживается только для печати к принтеру PostScript.

    Специальные замечания

    PICT + формат буферного файла PS не доступен в основанных на Intel системах.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

    См. также

    PMSessionSetDocumentFormatGeneration

  • PMSessionSetDocumentFormatGeneration PMSessionSetDocumentFormatGeneration Доступный в OS X v10.0 через OS X v10.9

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

    Оператор осуждения

    При рисовании Кварца использования, 2D вместо QuickDraw использовать PMSessionBeginCGDocument или PMSessionBeginCGDocumentNoDialog; для представления данных PostScript использовать PMPrinterPrintWithFile или PMPrinterPrintWithProvider; для рисования данных EPS использовать PMCGImageCreateWithEPSDataProvider.

    Объявление

    Objective C

    OSStatus PMSessionSetDocumentFormatGeneration ( PMPrintSession printSession, CFStringRef docFormat, CFArrayRef graphicsContextTypes, CFTypeRef options );

    Параметры

    printSession

    Сеанс печати, формат буферного файла которого и графический тип контекста Вы хотите указать.

    docFormat

    Базовая строка Основы, указывающая желаемый формат буферного файла как тип MIME. Посмотрите Строки Формата документа для описания констант, которые можно использовать для указания формата документа.

    graphicsContexts

    Ссылка на Базовый массив Основы графических контекстов для использования для страниц рисунка в цикле печати. Можно предоставить контекст графики QuickDraw (kPMGraphicsContextQuickDraw) или Кварц 2D графический контекст (kPMGraphicsContextCoreGraphics). Массив длины 1 является единственной длиной, поддерживающейся, независимо от графического типа контекста. Посмотрите Графические Типы Контекста для описания констант, которые можно использовать для указания графического контекста.

    options

    Зарезервированный для будущего использования.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Только необходимо вызвать функцию PMSessionSetDocumentFormatGeneration если Вы хотите указать формат кроме формата по умолчанию (PDF) или графический контекст кроме контекста по умолчанию (QuickDraw). Если Вы хотите использовать формат по умолчанию для операционной системы и нарисовать с QuickDraw, то Вы не должны вызывать эту функцию. Если Вы хотите генерировать PICT + PS для использования в качестве одного из поддерживаемых форматов, то вызовите PMSessionSetDocumentFormatGeneration установить графический контекст в QuickDraw и формат к PICT + PS. Обратите внимание на то, что PICT + формат PS не доступен в основанных на Intel системах.

    Если Вы хотите использовать Кварц 2D графический контекст для рисования каждой страницы, можно вызвать следующий код для информирования системы печати во всех версиях OS X.

    • static OSStatus MyPMSessionBeginCGDocument (
    • PMPrintSession printSession,
    • PMPrintSettings printSettings,
    • PMPageFormat pageFormat)
    • {
    • OSStatus err = noErr;
    • // Use the simpler call if it is present.
    • if(&PMSessionBeginCGDocument != NULL) {
    • err = PMSessionBeginCGDocument (printSession, printSettings, pageFormat);
    • }
    • else {
    • CFStringRef s[1] = { kPMGraphicsContextCoreGraphics };
    • CFArrayRef graphicsContextsArray = CFArrayCreate (
    • kCFAllocatorDefault, (const void**)s, 1, &kCFTypeArrayCallBacks);
    • err = PMSessionSetDocumentFormatGeneration (
    • printSession, kPMDocumentFormatPDF, graphicsContextsArray, NULL);
    • CFRelease (graphicsContextsArray);
    • if(!err)
    • err = PMSessionBeginDocument (
    • printSession, printSettings, pageFormat);
    • }
    • return err;
    • }

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

    • static OSStatus MyPMSessionGetCGGraphicsContext (
    • PMPrintSession printSession,
    • CGContextRef *printingContextP)
    • {
    • OSStatus err = noErr;
    • // Use the simpler call if it is present.
    • if(&PMSessionGetCGGraphicsContext != NULL) {
    • err = PMSessionGetCGGraphicsContext (printSession, printingContextP);
    • }
    • else {
    • err = PMSessionGetGraphicsContext (
    • printSession, kPMGraphicsContextCoreGraphics,
    • (void**)printingContextP);
    • }
    • return err;
    • }

    Контекст печати, который Вы получаете, является Кварцевым контекстом, в который можно нарисовать. Обратите внимание на то, что система координат по умолчанию для 2D Кварца не является тем же как используемым для QuickDraw. 2D кварц определяет координаты нижнего левого угла листа как (0,0), тогда как источник для порта QuickDraw является верхним левым углом области изображения.

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession. Необходимо вызвать функцию PMSessionSetDocumentFormatGeneration перед вызовом PMSessionBeginDocument или PMSessionBeginDocumentNoDialog. Прежде, чем запросить формат буферного файла с помощью этой функции, необходимо вызвать функцию PMSessionGetDocumentFormatGeneration получить список поддерживаемых форматов.

    Специальные замечания

    PICT + формат буферного файла PS не доступен в основанных на Intel системах.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

    См. также

    PMSessionGetDocumentFormatGeneration

  • PMSessionGetCGGraphicsContext (_: _:) PMSessionGetCGGraphicsContext

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

    Объявление

    Swift

    func PMSessionGetCGGraphicsContext(_ printSession: PMPrintSession, _ context: UnsafeMutablePointer<Unmanaged<CGContext>?>) -> OSStatus

    Objective C

    OSStatus PMSessionGetCGGraphicsContext ( PMPrintSession printSession, CGContextRef *context );

    Параметры

    printSession

    Сеанс печати, Кварцевый контекст графики которого Вы хотите получить.

    context

    Указатель на Ваш CGContextRef переменная. По возврату переменная относится к Кварцевому контексту графики для текущей страницы в указанном сеансе печати. Источник контекста в нижнем левом углу листка бумаги, не области изображения. Вы не должны выпускать контекст без первого сохранения его. Контекст допустим только для текущей страницы; Вы не должны сохранять его вне конца страницы.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Если Вы используете Кварц, 2D для рисования содержания для задания печати после каждого вызова к PMSessionBeginPage необходимо вызвать PMSessionGetCGGraphicsContext получить Кварцевый контекст графики для текущей страницы. Обратите внимание на то, что, прежде чем можно использовать функцию PMSessionGetCGGraphicsContext, Вы, должно быть, вызвали PMSessionBeginCGDocument или PMSessionBeginCGDocumentNoDialog вместо PMSessionBeginDocument или PMSessionBeginDocumentNoDialog.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMSessionGetGraphicsContext PMSessionGetGraphicsContext Доступный в OS X v10.0 через OS X v10.9

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

    Оператор осуждения

    Использовать PMSessionGetCGGraphicsContext вместо этого.

    Объявление

    Objective C

    OSStatus PMSessionGetGraphicsContext ( PMPrintSession printSession, CFStringRef graphicsContextType, void **graphicsContext );

    Параметры

    printSession

    Сеанс печати, текущий графический контекст которого Вы хотите получить.

    graphicsType

    Желаемый графический тип контекста. Этот параметр в настоящее время игнорируется.

    graphicsContext

    По возврату, ссылке на текущий графический контекст. Графический контекст возвратился, один последний набор вызовом к функции PMSessionSetDocumentFormatGeneration или значение по умолчанию (QuickDraw), если не было никакого вызова к функции. Необходимо преобразовать тип контекста к надлежащему графическому типу, также grafPtr или CGContextRef.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession. Необходимо также вызвать функцию PMSessionGetGraphicsContext в рамках функций PMSessionBeginPage и PMSessionEndPage.

    В OS X v10.3 и ранее, необходимо вызвать эту функцию для каждой страницы, которую Вы рисуете для задания печати. После каждого вызова к функции PMSessionBeginPage Ваше приложение должно вызвать PMSessionGetGraphicsContext получить текущий графический контекст. Если тот контекст является контекстом QuickDraw, то установленный порт получения в этот порт путем вызова QuickDraw SetPort функция. Посмотрите обсуждение функции PMSessionBeginPage для получения дополнительной информации.

    Специальные замечания

    В OS X v10.4 и позже, Apple рекомендует использовать функцию PMSessionGetCGGraphicsContext вместо этой функции. QuickDraw осуждается, и Ваше приложение должно использовать Кварц, 2D для его рендеринга.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    Не доступный 64-разрядным приложениям.

  • PMSessionError (_:) PMSessionError

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

    Объявление

    Swift

    func PMSessionError(_ printSession: PMPrintSession) -> OSStatus

    Objective C

    OSStatus PMSessionError ( PMPrintSession printSession );

    Параметры

    printSession

    Сеанс печати, последнюю ошибку которого Вы хотите получить.

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

    Код результата. Посмотрите Базовые Коды Результата Печати. Константа kPMCancel указывает, что пользователь отменил текущее задание печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession.

    PMSessionError функционируйте возвращает последнюю ошибку сеанса печати, не последнюю ошибку от функции печати (PMxxx). Поскольку большинство функций печати возвращает код результата, PMSessionError функция не требуется для общей проверки ошибок. Однако можно использовать PMSessionError в Вашем цикле печати, чтобы определить, отменяет ли пользователь текущее задание печати или если любые другие ошибки происходят во время печати, которые явно не возвращаются одним из других вызовов. Например, если пользователь щелкает по Кнопке отмены в диалоговом окне состояния или нажимает Command-period на клавиатуре, эта функция возвращает константу kPMCancel. Если с этим или ошибкой встречаются во время цикла печати, Ваше приложение должно вызвать надлежащие функции (например, PMSessionEndPage и PMSessionEndDocument) для выхода из цикла печати перед приложение сообщает об ошибке.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMSessionSetError (_: _:) PMSessionSetError

    Устанавливает значение текущего кода результата для указанного сеанса печати.

    Объявление

    Swift

    func PMSessionSetError(_ printSession: PMPrintSession, _ printError: OSStatus) -> OSStatus

    Objective C

    OSStatus PMSessionSetError ( PMPrintSession printSession, OSStatus printError );

    Параметры

    printSession

    Сеанс печати, код результата которого Вы хотите установить.

    printError

    Код результата Вы хотите установить. Этот код результата возвращается PMSessionError функция.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession.

    Если приложение встречается с какими-либо ошибками в цикле печати, можно использовать эту функцию для завершения сеанса печати. Как правило, эта функция используется неактивной функцией приложения. Неактивная функция не вызвана в OS X, таким образом, это использование не доступно.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMSessionGeneral PMSessionGeneral Доступный в OS X v10.0 через OS X v10.9

    Поддерживает совместимость с PrGeneral функция в классическом Диспетчере печати.

    Оператор осуждения

    Использовать PMPrinterGetCommInfo вместо этого.

    Объявление

    Objective C

    OSStatus PMSessionGeneral ( PMPrintSession printSession, Ptr pData );

    Параметры

    printSession

    Сеанс печати, данные которого Вы хотите получить.

    pData

    Указатель на a PrGeneral структура данных.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Функция PMSessionGeneral допустимо для сеанса печати, переданного функции. В OS X, функции PMSessionGeneral если код операции, предпринимает попытку получить запрошенные данные getPSInfoOp. Иначе код результата kPMNotImplemented возвращается.

    Для получения дополнительной информации об использовании функции PMSessionGeneral, посмотрите, что Поддержка Распечатывает в Вашем Приложении Углерода.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

Используя предварительные установки принтера
  • PMPresetCopyName (_: _:) PMPresetCopyName

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

    Объявление

    Swift

    func PMPresetCopyName(_ preset: PMPreset, _ paperID: UnsafeMutablePointer<Unmanaged<CFString>?>) -> OSStatus

    Objective C

    OSStatus PMPresetCopyName ( PMPreset preset, CFStringRef *name );

    Параметры

    preset

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

    paperID

    Указатель на Ваш CFStringRef переменная. По возврату переменная относится к Базовой строке Основы, содержащей локализованное имя указанной предварительной установки. Вы ответственны за выпуск строки.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPresetCreatePrintSettings (_: _: _:) PMPresetCreatePrintSettings

    Создает объект настроек печати с настройками, соответствующими предварительной установке.

    Объявление

    Swift

    func PMPresetCreatePrintSettings(_ preset: PMPreset, _ session: PMPrintSession, _ printSettings: UnsafeMutablePointer<PMPrintSettings>) -> OSStatus

    Objective C

    OSStatus PMPresetCreatePrintSettings ( PMPreset preset, PMPrintSession session, PMPrintSettings *printSettings );

    Параметры

    preset

    Предварительная установка, настройки которой Вы хотите получить. Можно использовать функцию PMPrinterCopyPresets получить предварительные установки для данного принтера.

    session

    Сеанс Вы используете для представления диалогового окна Печати.

    printSettings

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

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPresetGetAttributes (_: _:) PMPresetGetAttributes

    Получает атрибуты предварительной установки.

    Объявление

    Swift

    func PMPresetGetAttributes(_ preset: PMPreset, _ attributes: UnsafeMutablePointer<Unmanaged<CFDictionary>?>) -> OSStatus

    Objective C

    OSStatus PMPresetGetAttributes ( PMPreset preset, CFDictionaryRef *attributes );

    Параметры

    preset

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

    attributes

    Указатель на Ваш CFDictionaryRef переменная. По возврату переменная обращается к Базовому словарю Основы, содержащему атрибуты указанной предварительной установки, или NULL если не могли бы быть получены атрибуты. Для получения дополнительной информации об этих атрибутах, посмотрите Обсуждение. Вы не должны выпускать этот словарь без первого сохранения его.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

Создавая и Используя бумажные объекты
  • PMPaperCreate PMPaperCreate Доступный в OS X v10.3 через OS X v10.9

    Создает бумажный объект.

    Оператор осуждения

    Использовать PMPrinterGetPaperList счесть встроенные бумаги доступными для данного принтера или использования PMPaperCreateCustom создать пользовательскую газету.

    Объявление

    Objective C

    OSStatus PMPaperCreate ( PMPrinter printer, CFStringRef id, CFStringRef name, double width, double height, const PMPaperMargins *margins, PMPaper *paperP );

    Параметры

    printer

    Объект принтера, для которого бумага является подходящей.

    id

    Уникальный идентификатор для этой бумаги.

    name

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

    width

    Ширина бумаги, в точках.

    height

    Высота бумаги, в точках.

    margins

    Указатель на a PMPaperMargins структура, указывающая непечатные поля бумаги в точках. Четыре значения в структуре указывают вершину, оставленную, нижняя часть и правильные поля области изображения бумаги.

    paperP

    Указатель на Ваш PMPaper переменная. По возврату переменная относится к новому бумажному объекту с указанными атрибутами. Вы ответственны за выпуск бумажного объекта с функцией PMRelease. Переменная установлена в NULL если не мог бы быть создан объект.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

    Специальные замечания

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

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.3 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    Не доступный 64-разрядным приложениям.

  • PMPaperCreateCustom (_: _: _: _: _: _: _:) PMPaperCreateCustom

    Создает пользовательский бумажный объект.

    Объявление

    Swift

    func PMPaperCreateCustom(_ printer: PMPrinter, _ id: CFString!, _ name: CFString!, _ width: Double, _ height: Double, _ margins: UnsafePointer<PMPaperMargins>, _ paperP: UnsafeMutablePointer<PMPaper>) -> OSStatus

    Objective C

    OSStatus PMPaperCreateCustom ( PMPrinter printer, CFStringRef id, CFStringRef name, double width, double height, const PMPaperMargins *margins, PMPaper *paperP );

    Параметры

    printer

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

    id

    Уникальный идентификатор для этой пользовательской бумаги. Например, Вы могли создать строку UUID и использовать ее в качестве уникального идентификатора.

    name

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

    width

    Ширина бумаги, в точках.

    height

    Высота бумаги, в точках.

    margins

    Указатель на a PMPaperMargins структура, указывающая непечатные поля бумаги в точках. Четыре значения в структуре указывают вершину, оставленную, нижняя часть и правильные поля области изображения бумаги.

    paperP

    Указатель на Ваш PMPaper переменная. По возврату переменная относится к новому пользовательскому бумажному объекту. Вы ответственны за выпуск бумажного объекта с функцией PMRelease.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Эта функция создает пользовательский бумажный объект, подходящий для указанного принтера. Пользовательские бумаги обрабатываются по-другому, чем встроенные статьи системы печати. Для получения одной из доступных встроенных бумаг для данного принтера можно использовать функцию PMPrinterGetPaperList.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPaperIsCustom (_:) PMPaperIsCustom

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

    Объявление

    Swift

    func PMPaperIsCustom(_ paper: PMPaper) -> Boolean

    Objective C

    Boolean PMPaperIsCustom ( PMPaper paper );

    Параметры

    paper

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

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

    Если true, указанная бумага является пользовательской газетой; иначе, false.

    Обсуждение

    Можно создать пользовательскую газету с функцией PMPaperCreateCustom.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

Доступ к данным в бумажных объектах
  • PMPaperGetID (_: _:) PMPaperGetID

    Получает идентификатор бумажного объекта.

    Объявление

    Swift

    func PMPaperGetID(_ paper: PMPaper, _ paperID: UnsafeMutablePointer<Unmanaged<CFString>?>) -> OSStatus

    Objective C

    OSStatus PMPaperGetID ( PMPaper paper, CFStringRef *paperID );

    Параметры

    paper

    Бумага, идентификатор которой Вы хотите получить.

    paperID

    Указатель на Ваш CFStringRef переменная. По возврату переменная относится к Базовой строке Основы, содержащей уникальный идентификатор для этой бумаги. Вы не должны выпускать строку без первого сохранения его.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPaperGetName PMPaperGetName Доступный в OS X v10.3 через OS X v10.9

    Получает имя для данной газеты.

    Объявление

    Objective C

    OSStatus PMPaperGetName ( PMPaper paper, CFStringRef *paperName );

    Параметры

    paper

    Бумага, имя которой Вы хотите получить.

    paperName

    Указатель на Ваш CFStringRef переменная. По возврату переменная относится к Базовой строке Основы, содержащей имя для этой бумаги. Это имя идентифицирует бумагу в пользовательском интерфейсе. Вы не должны выпускать строку без первого сохранения его.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Специальные замечания

    Эта функция не обязательно возвращает бумажное имя, это локализуется для данного принтера. В OS X v10.5 и позже, вместо того, чтобы использовать эту функцию, Apple рекомендует использовать функцию PMPaperCreateLocalizedName.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.3 через OS X v10.9.

    Осуждаемый в OS X v10.7.

  • PMPaperGetWidth (_: _:) PMPaperGetWidth

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

    Объявление

    Swift

    func PMPaperGetWidth(_ paper: PMPaper, _ paperWidth: UnsafeMutablePointer<Double>) -> OSStatus

    Objective C

    OSStatus PMPaperGetWidth ( PMPaper paper, double *paperWidth );

    Параметры

    paper

    Бумага, ширину которой Вы хотите получить.

    paperWidth

    Указатель на Вашу переменную двойной точности. По возврату переменная содержит ширину указанной бумаги в точках.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPaperGetHeight (_: _:) PMPaperGetHeight

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

    Объявление

    Swift

    func PMPaperGetHeight(_ paper: PMPaper, _ paperHeight: UnsafeMutablePointer<Double>) -> OSStatus

    Objective C

    OSStatus PMPaperGetHeight ( PMPaper paper, double *paperHeight );

    Параметры

    paper

    Бумага, высоту которой Вы хотите получить.

    paperHeight

    Указатель на Вашу переменную двойной точности. По возврату переменная содержит высоту указанной бумаги в точках.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPaperGetMargins (_: _:) PMPaperGetMargins

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

    Объявление

    Swift

    func PMPaperGetMargins(_ paper: PMPaper, _ paperMargins: UnsafeMutablePointer<PMPaperMargins>) -> OSStatus

    Objective C

    OSStatus PMPaperGetMargins ( PMPaper paper, PMPaperMargins *paperMargins );

    Параметры

    paper

    Бумага, поля которой Вы хотите получить.

    paperMargins

    Указатель на Ваш PMPaperMargins структура. По возврату структура содержит непечатные поля указанной бумаги в точках. Четыре значения в структуре указывают вершину, оставленную, нижняя часть и правильные поля области изображения бумаги.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPaperCreateLocalizedName (_: _: _:) PMPaperCreateLocalizedName

    Получает локализованное имя для данной газеты.

    Объявление

    Swift

    func PMPaperCreateLocalizedName(_ paper: PMPaper, _ printer: PMPrinter, _ paperName: UnsafeMutablePointer<Unmanaged<CFString>?>) -> OSStatus

    Objective C

    OSStatus PMPaperCreateLocalizedName ( PMPaper paper, PMPrinter printer, CFStringRef *paperName );

    Параметры

    paper

    Бумага, локализованное имя которой Вы хотите получить.

    printer

    Принтер, для которого должна быть выполнена локализация.

    paperName

    Указатель на Ваш CFStringRef переменная. По возврату переменная относится к Базовой строке Основы, содержащей локализованное имя бумаги. Это имя является надлежащим для отображения в пользовательском интерфейсе. Если ошибка происходит, переменная установлена в NULL. Вы ответственны за выпуск строки.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

    Специальные замечания

    В OS X v10.5 и позже, Apple рекомендует использовать эту функцию вместо PMPaperGetName.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPaperGetPrinterID (_: _:) PMPaperGetPrinterID

    Получает принтер ID принтера, которому соответствует данная газета.

    Объявление

    Swift

    func PMPaperGetPrinterID(_ paper: PMPaper, _ printerID: UnsafeMutablePointer<Unmanaged<CFString>?>) -> OSStatus

    Objective C

    OSStatus PMPaperGetPrinterID ( PMPaper paper, CFStringRef *printerID );

    Параметры

    paper

    Бумага, принтер которой ID Вы хотите получить.

    printerID

    Указатель на Ваш CFStringRef переменная. По возврату переменная относится к Базовой строке Основы, содержащей принтер ID для указанной бумаги. Если ошибка происходит, переменная установлена в NULL. Вы не должны выпускать строку без первого сохранения его.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Не все бумаги имеют принтер ID, связанный с ними. Если принтер в Формате диалогового окна Установки Страницы для всплывающего меню, ID известен, принтер выведен на экран. Если принтер обобщением Какой-либо Принтер, ID не известен, принтер форматирования значения по умолчанию является, система печати обеспечивает форматы бумаги по умолчанию для универсального принтера.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPaperGetPPDPaperName (_: _:) PMPaperGetPPDPaperName

    Получает бумажное имя PPD для данной газеты.

    Объявление

    Swift

    func PMPaperGetPPDPaperName(_ paper: PMPaper, _ paperName: UnsafeMutablePointer<Unmanaged<CFString>?>) -> OSStatus

    Objective C

    OSStatus PMPaperGetPPDPaperName ( PMPaper paper, CFStringRef *paperName );

    Параметры

    paper

    Бумага, бумажное имя PPD которой Вы хотите получить.

    paperName

    Указатель на Ваш CFStringRef переменная. По возврату переменная относится к Базовой строке Основы, содержащей бумажное имя PPD для указанной бумаги. Если ошибка происходит, переменная установлена в NULL. Вы не должны выпускать строку без первого сохранения его.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    OS X, распечатывающий систему, использует файл PostScript Printer Description (PPD) для описания данной очереди печати и очереди печати для того принтера. Бумажное имя PPD является именем, однозначно определяющим данную газету для принтера, которому соответствует бумага. Для получения списка бумаг для данного принтера используйте функцию PMPrinterGetPaperList.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

Функции цикла печати
  • PMSessionBeginCGDocumentNoDialog (_: _: _:) PMSessionBeginCGDocumentNoDialog

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

    Объявление

    Swift

    func PMSessionBeginCGDocumentNoDialog(_ printSession: PMPrintSession, _ printSettings: PMPrintSettings, _ pageFormat: PMPageFormat) -> OSStatus

    Objective C

    OSStatus PMSessionBeginCGDocumentNoDialog ( PMPrintSession printSession, PMPrintSettings printSettings, PMPageFormat pageFormat );

    Параметры

    printSession

    Сеанс печати, обеспечивающий контекст для нового задания печати.

    printSettings

    Настройки печати для использования для нового задания печати.

    pageFormat

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

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

    Необходимо вызвать PMSessionBeginCGDocumentNoDialog между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession. При представлении диалогового окна печати перед вызовом PMSessionBeginCGDocumentNoDialog, при вызывании этой функции необходимо использовать то же PMPrintSession возразите используемый представлению диалогового окна.

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

    Во время задания печати вызывающая сторона не может получить порт графики Quickdraw для сеанса печати, но может только получить Кварцевый контекст графики. В результате эта функция должна использоваться в сочетании с PMSessionGetCGGraphicsContext вместо PMSessionGetGraphicsContext.

    Эта функция должна быть вызвана перед ее соответствием End функция (PMSessionEndDocumentNoDialog). Если функция PMSessionBeginCGDocumentNoDialog возвраты noErr, необходимо позже вызвать End функция, даже если ошибки происходят в рамках Begin и End функции.

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMSessionBeginDocumentNoDialog PMSessionBeginDocumentNoDialog Доступный в OS X v10.0 через OS X v10.9

    Начинает задание печати, по умолчанию, вовлекающее порт графики QuickDraw и подавляющее диалоговое окно состояния печати.

    Оператор осуждения

    Использовать PMSessionBeginCGDocumentNoDialog вместо этого.

    Объявление

    Objective C

    OSStatus PMSessionBeginDocumentNoDialog ( PMPrintSession printSession, PMPrintSettings printSettings, PMPageFormat pageFormat );

    Параметры

    printSession

    Сеанс печати, обеспечивающий контекст для нового задания печати.

    printSettings

    Настройки печати для использования для нового задания печати.

    pageFormat

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

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Функция PMSessionBeginDocumentNoDialog запускает задание печати и должен быть вызван в цикле печати Вашего приложения. Эта функция подобна функции PMSessionBeginDocument за исключением того, что подавлено диалоговое окно состояния печати.

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession. При представлении диалогового окна печати перед вызовом PMSessionBeginDocumentNoDialog, при вызывании этой функции необходимо использовать то же PMPrintSession возразите используемый представлению диалогового окна.

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

    Эта функция должна быть вызвана перед ее соответствием End функция (PMSessionEndDocumentNoDialog). Если функция PMSessionBeginDocumentNoDialog возвраты noErr, необходимо вызвать End функция, даже если ошибки происходят в рамках Begin и End функции.

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

    Специальные замечания

    В OS X v10.4 и позже, Apple рекомендует использовать функцию PMSessionBeginCGDocumentNoDialog вместо этой функции. QuickDraw осуждается, и Ваше приложение должно использовать Кварц, 2D для его рендеринга.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    Не доступный 64-разрядным приложениям.

  • PMSessionEndDocumentNoDialog (_:) PMSessionEndDocumentNoDialog

    Заканчивает задание печати, запущенное путем вызывания функции PMSessionBeginCGDocumentNoDialog или PMSessionBeginDocumentNoDialog.

    Объявление

    Swift

    func PMSessionEndDocumentNoDialog(_ printSession: PMPrintSession) -> OSStatus

    Objective C

    OSStatus PMSessionEndDocumentNoDialog ( PMPrintSession printSession );

    Параметры

    printSession

    Текущий сеанс печати. По возврату сеанс печати больше не действителен; однако, необходимо все еще вызвать функцию PMRelease выпускать объект.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Эта функция подобна функции PMSessionEndDocument за исключением того, что подавлено диалоговое окно состояния печати.

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

    Функция PMSessionEndDocumentNoDialog должен быть вызван после его соответствия Begin функция (PMSessionBeginCGDocumentNoDialog или PMSessionBeginDocumentNoDialog). Если Begin функциональные возвраты noErr, функция PMSessionEndDocument даже если ошибки происходят в рамках, должен быть вызван Begin и End функции. Вы не должны вызывать PMSessionEndDocumentNoDialog если Begin функционируйте возвращает ошибку.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMSessionBeginPageNoDialog (_: _: _:) PMSessionBeginPageNoDialog

    Запускает новую страницу для печати в указанном сеансе печати и подавляет диалоговое окно состояния печати.

    Объявление

    Swift

    func PMSessionBeginPageNoDialog(_ printSession: PMPrintSession, _ pageFormat: PMPageFormat, _ pageFrame: UnsafePointer<PMRect>) -> OSStatus

    Objective C

    OSStatus PMSessionBeginPageNoDialog ( PMPrintSession printSession, PMPageFormat pageFormat, const PMRect *pageFrame );

    Параметры

    printSession

    Сеанс печати, обеспечивающий контекст для задания печати.

    pageFormat

    Формат страниц для новой страницы. Если Вы передаете NULL, система печати использует формат страниц, которому Вы передали PMSessionBeginCGDocumentNoDialog.

    pageFrame

    Необходимо передать NULL, поскольку этот параметр в настоящее время не поддерживается.

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

    Код результата. Если пользователь отменяет задание печати, эта функция возвраты kPMCancel.

    Обсуждение

    Эта функция подобна функции PMSessionBeginPage за исключением того, что функция PMSessionBeginPageNoDialog подавляет диалоговое окно состояния печати. Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession. Необходимо вызвать функции PMSessionBeginPageNoDialog и PMSessionEndPageNoDialog в рамках вызовов к Begin функция задания печати (PMSessionBeginCGDocumentNoDialog) и End функция задания печати (PMSessionEndDocumentNoDialog).

    Необходимо вызвать функцию PMSessionError сразу перед вызовом PMSessionBeginPageNoDialog. Если PMSessionError возвращает ошибку, тогда Вы не должны вызывать функцию PMSessionBeginPageNoDialog. Поскольку PMSessionBeginPage также инициализирует распечатывающий графический контекст, Ваше приложение не должно делать предположения о состоянии контекста (например, текущий шрифт) между последовательными страницами. После каждого вызова к PMSessionBeginPageNoDialog, Ваше приложение должно вызвать PMSessionGetCGGraphicsContext получить текущий контекст печати.

    Если функция PMSessionBeginPageNoDialog возвраты noErr, необходимо позже вызвать функцию PMSessionEndPageNoDialog, даже если ошибки происходят в рамках PMSessionBeginPageNoDialog и PMSessionEndPageNoDialog.

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

    Специальные замечания

    До OS X v10.5, pageFormat параметр проигнорирован. В OS X v10.5 и позже, система печати поддерживает многократные ориентации в задании печати. Когда Вы вызываете эту функцию и предоставляете формат страниц, ориентация, указанная в формате страниц, используется для текущей страницы. Проигнорированы другие настройки в формате страниц, такие как формат бумаги или масштабирование.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMSessionEndPageNoDialog (_:) PMSessionEndPageNoDialog

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

    Объявление

    Swift

    func PMSessionEndPageNoDialog(_ printSession: PMPrintSession) -> OSStatus

    Objective C

    OSStatus PMSessionEndPageNoDialog ( PMPrintSession printSession );

    Параметры

    printSession

    Сеанс печати, обеспечивающий контекст для задания печати.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Эта функция подобна функции PMSessionEndPage за исключением того, что подавлено диалоговое окно состояния печати.

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession. Необходимо вызвать функции PMSessionBeginPageNoDialog и PMSessionEndPageNoDialog в рамках вызовов к Begin функция задания печати (PMSessionBeginCGDocumentNoDialog) и End функция задания печати (PMSessionEndDocumentNoDialog).

    Если функция PMSessionBeginPageNoDialog возвраты noErr, необходимо позже вызвать функцию PMSessionEndPageNoDialog, даже если ошибки происходят в рамках PMSessionBeginPageNoDialog и PMSessionEndPageNoDialog. Вы не должны вызывать PMSessionEndPageNoDialog если PMSessionBeginPageNoDialog возвращает ошибку.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMSessionSetIdleProc PMSessionSetIdleProc Доступный в OS X v10.0 через OS X v10.7

    Устанавливает неактивную функцию обратного вызова в Вашем цикле печати.

    Оператор осуждения

    Нет никакой замены; эта функция была включена для упрощения унаследованных приложений портирования к OS X, но это не служит никакой полезной цели.

    Объявление

    Objective C

    OSStatus PMSessionSetIdleProc ( PMPrintSession printSession, PMIdleUPP idleProc );

    Параметры

    printSession

    Сеанс печати, обеспечивающий контекст для задания печати.

    idleProc

    Универсальный указатель процедуры на Вашу неактивную функцию. Ваша неактивная функция определяется обратным вызовом PMIdleProcPtr.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Вам не нужна эта функция в OS X. Вместо этого используйте стандарт, неактивный proc.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.7.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

Доступ к месту назначения задания печати
  • PMSessionSetDestination (_: _: _: _: _:) PMSessionSetDestination

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

    Объявление

    Swift

    func PMSessionSetDestination(_ printSession: PMPrintSession, _ printSettings: PMPrintSettings, _ destType: PMDestinationType, _ destFormat: CFString!, _ destLocation: CFURL!) -> OSStatus

    Objective C

    OSStatus PMSessionSetDestination ( PMPrintSession printSession, PMPrintSettings printSettings, PMDestinationType destType, CFStringRef destFormat, CFURLRef destLocation );

    Параметры

    printSession

    Сеанс печати, обеспечивающий контекст для задания печати.

    printSettings

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

    destType

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

    • kPMDestinationPrinter (вывод к принтеру)

    • kPMDestinationFile (вывод к файлу)

    • kPMDestinationFax (вывод к факсу)

    • kPMDestinationPreview (вывод к предварительному просмотру)

    • kPMDestinationProcessPDF (вывод к опции потока операций PDF)

    Посмотрите Целевые Типы для полного описания целевых типов, которые можно указать.

    destFormat

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

    destLocation

    Ссылка на Базовую Основу URL, указывающий целевое расположение. Если целевой тип поддерживает целевое расположение, можно обеспечить это. Иначе, передача NULL. Например, если целевой тип является файлом (kPMDestinationFile) можно предоставить файловую систему URL для указания, где находится файл.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMSessionGetDestinationType (_: _: _:) PMSessionGetDestinationType

    Получает выходное место назначения для задания печати.

    Объявление

    Swift

    func PMSessionGetDestinationType(_ printSession: PMPrintSession, _ printSettings: PMPrintSettings, _ destTypeP: UnsafeMutablePointer<PMDestinationType>) -> OSStatus

    Objective C

    OSStatus PMSessionGetDestinationType ( PMPrintSession printSession, PMPrintSettings printSettings, PMDestinationType *destTypeP );

    Параметры

    printSession

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

    printSettings

    Настройки печати для задания печати, место назначения которого Вы хотите получить.

    destTypeP

    Указатель на Ваш PMDestinationType переменная. По возврату переменная содержит целевой тип для указанного задания печати. Возможные значения включают:

    • kPMDestinationPrinter (вывод к принтеру)

    • kPMDestinationFile (вывод к файлу)

    • kPMDestinationFax (вывод к факсу)

    • kPMDestinationPreview (вывод к предварительному просмотру)

    • kPMDestinationProcessPDF (вывод к опции потока операций PDF)

    Посмотрите Целевые Типы для полного описания целевых констант типа.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession.

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMSessionCopyDestinationFormat (_: _: _:) PMSessionCopyDestinationFormat

    Получает целевой формат для задания печати.

    Объявление

    Swift

    func PMSessionCopyDestinationFormat(_ printSession: PMPrintSession, _ printSettings: PMPrintSettings, _ destFormatP: UnsafeMutablePointer<Unmanaged<CFString>?>) -> OSStatus

    Objective C

    OSStatus PMSessionCopyDestinationFormat ( PMPrintSession printSession, PMPrintSettings printSettings, CFStringRef *destFormatP );

    Параметры

    printSession

    Сеанс печати, обеспечивающий контекст для задания печати.

    printSettings

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

    destFormatP

    Указатель на Ваш CFStringRef переменная. По возврату переменная относится к Базовой строке Основы, содержащей целевой формат для задания печати. Вы ответственны за выпуск строки. В настоящее время существует два возможных значения: kPMDocumentFormatPDF или kPMDocumentFormatPostScript.

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

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMSessionCopyDestinationLocation (_: _: _:) PMSessionCopyDestinationLocation

    Получает целевое расположение для задания печати.

    Объявление

    Swift

    func PMSessionCopyDestinationLocation(_ printSession: PMPrintSession, _ printSettings: PMPrintSettings, _ destLocationP: UnsafeMutablePointer<Unmanaged<CFURL>?>) -> OSStatus

    Objective C

    OSStatus PMSessionCopyDestinationLocation ( PMPrintSession printSession, PMPrintSettings printSettings, CFURLRef *destLocationP );

    Параметры

    printSession

    Сеанс печати, обеспечивающий контекст для задания печати.

    printSettings

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

    destLocationP

    Указатель на Ваш CFURLRef переменная. По возврату переменная отсылает к Базовой Основе URL, указывающий целевое расположение задания печати. Вы ответственны за выпуск URL. Если NULL возвращается и функция выполняется без ошибки (код результата noErr), задание печати использует целевое расположение по умолчанию для текущего целевого типа. Если ошибка происходит, переменная установлена в NULL.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession.

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMSessionCopyOutputFormatList (_: _: _:) PMSessionCopyOutputFormatList

    Получает массив целевых форматов, поддерживаемых текущим местом назначения печати.

    Объявление

    Swift

    func PMSessionCopyOutputFormatList(_ printSession: PMPrintSession, _ destType: PMDestinationType, _ documentFormatP: UnsafeMutablePointer<Unmanaged<CFArray>?>) -> OSStatus

    Objective C

    OSStatus PMSessionCopyOutputFormatList ( PMPrintSession printSession, PMDestinationType destType, CFArrayRef *documentFormatP );

    Параметры

    printSession

    Сеанс печати, обеспечивающий контекст для задания печати. Принтер, связанный с этим сеансом, запрашивается для типов MIME, которые это поддерживает.

    destType

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

    documentFormatP

    Указатель на Ваш CFArrayRef переменная. По возврату переменная относится к Базовому массиву Основы, содержащему список целевых форматов, которые могут быть сгенерированы для текущего места назначения печати. Посмотрите Строки Формата документа для списка некоторых выходных форматов, которые могут быть возвращены.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

Создание объектов принтера
  • PMServerLaunchPrinterBrowser (_: _:) PMServerLaunchPrinterBrowser

    Запускает браузер принтера для просмотра принтеров, доступных для сервера печати.

    Объявление

    Swift

    func PMServerLaunchPrinterBrowser(_ server: PMServer, _ options: CFDictionary!) -> OSStatus

    Objective C

    OSStatus PMServerLaunchPrinterBrowser ( PMServer server, CFDictionaryRef options );

    Параметры

    server

    Сервер печати для просмотра. Передача kPMServerLocal указать локальный сервер печати. В настоящее время можно указать только локальный сервер печати.

    options

    Этот параметр резервируется для будущего использования. В настоящее время, передача NULL. Передача NULL представляет браузер принтера способом по умолчанию.

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

    Код результата. Посмотрите Базовые Коды Результата Печати. При указании сервера, принтеры которого не могут быть просмотрены, эта функция возвращает код ошибки kPMInvalidParameter.

    Обсуждение

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMServerCreatePrinterList (_: _:) PMServerCreatePrinterList

    Создает список принтеров, доступных серверу печати.

    Объявление

    Swift

    func PMServerCreatePrinterList(_ server: PMServer, _ printerList: UnsafeMutablePointer<Unmanaged<CFArray>?>) -> OSStatus

    Objective C

    OSStatus PMServerCreatePrinterList ( PMServer server, CFArrayRef *printerList );

    Параметры

    server

    Сервер печати, принтеры которого Вы хотите получить. Для указания локального сервера печати передайте константу kPMServerLocal. В настоящее время можно указать только локальный сервер печати.

    printerList

    Указатель на Ваш CFArrayRef переменная. По возврату переменная относится к Базовому массиву Основы, содержащему принтеры, доступные указанному серверу печати. Каждый элемент в массиве является a PMPrinter объект. Вы ответственны за выпуск массива.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMSessionCreatePrinterList (_: _: _: _:) PMSessionCreatePrinterList

    Создает список принтеров, доступных в указанном сеансе печати.

    Объявление

    Swift

    func PMSessionCreatePrinterList(_ printSession: PMPrintSession, _ printerList: UnsafeMutablePointer<Unmanaged<CFArray>?>, _ currentIndex: UnsafeMutablePointer<CFIndex>, _ currentPrinter: UnsafeMutablePointer<PMPrinter>) -> OSStatus

    Objective C

    OSStatus PMSessionCreatePrinterList ( PMPrintSession printSession, CFArrayRef *printerList, CFIndex *currentIndex, PMPrinter *currentPrinter );

    Параметры

    printSession

    Сеанс печати, список принтера которого Вы хотите получить.

    printerList

    Указатель на Ваш CFArrayRef переменная. По возврату переменная относится к Базовому массиву Основы, содержащему список принтеров, доступных в указанном сеансе печати. Каждый элемент в массиве является Базовой строкой Основы, содержащей имя принтера как показано в пользовательском интерфейсе. Вы ответственны за выпуск массива.

    currentIndex

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

    currentPrinter

    Указатель на Ваш PMPrinter переменная. По возврату переменная относится к объекту принтера, представляющему текущий принтер. Вы не должны выпускать объект принтера без первого сохранения его. Если принтер является универсальным принтером, переменная установлена в NULL.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession.

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

    Специальные замечания

    В OS X v10.2 и позже, Apple рекомендует использовать функцию PMServerCreatePrinterList вместо этого. PMServerCreatePrinterList не требует a PMSession объект; в любое время это можно вызвать. Это также работает непосредственно с PMPrinter объекты.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMServerCreatePrinterList

  • PMPrinterCreateFromPrinterID (_:) PMPrinterCreateFromPrinterID

    Создает объект принтера из идентификатора очереди печати.

    Объявление

    Swift

    func PMPrinterCreateFromPrinterID(_ printerID: CFString!) -> PMPrinter

    Objective C

    PMPrinter PMPrinterCreateFromPrinterID ( CFStringRef printerID );

    Параметры

    printerID

    Уникальный идентификатор очереди печати.

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

    Новый объект принтера, или NULL если никакая очередь печати не доступна с указанным идентификатором. Вы ответственны за выпуск объекта принтера с функцией PMRelease.

    Обсуждение

    Эта функция обычно используется для воссоздавания объекта принтера использование очереди печати ID, полученный вызовом к PMPrinterGetID в более раннее время. Если очередь печати удалена после получения ID, эта функция возвраты NULL для того ID.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMPrinterGetID

  • PMCreateGenericPrinter (_:) PMCreateGenericPrinter

    Создает универсальный объект принтера.

    Объявление

    Swift

    func PMCreateGenericPrinter(_ printer: UnsafeMutablePointer<PMPrinter>) -> OSStatus

    Objective C

    OSStatus PMCreateGenericPrinter ( PMPrinter *printer );

    Параметры

    printer

    Указатель на Ваш PMPrinter переменная. По возврату переменная относится к новому объекту принтера, представляющему универсальный принтер форматирования. Вы ответственны за выпуск объекта принтера с функцией PMRelease.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

Доступ к информации о принтере
  • PMPrinterCopyDescriptionURL (_: _: _:) PMPrinterCopyDescriptionURL

    Получает URL файла описания для данного принтера.

    Объявление

    Swift

    func PMPrinterCopyDescriptionURL(_ printer: PMPrinter, _ descriptionType: CFString!, _ fileURL: UnsafeMutablePointer<Unmanaged<CFURL>?>) -> OSStatus

    Objective C

    OSStatus PMPrinterCopyDescriptionURL ( PMPrinter printer, CFStringRef descriptionType, CFURLRef *fileURL );

    Параметры

    printer

    Принтер, файл описания которого Вы хотите получить.

    descriptionType

    Константа, указывающая желаемый тип файла описания принтера. В настоящее время необходимо передать константу kPMPPDDescriptionType.

    fileURL

    Указатель на Ваш CFURLRef переменная. По возврату переменная отсылает к Базовой Основе URL, указывающий расположение файла, содержащего описание указанного принтера. Вы ответственны за выпуск URL. Если ошибка происходит, переменная установлена в NULL.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Можно использовать эту функцию для определения местоположения файла Описания принтера PostScript (PPD) для принтера.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinterCopyDeviceURI (_: _:) PMPrinterCopyDeviceURI

    Получает устройство URI данного принтера.

    Объявление

    Swift

    func PMPrinterCopyDeviceURI(_ printer: PMPrinter, _ deviceURI: UnsafeMutablePointer<Unmanaged<CFURL>?>) -> OSStatus

    Objective C

    OSStatus PMPrinterCopyDeviceURI ( PMPrinter printer, CFURLRef *deviceURI );

    Параметры

    printer

    Принтер, устройство которого URI Вы хотите получить.

    deviceURI

    Указатель на Ваш CFURLRef переменная. По возврату переменная отсылает к Базовой Основе URL, указывающий устройство принтера URI. Вы ответственны за выпуск URL. Если ошибка происходит, переменная установлена в NULL.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    URI устройства принтера описывает, как связаться с устройством. Для некоторых устройств это также включает уникальный идентификатор для устройства.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinterCopyHostName (_: _:) PMPrinterCopyHostName

    Получает имя сервера, размещающего очередь печати для данного принтера.

    Объявление

    Swift

    func PMPrinterCopyHostName(_ printer: PMPrinter, _ hostNameP: UnsafeMutablePointer<Unmanaged<CFString>?>) -> OSStatus

    Objective C

    OSStatus PMPrinterCopyHostName ( PMPrinter printer, CFStringRef *hostNameP );

    Параметры

    printer

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

    hostNameP

    Указатель на Ваш CFStringRef переменная. По возврату переменная относится к Базовой строке Основы, содержащей имя сервера указанного принтера. Вы ответственны за выпуск строки.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Эта функция обычно используется для получения имени компьютера, размещающего общий принтер, возможно для дисплея в пользовательском интерфейсе. В OS X v10.5 и позже, типичный способ, которым пользователи просматривают и связываются с общим принтером, создает локальную очередь печати и PMPrinterCopyHostName поскольку такая очередь печати возвратит имя локального узла.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinterCopyPresets (_: _:) PMPrinterCopyPresets

    Получает список предварительных установок настроек печати для принтера.

    Объявление

    Swift

    func PMPrinterCopyPresets(_ printer: PMPrinter, _ presetList: UnsafeMutablePointer<Unmanaged<CFArray>?>) -> OSStatus

    Objective C

    OSStatus PMPrinterCopyPresets ( PMPrinter printer, CFArrayRef *presetList );

    Параметры

    printer

    Принтер, предварительные установки которого Вы хотите получить.

    presetList

    Указатель на Ваш CFArrayRef переменная. По возврату переменная относится к Базовому массиву Основы, содержащему предварительные установки для указанного принтера. Каждый элемент в массиве является объектом типа PMPreset. Вы ответственны за выпуск массива.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Принтер, возможно, связал с ним список предварительно установленных настроек. Каждая установка оптимизирована для определенной ситуации с печатью. Эта функция возвращает все предварительные установки для данного принтера. Для получения большей информации об определенной предварительной установке можно использовать функцию PMPresetGetAttributes. Для создания объекта настроек печати, содержащего настройки предварительной установки вызвать PMPresetCreatePrintSettings.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinterGetCommInfo (_: _: _:) PMPrinterGetCommInfo

    Получает информацию о канале передачи для принтера.

    Объявление

    Swift

    func PMPrinterGetCommInfo(_ printer: PMPrinter, _ supportsTransparentP: UnsafeMutablePointer<Boolean>, _ supportsEightBitP: UnsafeMutablePointer<Boolean>) -> OSStatus

    Objective C

    OSStatus PMPrinterGetCommInfo ( PMPrinter printer, Boolean *supportsControlCharRangeP, Boolean *supportsEightBitP );

    Параметры

    printer

    Принтер, информацию которого Вы хотите получить.

    supportsTransparentP

    Указатель на Вашу Логическую переменную. По возврату, true указывает, что канал передачи к указанному принтеру поддерживает байты в диапазоне 0x0–0x1F; иначе, false.

    supportsEightBitP

    Указатель на Вашу Логическую переменную. По возврату, true указывает, что канал передачи к указанному принтеру поддерживает байты в диапазоне 0x80–0xFF; иначе, false.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Эта функция обычно относится только к принтерам PostScript. Все принтеры PostScript, независимо от того, что канал передачи используется, чтобы отправить данным им, данным поддержки в диапазоне 0x20–0x7F. Много каналов передачи могут поддерживать данные вне этого диапазона. Можно использовать эту функцию, чтобы определить, поддерживает ли канал передачи к указанному принтеру также байты в диапазонах 0x0–0x1F и 0x80–0xFF.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinterGetDescriptionURL PMPrinterGetDescriptionURL Доступный в OS X v10.0 через OS X v10.9

    Получает ссылку на файл описания указанного принтера.

    Оператор осуждения

    Использовать PMPrinterCopyDescriptionURL вместо этого.

    Объявление

    Objective C

    OSStatus PMPrinterGetDescriptionURL ( PMPrinter printer, CFStringRef descriptionType, CFURLRef *fileURL );

    Параметры

    printer

    Принтер, файл описания которого Вы хотите получить.

    descriptionType

    Базовая строка Основы, указывающая тип файла описания для выбранного принтера. В настоящее время существует только один определенный тип —kPMPPDDescriptionType.

    fileURL

    Указатель на Ваш CFURLRef переменная. По возврату переменная относится к URL для файла описания принтера. Несмотря на имя, функцию PMPrinterGetDescriptionURL имеет Создают/Копируют семантику, что означает, что вызывающая сторона должна выпустить возвращенный URL, если это не NULL и код результата noErr возвращается.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Можно использовать эту функцию для получения ссылки на файл Описания принтера PostScript (PPD) для принтера PostScript.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

  • PMPrinterGetDeviceURI PMPrinterGetDeviceURI Доступный в OS X v10.2 через OS X v10.9

    Получает копию устройства принтера URI.

    Оператор осуждения

    Использовать PMPrinterCopyDeviceURI вместо этого.

    Объявление

    Objective C

    OSStatus PMPrinterGetDeviceURI ( PMPrinter printer, CFURLRef *deviceURI );

    Параметры

    printer

    Принтер, устройство которого URI Вы хотите получить.

    deviceURI

    Указатель на Ваш CFURLRef переменная. По возврату переменная относится к URI для расположения устройства принтера. Несмотря на имя, эта функция имеет, Создают/Копируют семантику, что означает, что вызывающая сторона должна выпустить возвращенный URL, если это не NULL и код результата noErr возвращается.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.2 через OS X v10.9.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

  • PMPrinterGetDriverCreator (_: _:) PMPrinterGetDriverCreator

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

    Объявление

    Swift

    func PMPrinterGetDriverCreator(_ printer: PMPrinter, _ creator: UnsafeMutablePointer<OSType>) -> OSStatus

    Objective C

    OSStatus PMPrinterGetDriverCreator ( PMPrinter printer, OSType *creator );

    Параметры

    printer

    Принтер, создателя драйвера которого Вы хотите получить.

    creator

    По возврату, 4-байтовому коду создателя драйвера (например, 'APPL' для драйвера принтера Apple).

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinterGetDriverReleaseInfo (_: _:) PMPrinterGetDriverReleaseInfo

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

    Объявление

    Swift

    func PMPrinterGetDriverReleaseInfo(_ printer: PMPrinter, _ release: UnsafeMutablePointer<VersRec>) -> OSStatus

    Objective C

    OSStatus PMPrinterGetDriverReleaseInfo ( PMPrinter printer, VersRec *release );

    Параметры

    printer

    Принтер, версию драйвера которого Вы хотите получить.

    release

    Указатель на Ваш VersRec структура данных. По возврату структура содержит водительские короткие и долгие строки версии и код страны.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinterGetID (_:) PMPrinterGetID

    Возвращает уникальный идентификатор принтера.

    Объявление

    Swift

    func PMPrinterGetID(_ printer: PMPrinter) -> Unmanaged<CFString>!

    Objective C

    CFStringRef PMPrinterGetID ( PMPrinter printer );

    Параметры

    printer

    Принтер, идентификатор которого Вы хотите получить.

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

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

    Обсуждение

    Можно использовать функцию PMPrinterGetID получать информацию о принтере для более позднего использования. Для создания объекта принтера из принтера ID, возвращенный этой функцией, используйте функцию PMPrinterCreateFromPrinterID.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinterGetLanguageInfo (_: _:) PMPrinterGetLanguageInfo

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

    Объявление

    Swift

    func PMPrinterGetLanguageInfo(_ printer: PMPrinter, _ info: UnsafeMutablePointer<PMLanguageInfo>) -> OSStatus

    Objective C

    OSStatus PMPrinterGetLanguageInfo ( PMPrinter printer, PMLanguageInfo *info );

    Параметры

    printer

    Принтер, чью информацию о языке обработки изображений Вы хотите получить.

    info

    Указатель на Ваш PMLanguageInfo структура данных. По возврату структура содержит уровень языка принтера, версию и информацию о выпуске. Формат возвращенных данных использует синтаксис языка PostScript.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Функция PMPrinterGetLanguageInfo полезно только для принтеров PostScript. Необходимо вызвать эту функцию между созданием и выпуском сеанса печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinterGetLocation (_:) PMPrinterGetLocation

    Возвращает расположение принтера.

    Объявление

    Swift

    func PMPrinterGetLocation(_ printer: PMPrinter) -> Unmanaged<CFString>!

    Objective C

    CFStringRef PMPrinterGetLocation ( PMPrinter printer );

    Параметры

    printer

    Принтер, расположение которого Вы хотите получить.

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

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

    Обсуждение

    Когда пользователь создает очередь печати для принтера, расположение принтера указано. В некоторых случаях система печати автоматически определяет расположение. Например, расположение может быть установлено в “Локальную Зону”. Пользователь, создающий очередь печати, может также установить расположение.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinterGetMakeAndModelName (_: _:) PMPrinterGetMakeAndModelName

    Получает производителя и имя модели указанного принтера.

    Объявление

    Swift

    func PMPrinterGetMakeAndModelName(_ printer: PMPrinter, _ makeAndModel: UnsafeMutablePointer<Unmanaged<CFString>?>) -> OSStatus

    Objective C

    OSStatus PMPrinterGetMakeAndModelName ( PMPrinter printer, CFStringRef *makeAndModel );

    Параметры

    printer

    Принтер, производителя которого и имя модели Вы хотите получить.

    makeAndModel

    Указатель на Ваш CFStringRef переменная. По возврату переменная относится к Базовой строке Основы, содержащей производителя и имя модели указанного принтера. Вы не должны выпускать строку без первого сохранения его. Если ошибка происходит, переменная установлена в NULL.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinterGetMimeTypes (_: _: _:) PMPrinterGetMimeTypes

    Получает список типов контента MIME, поддерживаемых принтером с помощью указанных настроек печати.

    Объявление

    Swift

    func PMPrinterGetMimeTypes(_ printer: PMPrinter, _ settings: PMPrintSettings, _ mimeTypes: UnsafeMutablePointer<Unmanaged<CFArray>?>) -> OSStatus

    Objective C

    OSStatus PMPrinterGetMimeTypes ( PMPrinter printer, PMPrintSettings settings, CFArrayRef *mimeTypes );

    Параметры

    printer

    Принтер, поддерживаемые типы MIME которого Вы хотите получить.

    settings

    Настройки печати для задания печати. Объект настроек печати содержит место назначения задания, влияющее на доступные типы. Этот параметр может быть NULL.

    mimeTypes

    Указатель на Ваш CFArrayRef переменная. По возврату переменная относится к Базовому массиву Основы, содержащему типы MIME, поддерживаемые указанным принтером. Каждый элемент в массиве является Базовой строкой Основы. Вы не должны выпускать массив без первого сохранения его.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Эта функция получает типы данных, которые могут быть представлены принтеру с указанными настройками печати; например, application/pdf. Эта функция обычно используется в сочетании с функцией PMPrinterPrintWithFile.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinterGetName (_:) PMPrinterGetName

    Возвращает человекочитаемое имя принтера.

    Объявление

    Swift

    func PMPrinterGetName(_ printer: PMPrinter) -> Unmanaged<CFString>!

    Objective C

    CFStringRef PMPrinterGetName ( PMPrinter printer );

    Параметры

    printer

    Принтер, имя которого Вы хотите получить.

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

    Имя указанного принтера. Это имя идентифицирует принтер в пользовательском интерфейсе. Вы не должны выпускать строку без первого сохранения его.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinterGetOutputResolution (_: _: _:) PMPrinterGetOutputResolution

    Получает аппаратное выходное разрешение принтера для указанных настроек печати.

    Объявление

    Swift

    func PMPrinterGetOutputResolution(_ printer: PMPrinter, _ printSettings: PMPrintSettings, _ resolutionP: UnsafeMutablePointer<PMResolution>) -> OSStatus

    Objective C

    OSStatus PMPrinterGetOutputResolution ( PMPrinter printer, PMPrintSettings printSettings, PMResolution *resolutionP );

    Параметры

    printer

    Принтер, выходное разрешение которого Вы хотите получить.

    printSettings

    Настройки печати Вы хотите использовать.

    resolutionP

    Указатель на Ваш PMResolution структура. По возврату структура содержит выходное разрешение указанного принтера в пикселях на дюйм.

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

    Код результата. Если разрешение не может быть надежно определено, эта функция возвращает ошибку.

    Обсуждение

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

    Большинство приложений не должно использовать эту функцию, потому что они рисуют то же содержание независимо от устройства назначения. Для тех немногих приложений, действительно корректирующих их получение на основе устройства вывода, они должны только сделать так, когда место назначения задания печати kPMDestinationPrinter или kPMDestinationFax. Можно использовать функцию PMSessionGetDestinationType определить место назначения для задания печати.

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMPrinterSetOutputResolution

  • PMPrinterSetOutputResolution (_: _: _:) PMPrinterSetOutputResolution

    Устанавливает настройки печати для отражения указанного аппаратного выходного разрешения принтера.

    Объявление

    Swift

    func PMPrinterSetOutputResolution(_ printer: PMPrinter, _ printSettings: PMPrintSettings, _ resolutionP: UnsafePointer<PMResolution>) -> OSStatus

    Objective C

    OSStatus PMPrinterSetOutputResolution ( PMPrinter printer, PMPrintSettings printSettings, const PMResolution *resolutionP );

    Параметры

    printer

    Принтер, выходное разрешение которого Вы хотите изменить.

    printSettings

    Объект настроек печати используется для задания печати.

    resolutionP

    Указатель на a PMResolution структура, указывающая нужное разрешение в пикселях на дюйм.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMPrinterGetOutputResolution

  • PMPrinterGetPaperList (_: _:) PMPrinterGetPaperList

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

    Объявление

    Swift

    func PMPrinterGetPaperList(_ printer: PMPrinter, _ paperList: UnsafeMutablePointer<Unmanaged<CFArray>?>) -> OSStatus

    Objective C

    OSStatus PMPrinterGetPaperList ( PMPrinter printer, CFArrayRef *paperList );

    Параметры

    printer

    Принтер, бумажный список которого Вы хотите получить.

    paperList

    Указатель на Ваш CFArrayRef переменная. По возврату переменная относится к Базовому массиву Основы, содержащему бумажный список для указанного принтера. Каждый элемент в массиве является объектом типа PMPaper. Вы не должны выпускать массив без первого сохранения его.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinterGetPrinterResolution PMPrinterGetPrinterResolution Доступный в OS X v10.0 через OS X v10.9

    Получает настройку разрешения для указанного принтера.

    Оператор осуждения

    Использовать PMPrinterGetPrinterResolutionCount и PMPrinterGetIndexedPrinterResolution исследовать доступные разрешения принтера.

    Объявление

    Objective C

    OSStatus PMPrinterGetPrinterResolution ( PMPrinter printer, PMTag tag, PMResolution *res );

    Параметры

    printer

    Принтер, разрешение которого Вы хотите получить.

    tag

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

    res

    Указатель на Ваш PMResolution структура данных. По возврату структура содержит настройку разрешения, связанную со значением тега.

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

    Код результата. Код результата kPMNotImplemented указывает, что драйвер принтера не поддерживает многократные настройки разрешения.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    Не доступный 64-разрядным приложениям.

  • PMPrinterGetPrinterResolutionCount (_: _:) PMPrinterGetPrinterResolutionCount

    Получает число настроек разрешения, поддерживаемых указанным принтером.

    Объявление

    Swift

    func PMPrinterGetPrinterResolutionCount(_ printer: PMPrinter, _ count: UnsafeMutablePointer<UInt32>) -> OSStatus

    Objective C

    OSStatus PMPrinterGetPrinterResolutionCount ( PMPrinter printer, UInt32 *countP );

    Параметры

    printer

    Принтер, чье число настроек разрешения Вы хотите получить.

    count

    Указатель на Ваш UInt32 переменная. По возврату переменная содержит число разрешений, поддерживающихся для указанного принтера.

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

    Код результата. Код результата kPMNotImplemented указывает, что драйвер принтера не поддерживает многократные настройки разрешения.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinterGetIndexedPrinterResolution (_: _: _:) PMPrinterGetIndexedPrinterResolution

    Получает настройку разрешения на основе индекса в диапазон настроек, поддерживаемых указанным принтером.

    Объявление

    Swift

    func PMPrinterGetIndexedPrinterResolution(_ printer: PMPrinter, _ index: UInt32, _ res: UnsafeMutablePointer<PMResolution>) -> OSStatus

    Objective C

    OSStatus PMPrinterGetIndexedPrinterResolution ( PMPrinter printer, UInt32 index, PMResolution *resolutionP );

    Параметры

    printer

    Принтер, разрешение которого Вы хотите получить.

    index

    Индекс в диапазон настроек разрешения поддерживается указанным принтером. Индексные значения начинаются в 1.

    res

    Указатель на Ваш PMResolution структура данных. По возврату структура содержит установку разрешения принтера, связанную с индексным значением.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinterGetState (_: _:) PMPrinterGetState

    Получает текущее состояние очереди печати для принтера.

    Объявление

    Swift

    func PMPrinterGetState(_ printer: PMPrinter, _ state: UnsafeMutablePointer<PMPrinterState>) -> OSStatus

    Objective C

    OSStatus PMPrinterGetState ( PMPrinter printer, PMPrinterState *state );

    Параметры

    printer

    Принтер, очередь которого утверждает Вас, хочет получить.

    state

    Указатель на Ваш PMPrinterState переменная. По возврату переменная содержит константу, указывающую текущее состояние очереди печати для указанного принтера. Поддерживаемые значения:

    • kPMPrinterIdle (очередь неактивна),

    • kPMPrinterProcessing (очередь обрабатывает задание),

    • kPMPrinterStopped (очередь останавливается),

    Посмотрите состояния Очереди печати для полного описания этих констант.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinterSetDefault (_:) PMPrinterSetDefault

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

    Объявление

    Swift

    func PMPrinterSetDefault(_ printer: PMPrinter) -> OSStatus

    Objective C

    OSStatus PMPrinterSetDefault ( PMPrinter printer );

    Параметры

    printer

    Принтер для установки как принтер по умолчанию.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinterIsDefault (_:) PMPrinterIsDefault

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

    Объявление

    Swift

    func PMPrinterIsDefault(_ printer: PMPrinter) -> Boolean

    Objective C

    Boolean PMPrinterIsDefault ( PMPrinter printer );

    Параметры

    printer

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

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

    Если true, указанный принтер является принтером по умолчанию для текущего пользователя; иначе, false.

    Обсуждение

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinterIsFavorite (_:) PMPrinterIsFavorite

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

    Объявление

    Swift

    func PMPrinterIsFavorite(_ printer: PMPrinter) -> Boolean

    Objective C

    Boolean PMPrinterIsFavorite ( PMPrinter printer );

    Параметры

    printer

    Принтер Вы ищете в любимом списке принтера.

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

    Если true, указанный принтер находится в списке пользователя любимых принтеров; иначе, false.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinterIsPostScriptCapable (_:) PMPrinterIsPostScriptCapable

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

    Объявление

    Swift

    func PMPrinterIsPostScriptCapable(_ printer: PMPrinter) -> Boolean

    Objective C

    Boolean PMPrinterIsPostScriptCapable ( PMPrinter printer );

    Параметры

    printer

    Принтер, который Вы запрашиваете, чтобы определить, является ли это способным PostScript.

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

    Если true, указанный принтер является PostScript способный принтер; иначе, false.

    Обсуждение

    Принтер, который является способным PostScript, является не обязательно принтером PostScript. Система печати OS X может представить содержание PostScript на принтерах не-PostScript.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinterIsPostScriptPrinter (_: _:) PMPrinterIsPostScriptPrinter

    Определяет, является ли принтер принтером PostScript.

    Объявление

    Swift

    func PMPrinterIsPostScriptPrinter(_ printer: PMPrinter, _ isPSPrinter: UnsafeMutablePointer<Boolean>) -> OSStatus

    Objective C

    OSStatus PMPrinterIsPostScriptPrinter ( PMPrinter printer, Boolean *isPSPrinter );

    Параметры

    printer

    Принтер, который Вы запрашиваете, чтобы определить, является ли это принтером PostScript.

    isPSPrinter

    Указатель на Вашу Логическую переменную. По возврату, true указывает, что указанный принтер является принтером PostScript; иначе, false.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Если драйвер принтера берет PostScript непосредственно, принтер является принтером PostScript.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinterIsRemote (_: _:) PMPrinterIsRemote

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

    Объявление

    Swift

    func PMPrinterIsRemote(_ printer: PMPrinter, _ isRemoteP: UnsafeMutablePointer<Boolean>) -> OSStatus

    Objective C

    OSStatus PMPrinterIsRemote ( PMPrinter printer, Boolean *isRemoteP );

    Параметры

    printer

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

    isRemoteP

    Указатель на Вашу Логическую переменную. По возврату, true указывает, что принтер размещается удаленным сервером печати; иначе, false.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

    В OS X типичный способ, которым пользователи создают очередь печати для общего принтера, путем просмотра. Очереди печати для общих принтеров, создающихся просмотром, отмечены как удаленные очереди, и PMPrinterIsRemote возвраты true для таких принтеров. Однако опытные пользователи могут создать локальную очередь для удаленного принтера вручную, и такой принтер, кажется, не удаленный принтер.

    Является ли принтер удаленным, получен из атрибута типа принтера CUPS для очереди печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

Представление задания печати к принтеру
  • PMPrinterPrintWithFile (_: _: _: _: _:) PMPrinterPrintWithFile

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

    Объявление

    Swift

    func PMPrinterPrintWithFile(_ printer: PMPrinter, _ settings: PMPrintSettings, _ format: PMPageFormat, _ mimeType: CFString!, _ fileURL: CFURL!) -> OSStatus

    Objective C

    OSStatus PMPrinterPrintWithFile ( PMPrinter printer, PMPrintSettings settings, PMPageFormat format, CFStringRef mimeType, CFURLRef fileURL );

    Параметры

    printer

    Целевой принтер.

    settings

    Настройки печати для задания печати.

    format

    Физический размер страницы и ориентация, с которой должен быть распечатан документ. Этот параметр может быть NULL.

    mimeType

    Тип MIME данных, которые будут распечатаны. Если этот параметр NULL, тип MIME будет определен автоматически. Можно получить список типов MIME, поддерживаемых данным принтером с помощью функции PMPrinterGetMimeTypes.

    fileURL

    URL файла, снабжающего данными печати.

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

    Код результата. Посмотрите Базовые Коды Результата Печати. Если указанный принтер не может обработать тип MIME файла, ненулевой код ошибки возвращается.

    Обсуждение

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMPrinterPrintWithProvider

  • PMPrinterPrintWithProvider (_: _: _: _: _:) PMPrinterPrintWithProvider

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

    Объявление

    Swift

    func PMPrinterPrintWithProvider(_ printer: PMPrinter, _ settings: PMPrintSettings, _ format: PMPageFormat, _ mimeType: CFString!, _ provider: CGDataProvider!) -> OSStatus

    Objective C

    OSStatus PMPrinterPrintWithProvider ( PMPrinter printer, PMPrintSettings settings, PMPageFormat format, CFStringRef mimeType, CGDataProviderRef provider );

    Параметры

    printer

    Целевой принтер.

    settings

    Настройки печати для задания печати.

    format

    Физический размер страницы и ориентация, с которой должен быть распечатан документ. Этот параметр может быть NULL.

    mimeType

    Тип MIME данных, которые будут распечатаны. Этот параметр не может быть NULL. Если Вы хотите автоматический ввод, используйте функцию PMPrinterPrintWithFile вместо этого. Можно получить список типов MIME, поддерживаемых данным принтером с помощью функции PMPrinterGetMimeTypes.

    provider

    Провайдер данных, снабжающий данными печати.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

    Специальные замечания

    В OS X v10.4 и ранее, эта функция не реализована и возвращает код ошибки –1, когда вызвано. Можно записать данные печати в файл и использование PMPrinterPrintWithFile вместо этого.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

    См. также

    PMPrinterPrintWithFile

Доступ к файлам описания принтера PostScript
  • PMCopyAvailablePPDs (_: _:) PMCopyAvailablePPDs

    Получает список файлов Описания принтера PostScript (PPD) в домене PPD.

    Объявление

    Swift

    func PMCopyAvailablePPDs(_ domain: PMPPDDomain, _ ppds: UnsafeMutablePointer<Unmanaged<CFArray>?>) -> OSStatus

    Objective C

    OSStatus PMCopyAvailablePPDs ( PMPPDDomain domain, CFArrayRef *ppds );

    Параметры

    domain

    Домен PPD для поиска. Посмотрите Домены Файла описания принтера PostScript для описания констант, которые можно использовать для указания домена.

    ppds

    Указатель на Ваш CFArrayRef переменная. По возврату переменная относится к Базовому массиву Основы файлов PPD в указанном домене. Каждый элемент в массиве является Базовой Основой объект URL, указывающий расположение файла PPD или сжатого файла PPD. Вы ответственны за выпуск массива. Если указанный домен не допустим, переменная установлена в NULL.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMCopyLocalizedPPD (_: _:) PMCopyLocalizedPPD

    Получает локализованный файл Описания принтера PostScript (PPD).

    Объявление

    Swift

    func PMCopyLocalizedPPD(_ ppd: CFURL!, _ localizedPPD: UnsafeMutablePointer<Unmanaged<CFURL>?>) -> OSStatus

    Objective C

    OSStatus PMCopyLocalizedPPD ( CFURLRef ppd, CFURLRef *localizedPPD );

    Параметры

    ppd

    Базовая Основа URL возражает для файла PPD. Можно получить PPD URL с помощью функции PMCopyAvailablePPDs.

    localizedPPD

    Указатель на Ваш CFURLRef переменная. По возврату переменная отсылает к Базовой Основе объект URL. URL Указывает расположение файла PPD или сжатого файла PPD, локализованного для предпочтения языка текущего пользователя. Вы ответственны за выпуск URL. Если ppd параметр не допустим, переменная установлена в NULL.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Для доступа к данным в файле PPD можно использовать функцию PMCopyPPDData.

    Специальные замечания

    В OS X v10.5 и позже, системные поддержки печати глобализировали файлы PPD, как определено в версии 1.2 CUPS и позже. Глобализированный файл PPD содержит многократные локализации в единственном файле. Если глобализированный файл PPD существует, эта функция возвращает URL этому файлу, и это до приложения для получения корректных локализованных данных. Для получения дополнительной информации посмотрите CUPS Расширения PPD.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMCopyPPDData (_: _:) PMCopyPPDData

    Получает несжатые данные PPD для файла Описания принтера PostScript (PPD).

    Объявление

    Swift

    func PMCopyPPDData(_ ppd: CFURL!, _ data: UnsafeMutablePointer<Unmanaged<CFData>?>) -> OSStatus

    Objective C

    OSStatus PMCopyPPDData ( CFURLRef ppd, CFDataRef *data );

    Параметры

    ppd

    URL для PPD или сжатого файла PPD. Можно получить PPD URL с помощью функции PMCopyAvailablePPDs или PMCopyLocalizedPPD.

    data

    Указатель на Ваш CFDataRef переменная. По возврату переменная относится к Базовому объекту данных Основы, содержащему несжатые данные PPD от указанного файла PPD. Вы ответственны за выпуск объекта данных. Если ppd параметр не ссылается на файл PPD, переменная установлена в NULL.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

Печать с данными PostScript
  • PMCGImageCreateWithEPSDataProvider (_: _:) PMCGImageCreateWithEPSDataProvider

    Создает изображение, которое ссылки и содержание PostScript данных EPS и предварительный просмотр (прокси) отображают для данных.

    Объявление

    Swift

    func PMCGImageCreateWithEPSDataProvider(_ epsDataProvider: CGDataProvider!, _ epsPreview: CGImage!) -> Unmanaged<CGImage>!

    Objective C

    CGImageRef PMCGImageCreateWithEPSDataProvider ( CGDataProviderRef epsDataProvider, CGImageRef epsPreview );

    Параметры

    epsDataProvider

    Кварцевый провайдер данных, предоставляющий содержание PostScript файла EPS. Данные EPS должны начаться с требуемого заголовка EPSF и ограничительной рамки DSC (Соглашения Структурирования документов) комментарии.

    epsPreview

    Кварцевое изображение, служащее изображением прокси для файла EPS. Когда изображение, возвращенное этой функцией, представляется на экране или отправляется в принтер, который не может представить PostScript, это изображение прокси нарисовано вместо этого.

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

    Изображение, способное к рендерингу или содержание EPS или изображение прокси, в зависимости от возможностей целевого принтера.

    Обсуждение

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

    Обратите внимание на то, что в OS X v10.3 и позже, Кварц может преобразовать данные EPS в данные PDF. Использование этой функции и затем использование Кварца для рисования получающихся данных PDF могут привести к превосходящим результатам для приложения. См. Ссылку CGPSConverter для подробных данных.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinterWritePostScriptToURL (_: _: _: _: _: _:) PMPrinterWritePostScriptToURL

    Преобразовывает входной файл указанного типа MIME к готовому к принтеру PostScript для целевого принтера.

    Объявление

    Swift

    func PMPrinterWritePostScriptToURL(_ printer: PMPrinter, _ settings: PMPrintSettings, _ format: PMPageFormat, _ mimeType: CFString!, _ sourceFileURL: CFURL!, _ destinationFileURL: CFURL!) -> OSStatus

    Objective C

    OSStatus PMPrinterWritePostScriptToURL ( PMPrinter printer, PMPrintSettings settings, PMPageFormat format, CFStringRef mimeType, CFURLRef sourceFileURL, CFURLRef destinationFileURL );

    Параметры

    printer

    Целевой принтер, для которого будет сгенерирован готовый к принтеру PostScript.

    settings

    Настройки печати для задания печати.

    format

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

    mimeType

    Тип MIME файла, который будет распечатан. Если Вы передаете NULL, файл вводится автоматически. Можно получить список типов MIME, поддерживаемых данным принтером с помощью функции PMPrinterGetMimeTypes.

    sourceFileURL

    URL, указывающий входной файл, который будет преобразован в готовые к принтеру данные PostScript. Только основанный на файле URLs поддерживается.

    destinationFileURL

    URL, указывающий целевой файл, который будет создаваться. Если файл уже будет существовать, то он будет перезаписан. Только основанный на файле URLs поддерживается.

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

    Код результата. Если система печати не может преобразовать ввод тип MIME в PostScript, эта функция приводит к сбою и возвращает ошибку.

    Обсуждение

    Эта функция синхронна; преобразование входного файла к PostScript выполняется перед функциональными возвратами. Это может занять существенное количество времени для более длинных документов. Можно хотеть выполнить эту работу на потоке кроме потока главного приложения или разветвить отдельный процесс с этой целью.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMSessionPostScriptBegin PMSessionPostScriptBegin Доступный в OS X v10.0 через OS X v10.9

    Помещает текущий драйвер принтера в режим PostScript, готовый принять данные PostScript вместо данных QuickDraw.

    Оператор осуждения

    Использовать PMPrinterPrintWithFile, PMPrinterPrintWithProvider, или PMCGImageCreateWithEPSDataProvider вместо этого.

    Объявление

    Objective C

    OSStatus PMSessionPostScriptBegin ( PMPrintSession printSession );

    Параметры

    printSession

    Текущий сеанс печати.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать функцию PMSessionPostScriptBegin между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession. Необходимо также вызвать функцию в рамках функций PMSessionBeginPage и PMSessionEndPage.

    Чтобы гарантировать, что текущий драйвер принтера поддерживает данные PostScript, вызвать PMSessionGetDocumentFormatGeneration прежде чем Вы вызовете функцию PMSessionPostScriptBegin. Проверьте список поддерживаемых форматов буферного файла. Если PICT + PS является одним из них, выберите тот формат путем вызывания функции PMSessionSetDocumentFormatGeneration. Функция PMSessionSetDocumentFormatGeneration должен быть вызван перед вызовом PMSessionBeginDocument.

    Функция PMSessionPostScriptBegin не полезно, если текущий порт не является портом печати. Функциональные возвраты true если форматом документа не является PICT + PS.

    Специальные замечания

    PICT + формат буферного файла PS не доступен в основанных на Intel системах.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

  • PMSessionPostScriptData PMSessionPostScriptData Доступный в OS X v10.0 через OS X v10.9

    Данные PostScript передач, на которые ссылается указатель, к текущему драйверу принтера.

    Оператор осуждения

    Использовать PMPrinterPrintWithFile, PMPrinterPrintWithProvider, или PMCGImageCreateWithEPSDataProvider вместо этого.

    Объявление

    Objective C

    OSStatus PMSessionPostScriptData ( PMPrintSession printSession, Ptr psPtr, Size len );

    Параметры

    printSession

    Текущий сеанс печати.

    psPtr

    Указатель на данные PostScript Вы хотите передать текущему драйверу принтера.

    len

    Число байтов данных PostScript.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession. Обычно Вы вызываете эту функцию с объемом вызовов к функциям PMSessionPostScriptBegin и PMSessionPostScriptEnd.

    Функция PMSessionPostScriptData не полезно, если текущий порт не является портом печати, и форматом документа является PICT + PS.

    Специальные замечания

    PICT + формат буферного файла PS не доступен в основанных на Intel системах.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

  • PMSessionPostScriptEnd PMSessionPostScriptEnd Доступный в OS X v10.0 через OS X v10.9

    Восстанавливает формирователь тока к режиму QuickDraw, готовому принять данные QuickDraw вместо данных PostScript.

    Оператор осуждения

    Использовать PMPrinterPrintWithFile, PMPrinterPrintWithProvider, или PMCGImageCreateWithEPSDataProvider вместо этого.

    Объявление

    Objective C

    OSStatus PMSessionPostScriptEnd ( PMPrintSession printSession );

    Параметры

    printSession

    Текущий сеанс печати.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession. Необходимо также вызвать эту функцию с объемом вызовов к функциям PMSessionBeginPage и PMSessionEndPage.

    Вы вызываете функцию PMSessionPostScriptEnd завершать блок PostScript запустилось с PMSessionPostScriptBegin. Функция PMSessionPostScriptEnd не полезно, если текущий порт не является портом печати, и форматом документа является PICT + PS.

    Специальные замечания

    PICT + формат буферного файла PS не доступен в основанных на Intel системах.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

  • PMSessionPostScriptFile PMSessionPostScriptFile Доступный в OS X v10.0 через OS X v10.9

    Передает данные PostScript, содержавшиеся в файле, к текущему драйверу принтера.

    Оператор осуждения

    Использовать PMPrinterPrintWithFile, PMPrinterPrintWithProvider, или PMCGImageCreateWithEPSDataProvider вместо этого.

    Объявление

    Objective C

    OSStatus PMSessionPostScriptFile ( PMPrintSession printSession, FSSpec *psFile );

    Параметры

    printSession

    Текущий сеанс печати.

    psFile

    Указатель на переменную, указывающую расположение файла. Файл должен содержать данные PostScript, которые Вы хотите передать текущему драйверу принтера.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession. Вы обычно вызываете эту функцию в рамках вызовов к функции PMSessionPostScriptBegin и PMSessionPostScriptEnd.

    Функция PMSessionPostScriptFile не полезно, если текущий порт не является портом печати, и форматом документа является PICT + PS.

    Специальные замечания

    PICT + формат буферного файла PS не доступен в основанных на Intel системах.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

  • PMSessionPostScriptHandle PMSessionPostScriptHandle Доступный в OS X v10.0 через OS X v10.9

    Передает данные PostScript, на которые ссылается дескриптор Диспетчера памяти, к текущему драйверу принтера.

    Оператор осуждения

    Использовать PMPrinterPrintWithFile, PMPrinterPrintWithProvider, или PMCGImageCreateWithEPSDataProvider вместо этого.

    Объявление

    Objective C

    OSStatus PMSessionPostScriptHandle ( PMPrintSession printSession, Handle psHandle );

    Параметры

    printSession

    Текущий сеанс печати.

    psHandle

    Дескриптор к данным PostScript Вы хотите передать текущему драйверу принтера. Необходимо удостовериться, что дескриптор имеет надлежащий размер для данных, иначе Вы рискуете повреждать буферный файл.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession. Необходимо также вызвать эту функцию в рамках вызовов к функции PMSessionPostScriptBegin и PMSessionPostScriptEnd.

    Функция PMSessionPostScriptEnd не полезно, если текущий порт не является портом печати, и форматом документа является PICT + PS.

    Специальные замечания

    PICT + формат буферного файла PS не доступен в основанных на Intel системах.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

  • PMSessionSetPSInjectionData PMSessionSetPSInjectionData Доступный в OS X v10.0 через OS X v10.9

    Указывает, что ряд PostScript кодирует инжекционные точки и данные PostScript, которые будут введены.

    Оператор осуждения

    Использовать PMPrinterPrintWithFile или PMPrinterPrintWithProvider вместо этого.

    Объявление

    Objective C

    OSStatus PMSessionSetPSInjectionData ( PMPrintSession printSession, PMPrintSettings printSettings, CFArrayRef injectionDictArray );

    Параметры

    printSession

    Текущий сеанс печати.

    printSettings

    Настройки печати возражают, в который можно поместить указанные инжекционные точки.

    injectionDictArray

    Ссылка на Базовый массив Основы, содержащий один или несколько Базовых словарей Основы (CFDictionary) записи. Каждая словарная статья указывает данные инжекции PostScript, которые Вы хотите вставленный в отдельном моменте в потоке печати. Посмотрите Ключи Словаря Инжекции PostScript для описания констант, которые можно использовать в качестве ключей для этих словарных статей.

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

    Код результата. Посмотрите Базовые Коды Результата Печати. Код результата kPMInvalidParameter возвращается если injectionDictArray объект содержит любые недопустимые записи. Код результата kPMInvalidPrintSession если формат документа не был установлен в, возвращается kPMDocumentFormatPICTPS для указанного сеанса печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession. Перед вызовом PMSessionSetPSInjectionData, Ваше приложение должно установить формат документа сеанса печати к kPMDocumentFormatPICTPS использование функции PMSessionSetDocumentFormatGeneration.

    Для приложений, требующих обширного управления генерацией кода PostScript, функцией PMSessionSetPSInjectionData предоставляет возможность для введения кода PostScript в указанные места в потоке печати. Это предназначается для использования приложениями настольной издательской системы для который функции такой как PMSessionPostScriptData не обеспечивайте достаточное управление.

    Вы указываете инжекционные точки путем создания массива CFDictionary записи. Каждый словарь состоит из пар ключ/значение, в которых ключ указывает, где ввести PostScript, и значение указывает данные PostScript, которые Вы хотите ввести. Функция проверяет что injectionDictArray параметр должным образом формируется и возвращается kPMInvalidParameter закончитесь код, если массив не содержит действительные доступы.

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

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

Используя элементы потока операций PDF
  • PMWorkflowCopyItems (_:) PMWorkflowCopyItems

    Получает массив доступных элементов потока операций PDF.

    Объявление

    Swift

    func PMWorkflowCopyItems(_ workflowItems: UnsafeMutablePointer<Unmanaged<CFArray>?>) -> OSStatus

    Objective C

    OSStatus PMWorkflowCopyItems ( CFArrayRef *workflowItems );

    Параметры

    workflowItems

    Указатель на Ваш CFArrayRef переменная. По возврату переменная относится к Базовому массиву Основы. Каждый элемент в массиве является словарем, описывающим или элемент потока операций PDF или папку, содержащую ряд элементов потока операций PDF. Для списка возможных ключей посмотрите “PDF Workflow Dictionary Keys”. Вы ответственны за выпуск массива.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMWorkflowSubmitPDFWithOptions (_: _: _: _:) PMWorkflowSubmitPDFWithOptions

    Представляет файл PDF для обработки потока операций с помощью указанной строки опций CUPS.

    Объявление

    Swift

    func PMWorkflowSubmitPDFWithOptions(_ workflowItem: CFURL!, _ title: CFString!, _ options: UnsafePointer<Int8>, _ pdfFile: CFURL!) -> OSStatus

    Objective C

    OSStatus PMWorkflowSubmitPDFWithOptions ( CFURLRef workflowItem, CFStringRef title, const char *options, CFURLRef pdfFile );

    Параметры

    workflowItem

    URL файловой системы, указывающий на элемент потока операций, который обработает файл PDF. Посмотрите PMWorkflowCopyItems. Следующая таблица описывает различные типы элементов потока операций для этой функции.

    Элемент потока операций

    Описание

    Действие Automator

    Действие выполняется для файла PDF. Доступный в OS X v10.4 и позже.

    Псевдоним папки

    Файл PDF перемещен в разрешенную папку.

    Приложение или псевдоним приложения

    Заявление послано открытое событие вместе со ссылкой на файл PDF.

    Скомпилированный AppleScript

    Сценарий выполняется с открытым событием вместе со ссылкой на файл PDF.

    Исполнимый инструмент

    Инструмент выполняется со следующими параметрами: title, options, и pdfFile.

    title

    Визуализуемое пользователем имя документа в формате PDF.

    options

    Строка пар ключ/значение стиля CUPS, которые могут быть переданы элементу потока операций PDF. Этот параметр может быть NULL когда используется пустая строка опций.

    pdfFile

    Файловая система URL, указывающий на файл PDF, который будет обработан элементом потока операций.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Система печати использует эту функцию в сочетании с функцией PMWorkflowCopyItems реализовать кнопку потока операций PDF в диалоговом окне Печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMWorkflowSubmitPDFWithSettings (_: _: _:) PMWorkflowSubmitPDFWithSettings

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

    Объявление

    Swift

    func PMWorkflowSubmitPDFWithSettings(_ workflowItem: CFURL!, _ settings: PMPrintSettings, _ pdfFile: CFURL!) -> OSStatus

    Objective C

    OSStatus PMWorkflowSubmitPDFWithSettings ( CFURLRef workflowItem, PMPrintSettings settings, CFURLRef pdfFile );

    Параметры

    workflowItem

    URL файловой системы, указывающий на элемент потока операций, который обработает файл PDF. Посмотрите PMWorkflowCopyItems. Следующая таблица описывает различные типы элементов потока операций для этой функции.

    Элемент потока операций

    Описание

    Действие Automator

    Действие выполняется для файла PDF. Доступный в OS X v10.4 и позже.

    Псевдоним папки

    Файл PDF перемещен в разрешенную папку.

    Приложение или псевдоним приложения

    Заявление послано открытое событие вместе со ссылкой на файл PDF.

    Скомпилированный AppleScript

    Сценарий выполняется с открытым событием вместе со ссылкой на файл PDF.

    Исполнимый инструмент

    Инструмент выполняется с указанными настройками и файлом PDF. Эта функция преобразовывает эти параметры в строку опций CUPS и передает строку опций инструменту.

    settings

    Настройки печати для применения к документу в формате PDF. Эти настройки передаются элементу потока операций как строка опций CUPS.

    pdfFile

    Файловая система URL, указывающий на файл PDF, который будет обработан элементом потока операций.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Система печати использует эту функцию в сочетании с функцией PMWorkflowCopyItems реализовать кнопку потока операций PDF в диалоговом окне Печати.

    Специальные замечания

    В OS X v10.4 и ранее, эта функция не реализована и возвращает ошибку. Можно использовать функцию PMWorkflowSubmitPDFWithOptions вместе с функцией PMPrintSettingsToOptions вместо этого.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

Соответствие цвета с ColorSync
  • PMSetProfile PMSetProfile Доступный в OS X v10.0 через OS X v10.9

    Встраивает цветовой профиль во время печати.

    Оператор осуждения

    Нет никакой замены; нарисуйте Кварц использования, 2D вместо этого.

    Объявление

    Objective C

    OSStatus PMSetProfile ( PMPrintSettings printSettings, PMTag tag, const CMProfileLocation *profile );

    Параметры

    printSettings

    Настройки печати возражают, в который можно встроить цветовой профиль.

    tag

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

    profile

    Указатель на структуру типа CMProfileLocation это указывает расположение профиля ColorSync. Профиль должен быть версией 2 или позже. Если Вы передаете профиль, который является более ранней версией, функция возвращает код результата kPMNotImplemented.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Можно использовать функцию PMSetProfile тегировать получение QuickDraw с пользовательским профилем ColorSync. Функция PMSetProfile полезно, только если графическим контекстом является QuickDraw, и текущий порт является портом печати.

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

    Специальные замечания

    Эта функция осуждается, потому что осуждается QuickDraw. При рисовании с Кварцем текущее пространство цвета обводки и цвета заливки и цветовое пространство, связанное с изображением, используются для охарактеризования цвета. Кварц обеспечивает способы использовать профили ColorSync для создавания цветовых пространств, таким образом, можно охарактеризовать использование цвета ColorSync просто путем рисования с Кварцем.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    Не доступный 64-разрядным приложениям.

  • PMSessionEnableColorSync PMSessionEnableColorSync Доступный в OS X v10.0 через OS X v10.9

    Включает использование пользовательского профиля ColorSync, ранее установленного функцией PMSetProfile.

    Оператор осуждения

    Нет никакой замены; нарисуйте Кварц использования, 2D вместо этого.

    Объявление

    Objective C

    OSStatus PMSessionEnableColorSync ( PMPrintSession printSession );

    Параметры

    printSession

    Сеанс печати, специфичный для страницы профиль ColorSync которого Вы хотите включить.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession. Необходимо вызвать эту функцию в рамках вызовов к функциям PMSessionBeginPage и PMSessionEndPage.

    Функция PMSessionEnableColorSync применяется только к текущей странице. Функция полезна, только если графическим контекстом является QuickDraw, и текущий порт является портом печати.

    Специальные замечания

    Эта функция осуждается, потому что осуждается QuickDraw. При рисовании с Кварцем текущее пространство цвета обводки и цвета заливки и цветовое пространство, связанное с изображением, используются для охарактеризования цвета. Кварц обеспечивает способы использовать профили ColorSync для создавания цветовых пространств, таким образом, можно охарактеризовать использование цвета ColorSync просто путем рисования с Кварцем.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    Не доступный 64-разрядным приложениям.

  • PMSessionDisableColorSync PMSessionDisableColorSync Доступный в OS X v10.0 через OS X v10.9

    Отключает использование пользовательского профиля ColorSync, ранее включенного функцией PMSessionEnableColorSync.

    Оператор осуждения

    Нет никакой замены; нарисуйте Кварц использования, 2D вместо этого.

    Объявление

    Objective C

    OSStatus PMSessionDisableColorSync ( PMPrintSession printSession );

    Параметры

    printSession

    Сеанс печати, специфичный для страницы профиль ColorSync которого Вы хотите отключить.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать PMSessionDisableColorSync функция между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession. Необходимо вызвать эту функцию в рамках вызовов к функциям PMSessionBeginPage и PMSessionEndPage.

    Функция PMSessionDisableColorSync применяется только к текущей странице. Функция полезна, только если графическим контекстом является QuickDraw, и текущий порт является портом печати.

    Специальные замечания

    Эта функция осуждается, потому что осуждается QuickDraw. При рисовании с Кварцем текущее пространство цвета обводки и цвета заливки и цветовое пространство, связанное с изображением, используются для охарактеризования цвета. Кварц обеспечивает способы использовать профили ColorSync для создавания цветовых пространств, таким образом, можно охарактеризовать использование цвета ColorSync просто путем рисования с Кварцем.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    Не доступный 64-разрядным приложениям.

Преобразование и сохранение старых записей печати
  • PMSessionConvertOldPrintRecord PMSessionConvertOldPrintRecord Доступный в OS X v10.0 через OS X v10.9

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

    Оператор осуждения

    Нет никакой замены; во время перехода от Mac OS 9 к OS X, эта функция упростила миграцию записей печати, сохраненных в документах, создаваемых в Mac OS 9, но функция больше не служит никакой полезной цели в OS X.

    Объявление

    Objective C

    OSStatus PMSessionConvertOldPrintRecord ( PMPrintSession printSession, Handle printRecordHandle, PMPrintSettings *printSettings, PMPageFormat *pageFormat );

    Параметры

    printSession

    Текущий сеанс печати.

    printRecordHandle

    Дескриптор к записи печати старого стиля создается классическим Диспетчером печати. Вы ответственны за избавление от дескриптора.

    printSettings

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

    pageFormat

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

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession.

    Можно использовать PMSessionConvertOldPrintRecord создать формат страниц и настройки печати возражает от записей печати старого стиля, сохраненных в документах, создаваемых версиями перед углеродом Вашего приложения. Необходимо проверить формат страниц, и объекты настроек печати возвратились к Вам путем вызывания функций PMSessionValidatePageFormat и PMSessionValidatePrintSettings. Обратите внимание на то, что совершенный перевод между объектами старого и нового стиля не достижим.

    В OS X функция предполагает, что запись печати, которая будет преобразована, является записью печати LaserWriter 8.

    Специальные замечания

    Если необходимо преобразовать Mac OS 9 записей печати в данные, можно использовать в OS X, необходимо извлечь данные размера страницы из печати, записывают и используют функцию PMCreatePageFormatWithPMPaper создать a PMPageFormat объект, соответствующий тем данным.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

  • PMSessionMakeOldPrintRecord PMSessionMakeOldPrintRecord Доступный в OS X v10.0 через OS X v10.9

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

    Оператор осуждения

    Нет никакой замены; записи печати старого стиля являются устаревшими и не служат никакой полезной цели в OS X.

    Объявление

    Objective C

    OSStatus PMSessionMakeOldPrintRecord ( PMPrintSession printSession, PMPrintSettings printSettings, PMPageFormat pageFormat, Handle *printRecordHandle );

    Параметры

    printSession

    Текущий сеанс печати.

    printSettings

    Объект настроек печати. Для создания печати, настройки возражают, что можно вызвать функцию PMCreatePrintSettings и затем вызовите функцию PMSessionDefaultPrintSettings для инициализации настроек печати возражают против значений по умолчанию.

    pageFormat

    Объект формата страниц. Для создания формата страниц возражают, что можно вызвать функцию PMCreatePageFormat и затем вызовите функцию PMSessionDefaultPageFormat для инициализации формата страниц возражают против значений по умолчанию.

    printRecordHandle

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

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Необходимо вызвать эту функцию между созданием и выпуском сеанса печати. Посмотрите функцию PMCreateSession.

    Можно использовать PMSessionMakeOldPrintRecord для создания печати старого стиля записывают для хранения документами для совместимости с версиями перед углеродом приложения. Обратите внимание на то, что, потому что формат страниц и объекты настроек печати содержат больше информации, чем старая запись печати, некоторые настройки могут быть потеряны в преобразовании. Т.е. совершенный перевод между объектами старого и нового стиля не достижим.

    В OS X функция всегда создает LaserWriter 8 совместимая запись печати.

    Специальные замечания

    Надлежащий способ хранить информацию формата страниц для использования в OS X со сглаженным PMPageFormat объект. Обычно приложения не сохраняют настройки печати с документом, но если это подходяще для данного приложения, надлежащий способ сделать так состоит в том, чтобы использовать сглаженный PMPrintSettings объект.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

Создание, вызывая и удаляя Универсальные указатели процедуры
  • NewPMIdleUPP NewPMIdleUPP Доступный в OS X v10.0 через OS X v10.4

    Создает новый универсальный указатель процедуры (UPP) к неактивному обратному вызову.

    Оператор осуждения

    Нет никакой замены; эта функция была включена для упрощения унаследованных приложений портирования к OS X, но это не служит никакой полезной цели.

    Объявление

    Objective C

    PMIdleUPP NewPMIdleUPP ( PMIdleProcPtr userRoutine );

    Обсуждение

    Вам не нужна эта функция в OS X. Вместо этого используйте стандарт, неактивный proc. Посмотрите PMIdleProcPtr функция обратного вызова.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.4.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

  • InvokePMIdleUPP InvokePMIdleUPP Доступный в OS X v10.0 через OS X v10.4

    Вызывает неактивный обратный вызов.

    Оператор осуждения

    Нет никакой замены; эта функция была включена для упрощения унаследованных приложений портирования к OS X, но это не служит никакой полезной цели.

    Объявление

    Objective C

    void InvokePMIdleUPP ( PMIdleUPP userUPP );

    Обсуждение

    Вам не нужна эта функция в OS X. Вместо этого используйте стандарт, неактивный proc. Посмотрите PMIdleProcPtr функция обратного вызова.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.4.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

  • DisposePMIdleUPP DisposePMIdleUPP Доступный в OS X v10.0 через OS X v10.4

    Избавляется от универсального указателя процедуры (UPP) к неактивному обратному вызову.

    Оператор осуждения

    Нет никакой замены; эта функция была включена для упрощения унаследованных приложений портирования к OS X, но это не служит никакой полезной цели.

    Объявление

    Objective C

    void DisposePMIdleUPP ( PMIdleUPP userUPP );

    Обсуждение

    Вам не нужна эта функция в OS X. Вместо этого используйте стандарт, неактивный proc. Посмотрите PMIdleProcPtr функция обратного вызова.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.4.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

Устаревшие базовые функции печати
  • PMBegin PMBegin

    Подготавливает Базовую Печать к использованию.

    Использовать PMCreateSession вместо этого.

    Объявление

    Objective C

    OSStatus PMBegin ();

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Не вкладывайте вызовы к PMBegin.

  • PMConvertOldPrintRecord PMConvertOldPrintRecord

    Создает новое PMPageFormat возразите и новое PMPrintSettings объект от записи печати создается классическим Диспетчером печати.

    Нет никакой замены; во время перехода от Mac OS 9 к OS X, эта функция упростила миграцию записей печати, сохраненных в документах, создаваемых в Mac OS 9, но функция больше не служит никакой полезной цели в OS X.

    Объявление

    Objective C

    OSStatus PMConvertOldPrintRecord ( Handle printRecordHandle, PMPrintSettings *printSettings, PMPageFormat *pageFormat );

    Параметры

    printRecordHandle

    Дескриптор к записи печати создается классическим Диспетчером печати.

    printSettings

    По возврату, проверенному PMPrintSettings объект.

    pageFormat

    По возврату, проверенному PMPageFormat объект.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Допустимый после вызова PMBegin.

  • PMDefaultPageFormat PMDefaultPageFormat

    Присваивает значения параметров по умолчанию существующему PMPageFormat объект, для текущего принтера.

    Использовать PMSessionDefaultPageFormat вместо этого.

    Объявление

    Objective C

    OSStatus PMDefaultPageFormat ( PMPageFormat pageFormat );

    Параметры

    pageFormat

    По возврату, a PMPageFormat объект, содержащий значения параметров по умолчанию.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

  • PMDefaultPrintSettings PMDefaultPrintSettings

    Присваивает значения параметров по умолчанию a PMPrintSettings объект.

    Использовать PMSessionDefaultPrintSettings вместо этого.

    Объявление

    Objective C

    OSStatus PMDefaultPrintSettings ( PMPrintSettings printSettings );

    Параметры

    printSettings

    A PMPrintSettings объект. По возврату объект содержит значения параметров по умолчанию.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

  • PMDisableColorSync PMDisableColorSync

    Отключает согласование цветов ColorSync для текущей страницы.

    Нет никакой замены; нарисуйте Кварц использования, 2D вместо этого.

    Объявление

    Objective C

    OSStatus PMDisableColorSync ();

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Допустимый между вызовами к PMBeginPage и PMEndPage.

  • PMDisposePageFormat PMDisposePageFormat

    Память выпусков ранее выделяется для a PMPageFormat объект.

    Использовать PMRelease вместо этого.

    Объявление

    Objective C

    OSStatus PMDisposePageFormat ( PMPageFormat pageFormat );

    Параметры

    pageFormat

    По возврату, лишенному законной силы PMPageFormat объект.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

  • PMDisposePrintSettings PMDisposePrintSettings

    Память выпусков ранее выделяется для a PMPrintSettings объект.

    Использовать PMRelease вместо этого.

    Объявление

    Objective C

    OSStatus PMDisposePrintSettings ( PMPrintSettings printSettings );

    Параметры

    printSettings

    По возврату, лишенному законной силы PMPrintSettings ссылка.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

  • PMEnableColorSync PMEnableColorSync

    Включает согласование цветов ColorSync для текущей страницы.

    Нет никакой замены; нарисуйте Кварц использования, 2D вместо этого.

    Объявление

    Objective C

    OSStatus PMEnableColorSync ();

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Допустимый между вызовами к PMBeginPage и PMEndPage.

  • PMEnd PMEnd

    Печать Ядра завершений и выпуски ее выделенная память.

    Использовать PMRelease к выпуску a PMPrintSession объект вместо этого.

    Объявление

    Objective C

    OSStatus PMEnd (void);

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

  • PMError PMError

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

    Использовать PMSessionError вместо этого.

    Объявление

    Objective C

    OSStatus PMError ();

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

    Код результата. Код результата kPMCancel указывает, что пользователь отменил текущее задание печати.

    Обсуждение

    Допустимый после вызова PMBegin.

  • PMGeneral PMGeneral

    Поддерживает совместимость с PrGeneral функция в классическом Диспетчере печати.

    Использовать PMPrinterGetCommInfo вместо этого.

    Объявление

    Objective C

    OSStatus PMGeneral ( Ptr pData );

    Параметры

    pData

    Указатель на a PrGeneral структура данных.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Допустимый после вызова PMBegin.

  • PMGetDestination PMGetDestination Доступный в OS X v10.0 через OS X v10.9

    Получает выходное место назначения задания печати.

    Оператор осуждения

    Использовать PMSessionGetDestinationType, PMSessionCopyDestinationFormat, или PMSessionCopyDestinationLocation вместо этого.

    Объявление

    Objective C

    OSStatus PMGetDestination ( PMPrintSettings printSettings, PMDestinationType *destType, CFURLRef *fileURL );

    Параметры

    printSettings

    Настройки печати возражают, чье место назначения Вы хотите получить.

    destType

    Указатель на Ваш PMDestinationType переменная. По возврату переменная указывает место назначения для задания печати. Посмотрите Целевые Типы.

    fileURL

    Указатель на Ваш CFURLRef переменная. По возврату переменная отсылает к Базовой Основе URL, содержащий расположение места назначения задания печати.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

    Перед использованием этой функции необходимо вызвать PMSessionValidatePrintSettings или PMValidatePrintSettings гарантировать, что объект настроек печати допустим.

    Специальные замечания

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

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.5.

    Не доступный 64-разрядным приложениям.

  • PMGetDriverCreator PMGetDriverCreator

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

    Использовать PMPrinterGetDriverCreator вместо этого.

    Объявление

    Objective C

    OSStatus PMGetDriverCreator ( OSType *creator );

    Параметры

    creator

    По возврату, 4-байтовому типу создателя драйвера (например, 'APPL' для драйвера принтера Apple).

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Допустимый после вызова PMBegin.

  • PMGetDriverReleaseInfo PMGetDriverReleaseInfo

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

    Использовать PMPrinterGetDriverReleaseInfo вместо этого.

    Объявление

    Objective C

    OSStatus PMGetDriverReleaseInfo ( VersRec *release );

    Параметры

    release

    По возврату, указателю на a VersRec структура данных, содержащая водительские короткие и долгие строки версии и код страны.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Допустимый после вызова PMBegin.

  • PMGetGrafPtr PMGetGrafPtr

    Получает порт печати из непрозрачного контекста печати.

    Использовать PMSessionGetCGGraphicsContext вместо этого.

    Объявление

    Objective C

    OSStatus PMGetGrafPtr ( PMPrintContext printContext, GrafPtr *grafPort );

    Параметры

    printContext

    A PMPrintContext объект.

    grafPort

    По возврату, указателю на a grafPort определение текущего порта печати.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Допустимый после вызова PMBegin и создание контекста печати.

  • PMGetIndexedPrinterResolution PMGetIndexedPrinterResolution

    Получает настройку разрешения на основе индекса в диапазон настроек, поддерживаемых текущим принтером.

    Использовать PMPrinterGetIndexedPrinterResolution вместо этого.

    Объявление

    Objective C

    OSStatus PMGetIndexedPrinterResolution ( UInt32 index, PMResolution *res );

    Параметры

    index

    Индекс в диапазон настроек разрешения поддерживается указанным принтером. Индексные значения начинаются в 1.

    res

    По возврату, установке разрешения принтера.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Допустимый после вызова PMBegin. Необходимо сначала использовать PMGetPrinterResolutionCount функция для получения числа настроек разрешения, поддерживаемых текущим принтером.

  • PMGetJobName PMGetJobName Доступный в OS X v10.0 через OS X v10.9

    Получает имя задания печати.

    Оператор осуждения

    Использовать PMPrintSettingsGetJobName вместо этого.

    Объявление

    Objective C

    OSStatus PMGetJobName ( PMPrintSettings printSettings, StringPtr name );

    Параметры

    printSettings

    A PMPrintSettings объект.

    name

    По возврату, имени задания печати.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Допустимый после вызова PMBegin и создание объекта настроек печати. Перед использованием этой функции необходимо вызвать PMValidatePrintSettings гарантировать, что объект настроек печати допустим.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

  • PMGetLanguageInfo PMGetLanguageInfo

    Получает информацию о языке текущего принтера обработки изображений.

    Использовать PMPrinterGetLanguageInfo вместо этого.

    Объявление

    Objective C

    OSStatus PMGetLanguageInfo ( PMLanguageInfo *info );

    Параметры

    info

    По возврату, указателю на структуру данных, содержащую уровень языка принтера, версию и выпуск. Формат возвращенных данных основывается на языке PostScript.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Допустимый после вызова PMBegin. PMGetLanguageInfo полезно для принтеров PostScript, но может быть не важным для других типов принтеров.

  • PMGetPhysicalPageSize PMGetPhysicalPageSize Доступный в OS X v10.0 через OS X v10.9

    Получает размер области изображения в точках, незатронутых попеременно, разрешение или масштабирование.

    Оператор осуждения

    Использовать PMGetUnadjustedPageRect или исследуйте бумагу, возвращенную PMGetPageFormatPaper.

    Объявление

    Objective C

    OSStatus PMGetPhysicalPageSize ( PMPageFormat pageFormat, PMRect *pageSize );

    Параметры

    pageFormat

    A PMPageFormat возразите ранее создаваемый Вашим приложением.

    pageSize

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

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

  • PMGetPhysicalPaperSize PMGetPhysicalPaperSize Доступный в OS X v10.0 через OS X v10.9

    Получает размер бумаги в точках, незатронутых попеременно, разрешение или масштабирование.

    Оператор осуждения

    Использовать PMGetUnadjustedPaperRect или исследуйте бумагу, возвращенную PMGetPageFormatPaper.

    Объявление

    Objective C

    OSStatus PMGetPhysicalPaperSize ( PMPageFormat pageFormat, PMRect *paperSize );

    Параметры

    pageFormat

    A PMPageFormat возразите ранее создаваемый Вашим приложением.

    paperSize

    По возврату, прямоугольник, описывающий физический размер бумаги. Модули находятся в 1/72 дюйма. Таким образом 8.5 x 11 возвратов листка бумаги для его отдельных компонентов:

    вершина - 0.0

    оставленный - 0.0

    нижняя часть - 792.0

    право - 612.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

  • PMGetPrinterResolution PMGetPrinterResolution

    Получает настройку разрешения для текущего принтера согласно параметру тегов.

    Использовать PMPrinterGetPrinterResolutionCount и PMPrinterGetIndexedPrinterResolution исследовать доступные разрешения принтера.

    Объявление

    Objective C

    OSStatus PMGetPrinterResolution ( PMTag tag, PMResolution *res );

    Параметры

    tag

    Указывает вид требуемой информации разрешения.

    res

    Установка разрешения принтера.

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

    Код результата.. Код результата kPMNotImplemented указывает, что драйвер принтера не поддерживает многократные настройки разрешения.

    Обсуждение

    Допустимый после вызова PMBegin.

    Следующие константы тега разрешения распознаны:

    kPMMinRange

    Минимальное разрешение поддерживается принтером.

    kPMMaxRange

    Максимальное разрешение поддерживается принтером.

    kPMMinSquareResolution

    Установка минимального разрешения, для которой горизонтальные и вертикальные разрешения равны.

    kPMMaxSquareResolution

    Установка максимального разрешения, для которой горизонтальные и вертикальные разрешения равны.

    kPMDefaultResolution

    Настройка разрешения по умолчанию для принтера (обычно 72 точки на дюйм).

  • PMGetPrinterResolutionCount PMGetPrinterResolutionCount

    Получает число настроек разрешения, поддерживаемых текущим принтером.

    Использовать PMPrinterGetPrinterResolutionCount вместо этого.

    Объявление

    Objective C

    OSStatus PMGetPrinterResolutionCount ( UInt32 *count );

    Параметры

    count

    По возврату, числу поддерживаемых разрешений печати.

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

    Код результата. Код результата kPMNotImplemented указывает, что драйвер принтера не поддерживает многократные настройки разрешения.

    Обсуждение

    Допустимый после вызова PMBegin.

  • PMIsPostScriptDriver PMIsPostScriptDriver

    Отчеты, поддерживает ли текущий драйвер принтера язык PostScript.

    Использовать PMPrinterIsPostScriptCapable или PMPrinterIsPostScriptPrinter вместо этого.

    Объявление

    Objective C

    OSStatus PMIsPostScriptDriver ( Boolean *isPostScript );

    Параметры

    isPostScript

    Возвраты true если текущий драйвер принтера поддерживает PostScript.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Допустимый после вызова PMBegin. В OS X, PMIsPostScriptDriver всегда возвраты false.

  • PMNewPageFormat PMNewPageFormat

    Создает новое PMPageFormat объект.

    Использовать PMCreatePageFormat вместо этого.

    Объявление

    Objective C

    OSStatus PMNewPageFormat ( PMPageFormat *pageFormat );

    Параметры

    pageFormat

    По возврату, инициализированному PMPageFormat объект.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Допустимый после вызова PMBegin. Функция PMNewPageFormat выделяет память для нового PMPageFormat возразите в пространстве памяти своего приложения. Новый объект формата страниц пуст, пока Вы не устанавливаете его значения, или пока Вы не вызываете PMDefaultPageFormat или PMValidatePageFormat.

  • PMNewPrintSettings PMNewPrintSettings

    Создает новое PMPrintSettings объект.

    Использовать PMCreatePrintSettings вместо этого.

    Объявление

    Objective C

    OSStatus PMNewPrintSettings ( PMPrintSettings *printSettings );

    Параметры

    printSettings

    По возврату, инициализированному PMPrintSettings объект.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Допустимый после вызова PMBegin. Функция PMNewPrintSettings выделяет память для нового PMPrintSettings возразите в пространстве памяти своего приложения. Новый объект настроек печати пуст, пока Вы не устанавливаете его значения, или пока Вы не вызываете PMDefaultPrintSettings или PMValidatePrintSettings.

  • PMMakeOldPrintRecord PMMakeOldPrintRecord

    Создает запись печати старого стиля из a PMPageFormat и a PMPrintSettings объект.

    Нет никакой замены; записи печати старого стиля являются устаревшими и не служат никакой полезной цели в OS X.

    Объявление

    Objective C

    OSStatus PMMakeOldPrintRecord ( PMPrintSettings printSettings, PMPageFormat pageFormat, Handle *printRecordHandle );

    Параметры

    printSettings

    A PMPrintSettings объект.

    pageFormat

    A PMPageFormat объект.

    printRecordHandle

    По возврату, дескриптору к запись печати старого стиля. Ваше приложение должно избавиться от этого дескриптора.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Допустимый после вызова PMBegin и создание формата страниц и объекта настроек печати. Использовать PMMakeOldPrintRecord для создания печати записывают для хранения документами для совместимости с версиями перед углеродом приложения. Обратите внимание на то, что, потому что формат страниц и объекты настроек печати содержат больше информации, чем запись печати старого стиля, некоторые настройки могут быть потеряны в преобразовании.

  • PMPostScriptBegin PMPostScriptBegin

    Помещает формирователь тока в режим PostScript, готовый принять данные PostScript вместо данных QuickDraw.

    Использовать PMPrinterPrintWithFile, PMPrinterPrintWithProvider, или PMCGImageCreateWithEPSDataProvider вместо этого.

    Объявление

    Objective C

    OSStatus PMPostScriptBegin ();

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Допустимый между вызовами к PMBeginPage и PMEndPage. Вызвать PMIsPostScriptDriver перед вызовом PMPostScriptBegin гарантировать, что формирователь тока поддерживает данные PostScript.

  • PMPostScriptData PMPostScriptData

    Данные PostScript передач, на которые ссылается указатель, к текущему драйверу принтера.

    Использовать PMPrinterPrintWithFile, PMPrinterPrintWithProvider, или PMCGImageCreateWithEPSDataProvider вместо этого.

    Объявление

    Objective C

    OSStatus PMPostScriptData ( Ptr psPtr, Size len );

    Параметры

    psPtr

    Указатель на данные PostScript.

    len

    Число байтов данных PostScript для передачи формирователю тока.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Допустимый между вызовами к PMPostScriptBegin и PMPostScriptEnd.

  • PMPostScriptEnd PMPostScriptEnd

    Восстанавливает формирователь тока к режиму QuickDraw, готовому принять данные QuickDraw вместо данных PostScript.

    Использовать PMPrinterPrintWithFile, PMPrinterPrintWithProvider, или PMCGImageCreateWithEPSDataProvider вместо этого.

    Объявление

    Objective C

    OSStatus PMPostScriptEnd ();

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Допустимый между вызовами к PMBeginPage и PMEndPage. Вызвать PMPostScriptEnd завершать сеанс PostScript запустилось с PMPostScriptBegin.

  • PMPostScriptFile PMPostScriptFile

    Данные PostScript передач, содержавшиеся в файле, к текущему драйверу принтера.

    Использовать PMPrinterPrintWithFile, PMPrinterPrintWithProvider, или PMCGImageCreateWithEPSDataProvider вместо этого.

    Объявление

    Objective C

    OSStatus PMPostScriptFile ( FSSpec *psFile );

    Параметры

    psFile

    Спецификация файла.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Допустимый между вызовами к PMPostScriptBegin и PMPostScriptEnd.

  • PMPostScriptHandle PMPostScriptHandle

    Данные PostScript передач, на которые ссылается дескриптор, к текущему драйверу принтера.

    Использовать PMPrinterPrintWithFile, PMPrinterPrintWithProvider, или PMCGImageCreateWithEPSDataProvider вместо этого.

    Объявление

    Objective C

    OSStatus PMPostScriptHandle ( Handle psHandle );

    Параметры

    psHandle

    Ссылка на данные PostScript.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Допустимый между вызовами к PMPostScriptBegin и PMPostScriptEnd.

  • PMSessionGetDocumentFormatSupported PMSessionGetDocumentFormatSupported Доступный в OS X v10.0 через OS X v10.9

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

    Оператор осуждения

    Использовать PMPrinterPrintWithFile, PMPrinterPrintWithProvider, или PMCGImageCreateWithEPSDataProvider вместо этого.

    Объявление

    Objective C

    OSStatus PMSessionGetDocumentFormatSupported ( PMPrintSession printSession, CFArrayRef *docFormats, UInt32 limit );

    Параметры

    printSession

    Текущий сеанс печати.

    docFormats

    По возврату, массиву CFString значения, содержащие MIME, вводят указание форматов буферного файла, поддерживаемых текущим драйвером принтера. См. “Строки Формата документа” для описания возможных возвращаемых значений.

    limit

    Максимальное количество поддерживаемых форматов документов, которые будут возвращены.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Допустимый в контексте сеанса печати.

    Форматы буферного файла представлены типами MIME. В OS X модули принтера могут поддерживать широкий диапазон форматов буферного файла. Первый элемент в списке поддерживаемых форматов буферного файла является значением по умолчанию для текущего драйвера принтера.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

  • PMSessionIsDocumentFormatSupported PMSessionIsDocumentFormatSupported Доступный в OS X v10.0 через OS X v10.9

    Отчеты, поддерживает ли текущий драйвер принтера указанный формат буферного файла.

    Оператор осуждения

    Использовать PMPrinterPrintWithFile, PMPrinterPrintWithProvider, или PMCGImageCreateWithEPSDataProvider вместо этого.

    Объявление

    Objective C

    OSStatus PMSessionIsDocumentFormatSupported ( PMPrintSession printSession, CFStringRef docFormat, Boolean *supported );

    Параметры

    printSession

    Текущий сеанс печати.

    docFormat

    Формат буферного файла представлен типом MIME.

    supported

    Возвраты true если формат буферного файла поддерживается текущим драйвером принтера.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Допустимый в контексте сеанса печати.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

  • PMGetColorMode PMGetColorMode Доступный в OS X v10.0 через OS X v10.9

    Получает цветовой режим для задания печати.

    Оператор осуждения

    Нет никакой замены; эта функция была включена для упрощения унаследованных приложений портирования к OS X, но это не служит никакой полезной цели.

    Объявление

    Objective C

    OSStatus PMGetColorMode ( PMPrintSettings printSettings, PMColorMode *colorMode );

    Параметры

    printSettings

    Настройки печати возражают, чей цветовой режим Вы хотите получить.

    colorMode

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

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Эта функция не рекомендуется. Это ничего не делает в OS X и в целом больше не подходяще для приложений вызвать.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

  • PMSetColorMode PMSetColorMode Доступный в OS X v10.0 через OS X v10.9

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

    Оператор осуждения

    Нет никакой замены; эта функция была включена для упрощения унаследованных приложений портирования к OS X, но это не служит никакой полезной цели.

    Объявление

    Objective C

    OSStatus PMSetColorMode ( PMPrintSettings printSettings, PMColorMode colorMode );

    Параметры

    printSettings

    Настройки печати возражают, чей цветовой режим Вы хотите установить.

    colorMode

    Режим требуемого цвета. Посмотрите Цветовые режимы для списка возможных значений.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Специальные замечания

    Эта функция ничего не делает в OS X.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

  • PMSetError PMSetError

    Устанавливает значение текущего кода результата.

    Использовать PMSessionSetError вместо этого.

    Объявление

    Objective C

    OSStatus PMSetError ( OSStatus printError );

    Параметры

    printError

    Код результата Вы хотите установить. Этот код результата будет возвращен PMError функция.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Допустимый после вызова PMBegin.

  • PMSetIdleProc PMSetIdleProc

    Устанавливает неактивную функцию обратного вызова в Вашем цикле печати.

    Нет никакой замены; эта функция была включена для упрощения унаследованных приложений портирования к OS X, но это не служит никакой полезной цели.

    Объявление

    Objective C

    OSStatus PMSetIdleProc ( PMIdleUPP idleProc );

    Параметры

    idleProc

    Универсальный указатель процедуры на Вашу неактивную функцию. Ваша неактивная функция определяется обратным вызовом PMIdleProcPtr.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

    Допустимый после вызова PMBegin. Системные вызовы печати Ваша неактивная функция периодически во время Вашего цикла печати.

    Специальные замечания

    Ваша неактивная функция не вызвана в OS X. Это только вызывают в Mac OS 8 и 9.

  • PMSetJobName PMSetJobName Доступный в OS X v10.0 через OS X v10.9

    Указывает имя задания печати.

    Оператор осуждения

    Использовать PMPrintSettingsSetJobName вместо этого.

    Объявление

    Objective C

    OSStatus PMSetJobName ( PMPrintSettings printSettings, StringPtr name );

    Параметры

    printSettings

    A PMPrintSettings объект.

    name

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

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

    Код результата. Код результата kPMInvalidParameter при попытке определить имя задания к недопустимому имени файла или пустой строке, возвращается.

    Обсуждение

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

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

  • PMSetPhysicalPaperSize PMSetPhysicalPaperSize Доступный в OS X v10.0 через OS X v10.9

    Запрашивает определенный формат бумаги, незатронутый попеременно, разрешение или масштабирование.

    Оператор осуждения

    Использовать PMCreatePageFormatWithPMPaper вместо этого.

    Объявление

    Objective C

    OSStatus PMSetPhysicalPaperSize ( PMPageFormat pageFormat, const PMRect *paperSize );

    Параметры

    pageFormat

    PMPageFormat который будет содержать новый физический формат бумаги.

    paperSize

    Желаемый формат бумаги, выраженный как a PMRect. Модули составляют 1/72 дюйма. A PMRect прямоугольник, отдельные компоненты которого, удваивается.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Осуждаемый в OS X v10.4.

    Не доступный 64-разрядным приложениям.

  • PMValidatePageFormat PMValidatePageFormat

    Получает допустимое PMPageFormat объект.

    Использовать PMSessionValidatePageFormat вместо этого.

    Объявление

    Objective C

    OSStatus PMValidatePageFormat ( PMPageFormat pageFormat, Boolean *result );

    Параметры

    pageFormat

    A PMPageFormat объект, который будет проверен.

    result

    Возвраты true если какие-либо параметры были изменены, false если не требовались никакие изменения.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

  • PMValidatePrintSettings PMValidatePrintSettings

    Получает допустимое PMPrintSettings объект.

    Использовать PMSessionValidatePrintSettings вместо этого.

    Объявление

    Objective C

    OSStatus PMValidatePrintSettings ( PMPrintSettings printSettings, Boolean *result );

    Параметры

    printSettings

    PMPrintSettings объект, который будет проверен.

    result

    По возврату, значению true если какие-либо параметры были изменены, или false если не требовались никакие изменения.

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

    Код результата. Посмотрите Базовые Коды Результата Печати.

    Обсуждение

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

Обратные вызовы

Устаревшие обратные вызовы
  • PMIdleProcPtr PMIdleProcPtr

    Определяет указатель на неактивную функцию.

    Нет никакой замены; эта функция обратного вызова была включена для упрощения унаследованных приложений портирования к OS X, но это не служит никакой полезной цели.

    Объявление

    Objective C

    typedef void (* PMIdleProcPtr ) (void);

    Обсуждение

    Если Вы устанавливаете неактивную функцию с помощью функции PMSessionSetIdleProc, системные вызовы печати Ваша неактивная функция периодически во время Вашего цикла печати. Ваша неактивная функция может вывести на экран состояние приложения при печати, но это не должно копировать информацию, выведенную на экран системой печати или драйвером принтера. Если Вы не устанавливаете неактивную функцию, Вы получаете стандартное диалоговое окно для формирователя тока в Mac OS 8 и 9.

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

    Для обеспечения указателя на неактивную функцию Вы создаете универсальный указатель процедуры (UPP) типа PMIdleUPP, использование функции NewPMIdleUPP. Можно сделать так с кодом, подобным следующему:

    • PMIdleUPP MyPrintIdleUPP;
    • MyPrintIdleUPP = NewPMIdleUPP (&MyPrintIdleCallback);

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

    Специальные замечания

    Ваша неактивная функция не вызвана в OS X. Это только вызывают в Mac OS 8 и 9.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.7.

    Не доступный 64-разрядным приложениям.

Типы данных

  • PMDialog PMDialog

    Непрозрачный тип, представляющий пользовательское диалоговое окно печати.

    Объявление

    Objective C

    typedef struct OpaquePMDialog* PMDialog;

    Обсуждение

    Этот тип данных используется функциями, не рекомендованными или осужденными.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.7.

    Не доступный 64-разрядным приложениям.

  • PMIdleUPP PMIdleUPP

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

    Объявление

    Objective C

    typedef PMIdleProcPtr PMIdleUPP;

    Обсуждение

    Этот тип данных используется функциями, не рекомендованными или осужденными.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.7.

    Не доступный 64-разрядным приложениям.

  • PMLanguageInfo

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

    Объявление

    Objective C

    struct PMLanguageInfo { Str32 level; Str32 version; Str32 release; };

    Поля

    level

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

    version

    Указывает версию языка обработки изображений.

    release

    Указывает выпуск языка обработки изображений.

  • PMObject PMObject

    Базовый тип для всех непрозрачных типов используется в Базовой Печати.

    Объявление

    Swift

    typealias PMObject = UnsafePointer<Void>

    Objective C

    typedef const void* PMObject;

    Обсуждение

    PMObject базовый тип для непрозрачных типов такой как PMPrintSession, PMPageFormat, PMPrintSettings, PMPrinter, PMPaper, PMPreset, и PMServer. PMObject используется в функциях такой как PMRetain и PMRelease это воздействует на любой непрозрачный тип.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPageFormat PMPageFormat

    Непрозрачный тип, хранящий настройки в диалоговом окне Установки Страницы.

    Объявление

    Swift

    typealias PMPageFormat = COpaquePointer

    Objective C

    typedef struct OpaquePMPageFormat* PMPageFormat;

    Обсуждение

    Ваше приложение использует объекты формата страниц хранить информацию, такую как формат бумаги, ориентация и масштаб страниц в сеансе печати. Для создания объекта формата страниц Вы используете функцию PMCreatePageFormat. Новый объект формата страниц пуст и неприменим, пока Вы не вызываете PMSessionDefaultPageFormat или PMCopyPageFormat инициализировать настройки. Можно также использовать функции PMSetPageFormatExtendedData и PMGetPageFormatExtendedData сохранить и получить специализированные данные в объекте формата страниц.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPaper PMPaper

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

    Объявление

    Swift

    typealias PMPaper = COpaquePointer

    Objective C

    typedef struct OpaquePMPaper* PMPaper;

    Обсуждение

    Ваше приложение использует бумажные объекты идентифицировать стандартные и пользовательские типы печати бумаги.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPaperMargins PMPaperMargins

    Структура данных, указывающая непечатную область бумажного объекта.

    Объявление

    Swift

    typealias PMPaperMargins = PMRect

    Objective C

    typedef PMRect PMPaperMargins;

    Обсуждение

    Ваше приложение указывает бумажные поля при вызывании функции PMPaperCreateCustom создать пользовательский бумажный тип. Можно получить поля бумаги с функцией PMPaperGetMargins.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPreset PMPreset

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

    Объявление

    Swift

    typealias PMPreset = COpaquePointer

    Objective C

    typedef struct OpaquePMPreset* PMPreset;

    Обсуждение

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrinter PMPrinter

    Непрозрачный тип, представляющий принтер.

    Объявление

    Swift

    typealias PMPrinter = COpaquePointer

    Objective C

    typedef struct OpaquePMPrinter* PMPrinter;

    Обсуждение

    Вы обычно получаете объект принтера использование функции PMSessionGetCurrentPrinter или PMServerCreatePrinterList.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrintSession PMPrintSession

    Непрозрачный тип, хранящий информацию о задании печати.

    Объявление

    Swift

    typealias PMPrintSession = COpaquePointer

    Objective C

    typedef struct OpaquePMPrintSession* PMPrintSession;

    Обсуждение

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

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrintSettings PMPrintSettings

    Непрозрачный тип, хранящий настройки в диалоговом окне Печати.

    Объявление

    Swift

    typealias PMPrintSettings = COpaquePointer

    Objective C

    typedef struct OpaquePMPrintSettings* PMPrintSettings;

    Обсуждение

    Ваши настройки печати использования приложения возражают, чтобы хранить информацию, такую как число копий и диапазон страниц для печати в сеансе печати. Для создания объекта настроек печати Вы используете функцию PMCreatePrintSettings. Новый объект настроек печати пуст и неприменим, пока Вы не вызываете PMSessionDefaultPrintSettings или PMCopyPrintSettings инициализировать настройки. Можно также использовать функции PMSetPrintSettingsExtendedData и PMGetPrintSettingsExtendedData сохранить и получить специализированные данные в объекте настроек печати.

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMRect

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

    Объявление

    Objective C

    struct PMRect { double top; double left; double bottom; double right; };

    Поля

    top

    Вертикальная координата для верхней левой точки прямоугольника.

    left

    Горизонтальная координата для верхней левой точки прямоугольника.

    bottom

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

    right

    Горизонтальная координата для нижней правой точки прямоугольника.

  • PMResolution

    Структура данных, содержащая информацию о разрешении печати.

    Объявление

    Objective C

    struct PMResolution { double hRes; double vRes; };

    Поля

    hRes

    Горизонтальное разрешение в точках на дюйм (точки на дюйм).

    vRes

    Вертикальное разрешение в точках на дюйм (точки на дюйм).

    Обсуждение

    Функции PMGetResolution и PMPrinterGetPrinterResolution используйте эту структуру для возврата информации о разрешении печати. Ваше приложение может передать эту информацию функции PMSetResolution.

  • PMServer PMServer

    Непрозрачный тип, идентифицирующий локальный или удаленный сервер печати.

    Объявление

    Swift

    typealias PMServer = COpaquePointer

    Objective C

    typedef struct OpaquePMServer* PMServer;

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • PMPrintContext PMPrintContext

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

    Объявление

    Objective C

    typedef struct OpaquePMPrintContext* PMPrintContext;

    Обсуждение

    Этот тип данных используется функциями, не рекомендованными или осужденными.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.7.

    Не доступный 64-разрядным приложениям.

  • PMColorMode PMColorMode

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

    Объявление

    Objective C

    typedef UInt16 PMColorMode;

    Обсуждение

    Этот тип данных используется функциями, не рекомендованными или осужденными.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Не доступный 64-разрядным приложениям.

Константы

  • Данные не требуемые константы

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

    Объявление

    Objective C

    #define kPMNoData NULL #define kPMDontWantSize NULL #define kPMDontWantData NULL #define kPMDontWantBoolean NULL #define kPMNoPrintSettings NULL #define kPMNoPageFormat NULL #define kPMNoReference NULL

    Константы

    • kPMNoData

      kPMNoData

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

    • kPMDontWantSize

      kPMDontWantSize

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

    • kPMDontWantData

      kPMDontWantData

      Указывает, что для Вашего приложения не нужны данные, возвращенные функцией печати.

    • kPMDontWantBoolean

      kPMDontWantBoolean

      Указывает, что для Вашего приложения не нужно булево значение, возвращенное функцией печати.

    • kPMNoPrintSettings

      kPMNoPrintSettings

      Указывает, что для Вашего приложения не нужен a PMPrintSettings объект, возвращенный функцией печати.

    • kPMNoPageFormat

      kPMNoPageFormat

      Указывает, что для Вашего приложения не нужен a PMPageFormat объект, возвращенный функцией печати.

    • kPMNoReference

      kPMNoReference

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

  • Форматы представления данных

    Константы, указывающие формат представления данных, создаваемого с функциями PMPageFormatCreateDataRepresentation и PMPrintSettingsCreateDataRepresentation.

    Объявление

    Swift

    struct PMDataFormat { init(_ value: UInt32) var value: UInt32 }

    Objective C

    enum PMDataFormat { kPMDataFormatXMLDefault = 0, kPMDataFormatXMLMinimal = 1, kPMDataFormatXMLCompressed = 2 }; typedef enum PMDataFormat PMDataFormat;

    Константы

    • kPMDataFormatXMLDefault

      kPMDataFormatXMLDefault

      Указывает формат данных, который совместим со всеми версиями OS X. Данные в этом формате могут использоваться с PMUnflattenXXX настоящее функций в версиях OS X до 10,5. Этот формат является чистым представлением XML данных. Однако этот формат намного больше, чем более современные форматы данных, описанные ниже.

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

    • kPMDataFormatXMLMinimal

      kPMDataFormatXMLMinimal

      Указывает несжатый формат данных, который приблизительно в 3-5 раз меньше, чем kPMDataFormatXMLDefault. Этот формат данных только совместим с OS X v10.5 и позже. Этот формат является хорошим выбором, когда Вы не должны использовать данные в версиях OS X до 10,5, и Вам нужно чистое представление XML данных.

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

    • kPMDataFormatXMLCompressed

      kPMDataFormatXMLCompressed

      Указывает упакованный формат данных, который приблизительно в 20 раз меньше, чем kPMDataFormatXMLDefault. Этот формат данных только совместим с OS X v10.5 и позже. Этот формат является хорошим выбором, когда Вы не должны использовать данные в версиях OS X до 10,5, и минимальный размер данных важен. Обратите внимание на то, что этот формат не является чистым представлением XML данных.

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • Целевые типы

    Константы, указывающие место назначения для задания печати.

    Объявление

    Swift

    typealias PMDestinationType = UInt16

    Objective C

    typedef UInt16 PMDestinationType; enum { kPMDestinationInvalid = 0, kPMDestinationPrinter = 1, kPMDestinationFile = 2, kPMDestinationFax = 3, kPMDestinationPreview = 4, kPMDestinationProcessPDF = 5 };

    Константы

    • kPMDestinationInvalid

      kPMDestinationInvalid

      Указывает, что место назначения недопустимо.

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

    • kPMDestinationPrinter

      kPMDestinationPrinter

      Указывает вывод к принтеру.

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

    • kPMDestinationFile

      kPMDestinationFile

      Указывает вывод к файлу.

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

    • kPMDestinationFax

      kPMDestinationFax

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

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

    • kPMDestinationPreview

      kPMDestinationPreview

      Указывает вывод к предварительному просмотру.

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

    • kPMDestinationProcessPDF

      kPMDestinationProcessPDF

      Указывает вывод к опции потока операций PDF.

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • Строки формата документа

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

    Объявление

    Objective C

    #define kPMDocumentFormatDefault CFSTR ("com.apple.documentformat.default") #define kPMDocumentFormatPDF CFSTR ("application/pdf") #define kPMDocumentFormatPICT CFSTR ("application/vnd.apple.printing-pict") #define kPMDocumentFormatPICTPS CFSTR ("application/vnd.apple.printing-pict-ps") #define kPMDocumentFormatPostScript CFSTR ("application/postscript")

    Константы

    • kPMDocumentFormatDefault

      kPMDocumentFormatDefault

      Указывает формат по умолчанию для системы печати. В OS X форматом по умолчанию является PDF.

    • kPMDocumentFormatPDF

      kPMDocumentFormatPDF

      Указывает PDF.

    • kPMDocumentFormatPICT

      kPMDocumentFormatPICT

      Указывает формат PICT.

    • kPMDocumentFormatPICTPS

      kPMDocumentFormatPICTPS

      Указывает формат PICT со встроенным PostScript.

    • kPMDocumentFormatPostScript

      kPMDocumentFormatPostScript

      Указывает формат PostScript.

  • Дуплексные режимы

    Константы, указывающие настройки дуплексного режима.

    Объявление

    Swift

    typealias PMDuplexMode = UInt32

    Objective C

    typedef UInt32 PMDuplexMode; enum { kPMDuplexNone = 0x0001, kPMDuplexNoTumble = 0x0002, kPMDuplexTumble = 0x0003, kPMSimplexTumble = 0x0004 };

    Константы

    • kPMDuplexNone

      kPMDuplexNone

      Печать только на одной стороне бумаги.

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

    • kPMDuplexNoTumble

      kPMDuplexNoTumble

      Печать с обеих сторон бумаги, с обеими сторонами, ориентированными в том же направлении (никакие акробатические прыжки). Это эквивалентно выбору «long edge binding» в области Print.

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

    • kPMDuplexTumble

      kPMDuplexTumble

      Печать с обеих сторон бумаги, с выводом на второй стороне, зеркально отраженной относительно первой стороны (падающий на). Это эквивалентно выбору «short edge binding» в области Print.

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

    • kPMSimplexTumble

      kPMSimplexTumble

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

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • Графические типы контекста

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

    Объявление

    Objective C

    #define kPMGraphicsContextDefault CFSTR ("com.apple.graphicscontext.default") #define kPMGraphicsContextQuickdraw CFSTR ("com.apple.graphicscontext.quickdraw") #define kPMGraphicsContextCoreGraphics CFSTR ("com.apple.graphicscontext.coregraphics")

    Константы

    • kPMGraphicsContextDefault

      kPMGraphicsContextDefault

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

    • kPMGraphicsContextQuickdraw

      kPMGraphicsContextQuickdraw

      Указывает контекст графики QuickDraw.

    • kPMGraphicsContextCoreGraphics

      kPMGraphicsContextCoreGraphics

      Указывает Кварцевый контекст графики. Система координат по умолчанию для Кварцевого контекста печати не является тем же как используемым для QuickDraw, распечатывающего контекст. Кварцевый контекст печати определяет координаты нижнего левого угла бумаги как (0,0), тогда как источник для QuickDraw в верхнем правом углу области изображения бумаги.

  • Константы ориентации страницы

    Константы, указывающие ориентацию страницы.

    Объявление

    Swift

    typealias PMOrientation = UInt16

    Objective C

    typedef UInt16 PMOrientation; enum { kPMPortrait = 1, kPMLandscape = 2, kPMReversePortrait = 3, kPMReverseLandscape = 4 };

    Константы

    • kPMPortrait

      kPMPortrait

      Указывает портрет (вертикальная) ориентация страницы. Портретная ориентация не выполняет изменения логической страницы.

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

    • kPMLandscape

      kPMLandscape

      Указывает альбомную (горизонтальную) ориентацию. Альбомная ориентация выполняет 90 ° против часовой стрелки вращение на логическом изображении страницы и устанавливает Кварцевый источник в верхний левый угол неповернутой логической страницы с положительными y-значениями, увеличивающимися через и направо от неповернутой страницы. Это имеет эффект вращения логического изображения страницы 90 ° по часовой стрелке. Другими словами, изображение появляется на неповернутой странице, как будто это было повернуто 90 ° по часовой стрелке.

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

    • kPMReversePortrait

      kPMReversePortrait

      Указывает обратную портретную ориентацию. Обратная портретная ориентация выполняет вращение на 180 ° на логическом прямоугольнике страницы и устанавливает Кварцевый источник в верхний правый угол неповернутой логической страницы с положительными y-значениями, увеличивающимися вниз. Это имеет эффект вращения логического изображения страницы 180 °. Обратная портретная ориентация поддерживается в OS X v10.5 и позже.

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

    • kPMReverseLandscape

      kPMReverseLandscape

      Указывает обратную альбомную ориентацию страницы. Альбомная ориентация выполняет 90 ° по часовой стрелке вращение на логическом прямоугольнике страницы и устанавливает Кварцевый источник в нижний правый угол неповернутой логической страницы с положительными y-значениями, увеличивающимися до через и налево от неповернутой страницы. Это имеет эффект вращения логического изображения страницы 90 ° против часовой стрелки. Другими словами, изображение появляется на неповернутой странице, как будто это было повернуто 90 ° против часовой стрелки.

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • Ключи словаря потока операций PDF

    Константы, указывающие ключи в словаре потока операций PDF.

    Объявление

    Objective C

    #define kPDFWorkFlowItemURLKey CFSTR("itemURL") #define kPDFWorkflowDisplayNameKey CFSTR("displayName") #define kPDFWorkflowFolderURLKey CFSTR("folderURL") #define kPDFWorkflowItemsKey CFSTR("items")

    Константы

    • kPDFWorkFlowItemURLKey

      kPDFWorkFlowItemURLKey

      URL к элементу потока операций PDF.

      Доступный в OS X v10.3 через OS X v10.9.

    • kPDFWorkflowDisplayNameKey

      kPDFWorkflowDisplayNameKey

      Визуализуемое пользователем имя для элемента потока операций PDF.

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

    • kPDFWorkflowFolderURLKey

      kPDFWorkflowFolderURLKey

      URL к папке, содержащей элементы потока операций PDF.

      Доступный в OS X v10.5 через OS X v10.9.

    • kPDFWorkflowItemsKey

      kPDFWorkflowItemsKey

      Базовый массив Основы, описывающий элементы потока операций PDF в папке.

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

  • Ключи словаря инжекции PostScript

    Константы, указывающие ключи для словарных статей инжекции PostScript.

    Объявление

    Objective C

    #define kPSInjectionSectionKey CFSTR ("section") #define kPSInjectionSubSectionKey CFSTR ("subsection") #define kPSInjectionPageKey CFSTR ("page") #define kPSInjectionPlacementKey CFSTR ("place") #define kPSInjectionPostScriptKey CFSTR ("psdata")

    Константы

    • kPSInjectionSectionKey

      kPSInjectionSectionKey

      Указывает раздел.

    • kPSInjectionSubSectionKey

      kPSInjectionSubSectionKey

      Указывает подраздел.

    • kPSInjectionPageKey

      kPSInjectionPageKey

      Указывает страницу.

    • kPSInjectionPlacementKey

      kPSInjectionPlacementKey

      Указывает размещение.

    • kPSInjectionPostScriptKey

      kPSInjectionPostScriptKey

      Указывает данные PostScript.

  • Опции инжекции страницы PostScript

    Константы, указывающие опции инжекции PostScript.

    Объявление

    Objective C

    enum { kPSPageInjectAllPages = -1, kPSInjectionMaxDictSize = 5 };

    Константы

    • kPSPageInjectAllPages

      kPSPageInjectAllPages

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

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kPSInjectionMaxDictSize

      kPSInjectionMaxDictSize

      Указывает максимальный размер, необходимый для словаря, используемого для инжекции PostScript.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

  • Опции размещения инжекции PostScript

    Константы, указывающие где в задании печати для введения кода PostScript.

    Объявление

    Objective C

    typedef UInt16 PSInjectionPlacement; enum { kPSInjectionBeforeSubsection = 1, kPSInjectionAfterSubsection = 2, kPSInjectionReplaceSubsection = 3 };

    Константы

    • kPSInjectionBeforeSubsection

      kPSInjectionBeforeSubsection

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

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kPSInjectionAfterSubsection

      kPSInjectionAfterSubsection

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

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kPSInjectionReplaceSubsection

      kPSInjectionReplaceSubsection

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

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • Разделы инжекции PostScript

    Константы, указывающие ключи для значений раздела инжекции PostScript.

    Объявление

    Objective C

    typedef SInt32 PSInjectionSection; enum { kInjectionSectJob = 1, kInjectionSectCoverPage = 2 };

    Константы

    • kInjectionSectJob

      kInjectionSectJob

      Указывает раздел задания. Если Вы не указываете ключ раздела явно, это - раздел по умолчанию.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSectCoverPage

      kInjectionSectCoverPage

      Указывает раздел титульного листа. В настоящее время неподдерживаемый.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • Подразделы инжекции PostScript

    Константы, указывающие значения инжекции PostScript для ключа подраздела.

    Объявление

    Objective C

    typedef SInt32 PSInjectionSubsection; enum { kInjectionSubPSAdobe = 1, kInjectionSubPSAdobeEPS = 2, kInjectionSubBoundingBox = 3, kInjectionSubEndComments = 4, kInjectionSubOrientation = 5, kInjectionSubPages = 6, kInjectionSubPageOrder = 7, kInjectionSubBeginProlog = 8, kInjectionSubEndProlog = 9, kInjectionSubBeginSetup = 10, kInjectionSubEndSetup = 11, kInjectionSubBeginDefaults = 12, kInjectionSubEndDefaults = 13, kInjectionSubDocFonts = 14, kInjectionSubDocNeededFonts = 15, kInjectionSubDocSuppliedFonts = 16, kInjectionSubDocNeededRes = 17, kInjectionSubDocSuppliedRes = 18, kInjectionSubDocCustomColors = 19, kInjectionSubDocProcessColors = 20, kInjectionSubPlateColor = 21, kInjectionSubPageTrailer = 22, kInjectionSubTrailer = 23, kInjectionSubEOF = 24, kInjectionSubBeginFont = 25, kInjectionSubEndFont = 26, kInjectionSubBeginResource = 27, kInjectionSubEndResource = 28, kInjectionSubPage = 29, kInjectionSubBeginPageSetup = 30, kInjectionSubEndPageSetup = 31 };

    Константы

    • kInjectionSubPSAdobe

      kInjectionSubPSAdobe

      Указывает “%! PS-Adobe” подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubPSAdobeEPS

      kInjectionSubPSAdobeEPS

      Указывает “%! PS-Adobe-3.0 EPSF-3.0” подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubBoundingBox

      kInjectionSubBoundingBox

      Указывает «%BoundingBox» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubEndComments

      kInjectionSubEndComments

      Указывает «%EndComments» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubOrientation

      kInjectionSubOrientation

      Указывает «%Orientation» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubPages

      kInjectionSubPages

      Указывает «%Pages» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubPageOrder

      kInjectionSubPageOrder

      Указывает «%PageOrder» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubBeginProlog

      kInjectionSubBeginProlog

      Указывает «%BeginProlog» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubEndProlog

      kInjectionSubEndProlog

      Указывает «%EndProlog» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubBeginSetup

      kInjectionSubBeginSetup

      Указывает «%BeginSetup» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubEndSetup

      kInjectionSubEndSetup

      Указывает «%EndSetup» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubBeginDefaults

      kInjectionSubBeginDefaults

      Указывает «%BeginDefaults» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubEndDefaults

      kInjectionSubEndDefaults

      Указывает «%EndDefaults» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubDocFonts

      kInjectionSubDocFonts

      Указывает «%DocumentFonts» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubDocNeededFonts

      kInjectionSubDocNeededFonts

      Указывает «%DocumentNeededFonts» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubDocSuppliedFonts

      kInjectionSubDocSuppliedFonts

      Указывает «%DocumentSuppliedFonts» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubDocNeededRes

      kInjectionSubDocNeededRes

      Указывает «%DocumentNeededResources» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubDocSuppliedRes

      kInjectionSubDocSuppliedRes

      Указывает «%DocumentSuppliedResources» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubDocCustomColors

      kInjectionSubDocCustomColors

      Указывает «%DocumentCustomColors» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubDocProcessColors

      kInjectionSubDocProcessColors

      Указывает «%DocumentProcessColors» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubPlateColor

      kInjectionSubPlateColor

      Указывает «%PlateColor» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubPageTrailer

      kInjectionSubPageTrailer

      Указывает «%PageTrailer» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubTrailer

      kInjectionSubTrailer

      Указывает «%Trailer» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubEOF

      kInjectionSubEOF

      Указывает «%EOF» (конец файла) подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubBeginFont

      kInjectionSubBeginFont

      Указывает «%BeginFont» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubEndFont

      kInjectionSubEndFont

      Указывает «%EndFont» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubBeginResource

      kInjectionSubBeginResource

      Указывает «%BeginResource» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubEndResource

      kInjectionSubEndResource

      Указывает «%EndResource» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubPage

      kInjectionSubPage

      Указывает «%Page» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubBeginPageSetup

      kInjectionSubBeginPageSetup

      Указывает «%BeginPageSetup» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kInjectionSubEndPageSetup

      kInjectionSubEndPageSetup

      Указывает «%EndPageSetup» подраздел.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • Домены файла описания принтера PostScript

    Константы, указывающие домены для файлов Описания принтера PostScript (PPD).

    Объявление

    Swift

    typealias PMPPDDomain = UInt16

    Objective C

    typedef UInt16 PMPPDDomain; enum { kAllPPDDomains = 1, kSystemPPDDomain = 2, kLocalPPDDomain = 3, kNetworkPPDDomain = 4, kUserPPDDomain = 5, kCUPSPPDDomain = 6 };

    Константы

    • kAllPPDDomains

      kAllPPDDomains

      Указывает все доступные домены.

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

    • kSystemPPDDomain

      kSystemPPDDomain

      Указывает системный домен.

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

    • kLocalPPDDomain

      kLocalPPDDomain

      Указывает локальный домен.

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

    • kNetworkPPDDomain

      kNetworkPPDDomain

      Указывает сетевой домен.

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

    • kUserPPDDomain

      kUserPPDDomain

      Указывает пользовательский домен.

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

    • kCUPSPPDDomain

      kCUPSPPDDomain

      Указывает домен CUPS.

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • Распечатайте все постоянные страницы

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

    Объявление

    Swift

    var kPMPrintAllPages: Int { get }

    Objective C

    enum { kPMPrintAllPages = -1 };

    Константы

    • kPMPrintAllPages

      kPMPrintAllPages

      Указывает, что должны быть распечатаны все страницы документа.

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

  • Качественные режимы печати

    Константы, указывающие стандартные опции по качеству печати.

    Объявление

    Swift

    typealias PMQualityMode = UInt32

    Objective C

    typedef UInt32 PMQualityMode; enum { kPMQualityLowest = 0, kPMQualityInkSaver = 1, kPMQualityDraft = 4, kPMQualityNormal = 8, kPMQualityPhoto = 11, kPMQualityBest = 13, kPMQualityHighest = 15 };

    Константы

    • kPMQualityLowest

      kPMQualityLowest

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

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

    • kPMQualityInkSaver

      kPMQualityInkSaver

      Указывает для использования режима, сохраняющего чернила, даже если они замедляют печать.

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

    • kPMQualityDraft

      kPMQualityDraft

      Указывает для печати на самой высокой скорости, с суммой чернил, используемых в качестве вторичного рассмотрения.

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

    • kPMQualityNormal

      kPMQualityNormal

      Указывает общий режим использования, балансирующий качество и скорость.

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

    • kPMQualityPhoto

      kPMQualityPhoto

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

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

    • kPMQualityBest

      kPMQualityBest

      Указывает для получения лучшего качества печати для всех объектов и фотографий на странице.

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

    • kPMQualityHighest

      kPMQualityHighest

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

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • Состояния очереди печати

    Константы, указывающие текущее состояние очереди печати.

    Объявление

    Swift

    typealias PMPrinterState = UInt16

    Objective C

    typedef UInt16 PMPrinterState; enum { kPMPrinterIdle = 3, kPMPrinterProcessing = 4, kPMPrinterStopped = 5 };

    Константы

    • kPMPrinterIdle

      kPMPrinterIdle

      Указывает состояние ожидания.

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

    • kPMPrinterProcessing

      kPMPrinterProcessing

      Указывает состояние обработки.

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

    • kPMPrinterStopped

      kPMPrinterStopped

      Указывает остановленное состояние.

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

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

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

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

  • Типы описания принтера

    Константы, указывающие типы описания принтера.

    Объявление

    Objective C

    #define kPMPPDDescriptionType CFSTR("PMPPDDescriptionType")

    Константы

    • kPMPPDDescriptionType

      kPMPPDDescriptionType

      Указывает Описание принтера PostScript (PPD).

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

  • Константы тега

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

    Объявление

    Objective C

    typedef UInt32 PMTag; enum { kPMCurrentValue = 'curr', kPMDefaultValue = 'dflt', kPMMinimumValue = 'minv', kPMMaximumValue = 'maxv', kPMSourceProfile = 'srcp', kPMMinRange = 'mnrg', kPMMaxRange = 'mxrg', kPMMinSquareResolution = 'mins', kPMMaxSquareResolution = 'maxs', kPMDefaultResolution = 'dftr' };

    Константы

    • kPMCurrentValue

      kPMCurrentValue

      Указывает текущую установку или значение.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kPMDefaultValue

      kPMDefaultValue

      Указывает настройку по умолчанию или значение.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kPMMinimumValue

      kPMMinimumValue

      Указывает минимальную установку или значение.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kPMMaximumValue

      kPMMaximumValue

      Указывает максимальную установку или значение.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kPMSourceProfile

      kPMSourceProfile

      Указывает исходный профиль ColorSync.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kPMMinRange

      kPMMinRange

      Указывает минимальное разрешение, поддерживаемое принтером.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kPMMaxRange

      kPMMaxRange

      Указывает максимальное разрешение, поддерживаемое принтером.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kPMMinSquareResolution

      kPMMinSquareResolution

      Указывает установку минимального разрешения, для которой горизонтальные и вертикальные разрешения равны.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kPMMaxSquareResolution

      kPMMaxSquareResolution

      Указывает установку максимального разрешения, для которой горизонтальные и вертикальные разрешения равны.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kPMDefaultResolution

      kPMDefaultResolution

      Указывает настройку разрешения по умолчанию для принтера (обычно 72 точки на дюйм).

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

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

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    Не доступный 64-разрядным приложениям.

  • Пользовательская постоянная отмена

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

    Объявление

    Swift

    var kPMCancel: Int { get }

    Objective C

    enum { kPMCancel = 128 };

    Константы

    • kPMCancel

      kPMCancel

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

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

    Обсуждение

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

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

    При предоставлении собственной неактивной функции (не необходимый в Mac OS 8, 9, или X), функция должна проверить на события клавиатуры Периода команды и установить состояние ошибки с помощью функции PMSessionSetError.

  • Цветовые режимы

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

    Объявление

    Objective C

    typedef UInt16 PMColorMode; enum { kPMBlackAndWhite = 1, kPMGray = 2, kPMColor = 3, kPMColorModeDuotone = 4, kPMColorModeSpecialColor = 5 };

    Константы

    • kPMBlackAndWhite

      kPMBlackAndWhite

      Указывает черно-белый режим.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kPMGray

      kPMGray

      Указывает полутоновый режим.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kPMColor

      kPMColor

      Указывает цветовой режим.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kPMColorModeDuotone

      kPMColorModeDuotone

      Указывает цветовой режим с двумя каналами.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    • kPMColorModeSpecialColor

      kPMColorModeSpecialColor

      Указывает для разрешения особых цветов такой как металлических и светло-голубых.

      Доступный в OS X v10.0 через OS X v10.9.

      Не доступный 64-разрядным приложениям.

    Обсуждение

    Эти константы используются осуждающимися функциями.

Коды результата

Эта таблица приводит коды результата, определенные для Базовой Печати.

  • kPMGeneralError

    Неустановленная ошибка произошла.

    Значение

    - 30870

    Описание

    Неустановленная ошибка произошла.

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

  • kPMOutOfScope

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

    Значение

    - 30871

    Описание

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

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

  • kPMNoDefaultPrinter

    Пользователь не указал принтер по умолчанию.

    Значение

    - 30872

    Описание

    Пользователь не указал принтер по умолчанию.

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

  • kPMNotImplemented

    Функция не реализована.

    Значение

    - 30873

    Описание

    Функция не реализована.

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

  • kPMNoSuchEntry

    Нет никакой записи для соответствия запроса приложения.

    Значение

    - 30874

    Описание

    Нет никакой записи для соответствия запроса приложения.

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

  • kPMInvalidPrintSettings

    Ваше приложение передало недопустимый объект настроек печати.

    Значение

    - 30875

    Описание

    Ваше приложение передало недопустимый объект настроек печати.

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

  • kPMInvalidPageFormat

    Ваше приложение передало недопустимый объект формата страниц.

    Значение

    - 30876

    Описание

    Ваше приложение передало недопустимый объект формата страниц.

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

  • kPMValueOutOfRange

    Ваше приложение передало значение из диапазона.

    Значение

    - 30877

    Описание

    Ваше приложение передало значение из диапазона.

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

  • kPMLockIgnored

    Значение блокировки было проигнорировано.

    Значение

    - 30878

    Описание

    Значение блокировки было проигнорировано.

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

  • kPMInvalidPrintSession

    Ваше приложение передало недопустимый объект сеанса печати.

    Значение

    - 30879

    Описание

    Ваше приложение передало недопустимый объект сеанса печати.

    Доступный в OS X v10.0 и позже.

  • kPMInvalidPrinter

    Ваше приложение передало недопустимый объект принтера.

    Значение

    - 30880

    Описание

    Ваше приложение передало недопустимый объект принтера.

    Доступный в OS X v10.0 и позже.

  • kPMObjectInUse

    Указанный объект используется.

    Значение

    - 30881

    Описание

    Указанный объект используется.

    Доступный в OS X v10.0 и позже.

  • kPMInvalidIndex

    Индекс массива недопустим.

    Значение

    - 30882

    Описание

    Индекс массива недопустим.

    Доступный в OS X v10.0 и позже.

  • kPMStringConversionFailure

    Внутренняя ошибка произошла при преобразовании строки.

    Значение

    - 30883

    Описание

    Внутренняя ошибка произошла при преобразовании строки.

    Доступный в OS X v10.0 и позже.

  • kPMXMLParseError

    Ошибка произошла при парсинге данных XML.

    Значение

    - 30884

    Описание

    Ошибка произошла при парсинге данных XML.

    Доступный в OS X v10.0 и позже.

  • kPMInvalidJobTemplate

    Внутренняя ошибка произошла при создании шаблона задания.

    Значение

    - 30885

    Описание

    Внутренняя ошибка произошла при создании шаблона задания.

    Доступный в OS X v10.0 и позже.

  • kPMInvalidPrinterInfo

    Информация о принтере недопустима.

    Значение

    - 30886

    Описание

    Информация о принтере недопустима.

    Доступный в OS X v10.0 и позже.

  • kPMInvalidConnection

    Тип соединения принтера недопустим.

    Значение

    - 30887

    Описание

    Тип соединения принтера недопустим.

    Доступный в OS X v10.0 и позже.

  • kPMInvalidKey

    Ключ в билете, шаблоне задания или словаре недопустим.

    Значение

    - 30888

    Описание

    Ключ в билете, шаблоне задания или словаре недопустим.

    Доступный в OS X v10.0 и позже.

  • kPMInvalidValue

    Значение в билете, шаблоне задания или словаре отсутствует.

    Значение

    - 30889

    Описание

    Значение в билете, шаблоне задания или словаре отсутствует.

    Доступный в OS X v10.0 и позже.

  • kPMInvalidAllocator

    Указанное средство выделения памяти недопустимо.

    Значение

    - 30890

    Описание

    Указанное средство выделения памяти недопустимо.

    Доступный в OS X v10.0 и позже.

  • kPMInvalidTicket

    Талон заказа недопустим.

    Значение

    - 30891

    Описание

    Талон заказа недопустим.

    Доступный в OS X v10.0 и позже.

  • kPMInvalidItem

    Элемент, добавляемый к билету, недопустим.

    Значение

    - 30892

    Описание

    Элемент, добавляемый к билету, недопустим.

    Доступный в OS X v10.0 и позже.

  • kPMInvalidType

    Тип данных в билете, шаблоне задания или словаре не является ожидаемым типом.

    Значение

    - 30893

    Описание

    Тип данных в билете, шаблоне задания или словаре не является ожидаемым типом.

    Доступный в OS X v10.0 и позже.

  • kPMInvalidReply

    Удаленный сервер или клиент отправили недопустимый ответ.

    Значение

    - 30894

    Описание

    Удаленный сервер или клиент отправили недопустимый ответ.

    Доступный в OS X v10.0 и позже.

  • kPMInvalidFileType

    Тип файла недопустим.

    Значение

    - 30895

    Описание

    Тип файла недопустим.

    Доступный в OS X v10.0 и позже.

  • kPMInvalidObject

    Объект недопустим.

    Значение

    - 30896

    Описание

    Объект недопустим.

    Доступный в OS X v10.0 и позже.

  • kPMInvalidPaper

    Ваше приложение передало недопустимый бумажный объект.

    Значение

    - 30897

    Описание

    Ваше приложение передало недопустимый бумажный объект.

    Доступный в OS X v10.2 и позже.

  • kPMInvalidCalibrationTarget

    Словарь, указывающий калибровочную цель принтера, недопустим.

    Значение

    - 30898

    Описание

    Словарь, указывающий калибровочную цель принтера, недопустим.

    Доступный в OS X v10.3 и позже.

  • kPMInvalidPreset

    Ваше приложение передало недопустимый предварительно установленный объект.

    Значение

    - 30899

    Описание

    Ваше приложение передало недопустимый предварительно установленный объект.

    Доступный в OS X v10.3 и позже.