PDEPanel

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

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

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

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

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

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

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

Objective C

@import ApplicationServices;

Доступность

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

Предоставление информации области

panelName - panelName

Возвращает локализованное имя области.

Объявление

Objective C

- (NSString *)panelName

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

Локализованное имя области.

Обсуждение

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

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

Objective C

@import ApplicationServices;

Доступность

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

Возвращает добрый ID области.

Объявление

Objective C

- (NSString *)panelKind

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

Уникальная строка, идентифицирующая область.

Обсуждение

В этом требуемом методе необходимо возвратить строку, однозначно определяющую пользовательскую область. Как правило, добрый ID Вашей области является обратным доменным именем такой как com.mycompany.print.pde.

Примечание:

Для переопределения области, предоставленной системой печати, возвратите соответствующий вид области, постоянный определенный в PMPrintingDialogExtensions.h. В то время как возможно переопределить системную область, Вы отговорены делать так. Если Вы думаете, что необходимо переопределить одну из этих областей, свяжитесь с Apple для уведомления.

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

Objective C

@import ApplicationServices;

Доступность

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

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

Объявление

Objective C

- (NSView *)panelView

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

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

Обсуждение

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

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

Objective C

@import ApplicationServices;

Доступность

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

Возвраты локализовали текстовые описания текущих настроек области.

Объявление

Objective C

- (NSDictionary *)summaryInfo

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

Словарь, содержащий пары ключ/значение, описывающие настройки Вашей пользовательской области и их текущую стоимость. Каждый ключ в словаре должен быть NSString объект, обеспечивающий имя установки. Соответствующее значение ключа должно быть NSString объект, описывающий текущую стоимость установки. Например, ключ в словаре для области Copies и Pages мог бы быть «Диапазон Страницы», и соответствующее значение могло бы быть «1 - 5». Строки должны быть локализованы для текущего пользователя.
Пользователи ожидают, что диалоговые области Печати предоставят сводную информацию, таким образом, Вы будете призваны предоставить сводную информацию для своей пользовательской области. Если для некоторого неопровержимого довода Вы не хотите для этого, можно возвратиться nil.

Обсуждение

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

Порядок, в котором настройки Вашей области перечислены в области Summary, произволен. Однако можно указать порядок путем добавления дополнительной пары ключ/значение к словарю, который Вы возвращаете. Ключ должен быть строковой константой SUMMARY_DISPLAY_ORDER. Значение, связанное с этим ключом, должно быть массивом, содержащим имена всех Ваших настроек в порядке, которого Вы желаете. Эта функция поддерживается в OS X v10.5 и позже.

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

Objective C

@import ApplicationServices;

Доступность

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

Обработка изменений в видимости области

willShow - willShow

Подготавливает область к дисплею.

Объявление

Objective C

- (void)willShow

Обсуждение

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

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

Objective C

@import ApplicationServices;

Доступность

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

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

Объявление

Objective C

- (BOOL)shouldHide

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

YEStrue если это должно хорошо скрыть область; иначе, NOfalse.

Обсуждение

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

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

Objective C

@import ApplicationServices;

Доступность

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

Сохранение и восстановление настроек области


    
    saveValuesAndReturnError:
    - saveValuesAndReturnError:

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

Объявление

Objective C

- (BOOL)saveValuesAndReturnError:(NSError **)error

Параметры


      error

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

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

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

Обсуждение

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

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

Настройки пользовательского интерфейса области основываются на значениях, сохраненных в печати системных объектов, связанных с текущим заданием печати. Для обеспечения доступа к этим системным объектам печати система печати создает объект хоста, соответствующий PDEPlugInCallbackProtocol неофициальный протокол. Система печати передает объект хоста Вашему PDE, когда это отправляет PDEPanelsForType:withHostInfo: сообщение, метод в PDEPlugIn неофициальный протокол. Ваш PDE ответственен за предоставление доступа к этому объекту хоста, для его областей.

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

Если пользователь изменяет опцию PPD, Ваша область должна сразу сохранить новое значение опции путем отправки willChangePPDOptionKeyValue:ppdChoice: обменивайтесь сообщениями к объекту хоста.
Если пользователь изменяет пользовательскую опцию, Ваша область должна сохранить новое значение опции в объекте хоста PMPrintSettings или PMPageFormat объект. Можно сохранить значение сразу, когда пользователь изменяет опцию, или ожидайте, пока этот метод не вызывается.

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

Objective C

@import ApplicationServices;

Доступность

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


    
    restoreValuesAndReturnError:
    - restoreValuesAndReturnError:

Восстанавливает настройки области.

Объявление

Objective C

- (BOOL)restoreValuesAndReturnError:(NSError **)error

Параметры


      error

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

YEStrue указать, что настройки были инициализированы или восстановлены.

Обсуждение

Система печати вызывает этот метод, прежде чем область будет сначала показана или после того, как пользователь выбирает новую предварительную установку.

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

Настройки области основываются на значениях, сохраненных в печати системных объектов, связанных с заданием печати. Для обеспечения доступа к этим системным объектам печати система печати создает объект хоста, соответствующий PDEPlugInCallbackProtocol неофициальный протокол. Система печати передает объект хоста Вашему PDE, когда это отправляет PDEPanelsForType:withHostInfo: сообщение, метод в PDEPlugIn неофициальный протокол. Ваш PDE ответственен за предоставление доступа к этому объекту хоста, для его областей.

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

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

Objective C

@import ApplicationServices;

Доступность

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

Поддержка опций PPD

Опции PPD являются параметрами принтера, указанными в PPD целевого принтера (описание принтера PostScript) файл.

supportedPPDOptionKeys - supportedPPDOptionKeys
Объявляет, что область поддерживает одну или более опций PPD.

Объявление

Objective C

- (NSArray *)supportedPPDOptionKeys

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

Массив строк, объявляющих опции PPD, которые поддерживает эта область.
Обсуждение

В этом дополнительном методе пользовательская область в диалоговом окне Печати может сообщить системе печати, что область обеспечивает пользовательский интерфейс для одной или более опций в файле PPD целевого принтера. Функциональные клавиши PPD являются строками, определенными в файле PPD. Например, чтобы объявить, что область поддерживает единственную опцию PPD под названием OutputBin, этот метод мог возвратиться:
NSArray *myOptionArray = [NSArray arrayWithObjects:@"OutputBin", nil];
После того, как все диалоговые области Печати загружаются, система печати создает пользовательский интерфейс для любых остающихся невостребованных опций PPD и представляет пользовательский интерфейс для этих опций в области Printer Features диалогового окна Печати. Поставщики принтера призваны поддерживать как можно больше этих невостребованных опций PPD. Если Вы намереваетесь поддерживать опцию PPD, необходимо объявить его, когда вызывается этот метод.

Примечание:

Система печати поддерживает опции PPD ManualFeed, InputSlot, Дуплекс, Сопоставляют, и OutputOrder. Вы не должны пытаться поддерживать эти опции.
Оператор импорта

Objective C

@import ApplicationServices;

Доступность

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


    
    PPDOptionKeyValueDidChange:ppdChoice:
    - PPDOptionKeyValueDidChange:ppdChoice:

Обрабатывает изменение в значении опции PPD, которую поддерживает область.

Объявление

Objective C

- (void)PPDOptionKeyValueDidChange:(NSString *)option ppdChoice:(NSString *)choice

Параметры

`option`	Изменившаяся опция PPD.
`choice`	Новое значение опции PPD.

Обсуждение

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

В этом дополнительном методе можно обновить любые внутренние данные, которые Вы поддерживаете для этой опции PPD.

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

Система печати не вызывает этот метод в OS X v10.4.

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

Objective C

@import ApplicationServices;

Доступность

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