PDEPlugIn

PDEPlugIn неофициальный протокол определяет методы, которые Какао, распечатывающее диалоговый дополнительный плагин (Какао PDE), должно реализовать для добавления одной или более пользовательских областей к диалоговому окну печати. Система печати обеспечивает тип необходимой области (Установка страницы или диалоговое окно Печати), а также информация о задании печати. PDE Какао может использовать эту информацию для определения, какие области должны быть созданы. Каждая область должна соответствовать PDEPanel неофициальный протокол. И приложения и драйвера принтера могут использовать PDEs для добавления областей к печати диалоговых окон.

Имя класса, реализующего PDEPlugIn протокол должен быть объявлен в Какао PDE’s Info.plist файл. Ключ для этого имени класса является строкой NSPrincipalClass. Например, если PDE использует названный класс OutputBinsPDEPlugIn реализовать этот протокол, Info.plist файл в PDE должен содержать эту запись:

      <key>NSPrincipalClass</key>
<string>OutputBinsPDEPlugIn</string>

Приложение может разместить одно или более Какао PDEs. Приложение PDE должно быть сохранено в PlugIns каталог в комплекте приложений. Для объявления приложения PDEs к системе печати необходимо добавить массив, содержащий их имена к Info.plist файл для приложения. Ключ для этого массива является строкой PrintDialogExtensions. Например, если приложение содержит названный PDE AppCustomPDE.bundle, приложение Info.plist файл должен содержать эту запись:

      <key>PrintDialogExtensions</key>
<array>
   <string>AppCustomPDE.bundle</string>
</array>

Драйвер принтера может разместить одно или более Какао PDEs. Драйвер принтера PDE обычно сохранен где-нибудь в каталоге поставщика, расположенном в /Library/Printers/. Путь к каждому PDE должен быть объявлен в файле PPD драйвера принтера с помощью APDialogExtension ключевое слово. Например, если драйверу принтера назвали связанный PDE OutputBinsPDE.bundle, файл PPD должен содержать запись, выглядящую примерно так:

      *APDialogExtension: "/Library/Printers/MyCompany/PDEs/OutputBinsPDE.bundle"

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

Не применимый

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

Не применимый

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

Не применимый

Objective C

@import ApplicationServices;

Доступность

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

Инициализация

initWithBundle: - initWithBundle:

Инициализирует плагин.

Объявление

Objective C

- (BOOL)initWithBundle:(NSBundle *)theBundle

Параметры

theBundle

Сменный пакет.

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

YEStrue если успешно выполнилась инициализация; иначе, NOfalse.

Обсуждение

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

Если Вы возвращаетесь NOfalse или не реализуйте этот метод, система печати не загружает PDE и отправляет его PDEPanelsForType:withHostInfo: сообщение.

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

Objective C

@import ApplicationServices;

Доступность

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

Инстанцирование области


    
    PDEPanelsForType:withHostInfo:
    - PDEPanelsForType:withHostInfo:

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

Объявление

Objective C

- (NSArray *)PDEPanelsForType:(NSString *)pdeType withHostInfo:(id)host

Параметры


      pdeType

Константа, предоставленная системой печати, указывающей тип областей этот метод, должна возвратиться. Константы определяются в PMPrintingDialogExtensions.h. Существует три возможных значения:

`kAppPageSetupDialogTypeIDStr`	Это подключаемый модуль приложений и области, которые Вы возвращаете, добавляется к диалоговому окну Установки Страницы.
`kAppPrintDialogTypeIDStr`	Это подключаемый модуль приложений и области, которые Вы возвращаете, добавляется к диалоговому окну Печати.
`kPrinterModuleTypeIDStr`	Это - плагин драйвера принтера и области, которые Вы возвращаете, добавляются к диалоговому окну Печати.


      host

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

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

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

Массив объектов, соответствующих PDEPanel неофициальный протокол. Каждый объект представляет область, которая будет добавлена к диалоговому окну. Можно возвратиться также nil или пустой массив, если не должны использоваться никакие области.

Обсуждение

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

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

Objective C

@import ApplicationServices;

Доступность

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