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.

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

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