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

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

Разработчик

Ссылка платформы AppKit ссылка класса NSAlert

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

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

NSAlert

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

Для отображения предупреждения как листа вызовите beginSheetModalForWindow:completionHandler: метод; для отображения того как модального приложением диалогового окна используйте runModal метод.

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

После создания предупреждения с помощью одного из предупредительных методов создания можно настроить его далее до отображения его путем настройки его атрибутов. Посмотрите Атрибуты Экземпляра

Атрибуты экземпляра

NSAlert объекты имеют следующие атрибуты:

  • Тип тип предупреждения помогает передать важность или серьезность ее сообщения пользователю. Указанный с alertStyle свойство.

  • Текст сообщения основное сообщение предупреждения. Указанный с messageText.

  • Информативная текстовая Дополнительная информация о предупреждении. Указанный с informativeText.

  • Значок дополнительный, пользовательский значок для отображения на предупреждении, использующемся вместо значка приложения по умолчанию. Указанный с icon.

  • Предупреждения справки могут позволить пользователю получить справку о них. Использовать helpAnchor и showsHelp.

  • Кнопки ответа По умолчанию предупреждение имеют одну кнопку ответа: кнопка OK. Можно добавить больше кнопок ответа с помощью buttons свойство.

  • Флажок Suppression флажок утаивания позволяет пользователю подавлять дисплей определенного предупреждения в последующих случаях события, инициировавшего его. Использовать showsSuppressionButton.

  • Аксессуар просматривает вспомогательное, представление позволяет Вам добавить дополнительную информацию к предупреждению; например, текстовое поле с контактной информацией. Использовать accessoryView, layout.

Разделение на подклассы примечаний

NSAlert класс не разработан для разделения на подклассы.

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

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Создание предупреждений
  • init - init

    Возвращает инициализированное предупреждение.

    Объявление

    Objective C

    - init

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

    Инициализированное предупреждение.

    Обсуждение

    Если Вы не должны поддерживать совместимость с существующим предупредительным кодом обработки, использующим основанный на функции API, необходимо выделить (alloc) и инициализируйте (init) предупредительный объект, и затем набор его атрибуты с помощью надлежащих методов NSAlert класс.

  • init (ошибка:) + alertWithError:

    Возвращает предупреждение, инициализированное из информации в ошибочном объекте.

    Объявление

    Swift

    init(error error: NSError) -> NSAlert

    Objective C

    + (NSAlert *)alertWithError:(NSError *)error

    Параметры

    error

    Информация об ошибке для отображения.

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

    Инициализированное предупреждение.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • alertWithMessageText:defaultButton:alternateButton:otherButton:informativeTextWithFormat: + alertWithMessageText:defaultButton:alternateButton:otherButton:informativeTextWithFormat: (OS X v10.10)

    Создает предупреждение, совместимое с предупреждениями, создаваемыми с помощью NSRunAlertPanel функция для дисплея как предупреждение стиля предупреждения.

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

    Вместо этого alloc и init NSAlert объект и набор его атрибуты как надлежащие.

    Объявление

    Objective C

    + (NSAlert *)alertWithMessageText:(NSString *)message defaultButton:(NSString *)defaultButton alternateButton:(NSString *)alternateButton otherButton:(NSString *)otherButton informativeTextWithFormat:(NSString *)format, ...

    Параметры

    messageTitle

    Заголовок предупреждения. Когда nil или пустая строка, локализованный заголовок значения по умолчанию используется («Предупреждение» на английском языке).

    defaultButtonTitle

    Заголовок для кнопки по умолчанию. Когда nil или пустая строка, значение по умолчанию локализовало заголовок кнопки («OK» на английском языке) используется.

    alternateButtonTitle

    Заголовок для альтернативной кнопки. Когда nil, альтернативная кнопка не создается.

    otherButtonTitle

    Заголовок для другой кнопки. Когда nil, другая кнопка не создается.

    informativeText

    Информативный текст. Это является дополнительным, но должно быть пустой строкой (@””) нет nil. Могут значения встроенной переменной с помощью строки формата; перечислите любые необходимые параметры за эту отформатированную строку в конце списка аргументов метода. Для получения дополнительной информации о строках формата посмотрите Строковые Объекты Форматирования.

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

    Инициализированное предупреждение.

    Обсуждение

    Для языков, читающих слева направо, кнопки размечаются на нижнем правом углу предупредительного листа или окна, с defaultButtonTitle справа, alternateButtonTitle слева, и otherButtonTitle в середине. Возвращаемые значения, идентифицирующие эти кнопки, являются константами — NSAlertDefaultReturn, NSAlertAlternateReturn, и NSAlertOtherReturn— это соответствует ключевым словам.

    По умолчанию первая кнопка имеет ключевой эквивалент Возврата, любая кнопка с заголовком «Cancel» имеет ключевой эквивалент Escape, и любая кнопка с заголовком “не Сохраняет”, имеет ключевой эквивалент Команды-D (но только если это не первая кнопка). Можно также присвоить различные ключевые эквиваленты для кнопок с помощью setKeyEquivalent: метод NSButton класс. Для доступа к кнопкам предупреждения используйте buttons свойство.

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

    Это - метод совместимости. Это разработано для простого принятия приложениями, мигрирующими от соответствующего основанного на функции API. Этот метод использует более ранние возвращаемые значения —NSAlertDefaultReturn, NSAlertAlternateReturn, и NSAlertOtherReturn— совместимый с более ранним API, а не возвращаемыми значениями, определенными NSAlert класс, описанный в Возвращаемых значениях Кнопки.

    Если Вы не должны поддерживать совместимость с существующим предупредительным кодом обработки, использующим основанный на функции API, необходимо выделить (alloc) и инициализируйте (init) объект, и затем набор его атрибуты с помощью надлежащих методов NSAlert класс.

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

    Objective C

    @import AppKit;

    Доступность

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

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

Конфигурирование предупреждений
  • расположение () - расположение

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

    Объявление

    Swift

    func layout()

    Objective C

    - (void)layout

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    accessoryView

  • alertStyle alertStyle Свойство

    Указывает уровень серьезности предупреждения.

    Объявление

    Swift

    var alertStyle: NSAlertStyle

    Objective C

    @property NSAlertStyle alertStyle

    Обсуждение

    Посмотрите перечисление NSAlertStyle для списка предупредительных констант стиля.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • accessoryView accessoryView Свойство

    Представление аксессуара предупреждения.

    Объявление

    Swift

    var accessoryView: NSView?

    Objective C

    @property(strong) NSView *accessoryView

    Обсуждение

    NSAlert класс помещает вспомогательное представление между информативным текстом или флажком утаивания (если есть) и кнопками ответа. Прежде чем Вы измените местоположение вспомогательного представление, сначала вызовите layout метод.

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

    Перечисление 1Adding вспомогательное представление к предупреждению
    • NSTextView *accessory = [[NSTextView alloc] initWithFrame:NSMakeRect(0,0,200,15)];
    • NSFont *font = [NSFont systemFontOfSize:[NSFont systemFontSize]];
    • NSDictionary *textAttributes = [NSDictionary dictionaryWithObject:font forKey:NSFontAttributeName];
    • [accessory insertText:[[NSAttributedString alloc] initWithString:@"Text in accessory view."
    • attributes:textAttributes]];
    • [accessory setEditable:NO];
    • [accessory setDrawsBackground:NO];
    • NSAlert *alert = [[NSAlert alloc] init];
    • alert.messageText = @"Message text.";
    • [alert setInformativeText:@"Informative text."];
    • alert.accessoryView = accessory;
    • [alert runModal];
    • [alert release;
    Диалоговое окно рисунка 1Alert со вспомогательным представление image: ../Art/alert_accessory.png

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • showsHelp showsHelp Свойство

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

    Объявление

    Swift

    var showsHelp: Bool

    Objective C

    @property BOOL showsHelp

    Обсуждение

    Установите значение этого свойства в YEStrue указать, что предупреждение имеет кнопку справки, или NOfalse указать его не делает.

    Когда пользователь нажимает кнопку справки предупреждения, предупредительный делегат (delegate) получает a alertShowHelp: сообщение. Если нет никакого делегата, или если делегат не реализует тот метод, или если возвращается делегат NOfalse, тогда openHelpAnchor:inBook: сообщение отправляется менеджеру по справке приложения с a nil книга и привязка, указанная helpAnchor свойство, если установлено. Если делегат возвращается, исключение повышено NOfalse и никакая привязка к справке не установлена.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    делегат

  • helpAnchor helpAnchor Свойство

    HTML предупреждения помогает привязке.

    Объявление

    Swift

    var helpAnchor: String?

    Objective C

    @property(copy) NSString *helpAnchor

    Обсуждение

    Для обеспечения привязки к справке для предупреждения установите это свойство в надлежащее строковое значение. Для удаления привязки к справке установите значение этого свойства в nil.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    showsHelp

  • делегат делегат Свойство

    Делегат предупреждения.

    Объявление

    Swift

    unowned(unsafe) var delegate: NSAlertDelegate?

    Objective C

    @property(assign) id< NSAlertDelegate > delegate

    Обсуждение

    Для установки делегата к предупреждению обеспечьте объект, соответствующий NSAlertDelegateпротокол к этому свойству. Для удаления делегата установите значение этого свойства в nil.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Отображение предупреждений
  • runModal () - runModal

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

    Объявление

    Swift

    func runModal() -> NSModalResponse

    Objective C

    - (NSModalResponse)runModal

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

    Ответ на предупреждение. Посмотрите раздел «Special Considerations» этого метода для подробных данных.

    Обсуждение

    Можно создать предупреждение или через стандарт, выделяют – инициализируют процедуру или, при необходимости в приложении, при помощи осуждаемого метода совместимости alertWithMessageText:defaultButton:alternateButton:otherButton:informativeTextWithFormat:.

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

    Если Вы используете alertWithMessageText:defaultButton:alternateButton:otherButton:informativeTextWithFormat: для создания предупреждения следующие константы используются для идентификации кнопки, используемой для отклонения предупреждения: NSAlertDefaultReturn, NSAlertAlternateReturn, и NSAlertOtherReturn. Иначе, используемые константы являются теми описанными в Возвращаемых значениях Кнопки.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – beginSheetModalForWindow:completionHandler:

  • beginSheetModalForWindow (_: completionHandler:) - beginSheetModalForWindow:completionHandler:

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

    Объявление

    Swift

    func beginSheetModalForWindow(_ sheetWindow: NSWindow, completionHandler handler: ((NSModalResponse) -> Void)?)

    Objective C

    - (void)beginSheetModalForWindow:(NSWindow *)sheetWindow completionHandler:(void (^)(NSModalResponse returnCode))handler

    Параметры

    sheetWindow

    Окно, на котором можно вывести на экран лист.

    handler

    Обработчик завершения, который вызывают, когда заканчивается модальный сеанс листа.

    Обсуждение

    Этот метод использует NSWindow методы листа для отображения предупреждения (для получения дополнительной информации посмотрите Управляющие Листы). Если предупреждение имеет предупредительный стиль NSCriticalAlertStyle, это будет представлено как критический лист, что означает, что это может вывести на экран поверх других листов, которые могли бы уже быть присоединены к окну. Иначе, это будет представлено — или поставлено в очередь для представления — как стандартный лист.

    Обратите внимание на то, что orderOut: больше потребности, которые не вызовут в обработчике завершения. Если Вы не отклоните предупреждение, то оно будет сделано для Вас после того, как закончится обработчик завершения.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – runModal

  • beginSheetModalForWindow (_: modalDelegate:didEndSelector:contextInfo:) - beginSheetModalForWindow:modalDelegate:didEndSelector:contextInfo: (OS X v10.10)

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

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

    Использовать beginSheetModalForWindow:completionHandler: вместо этого.

    Объявление

    Swift

    func beginSheetModalForWindow(_ window: NSWindow, modalDelegate modalDelegate: AnyObject?, didEndSelector alertDidEndSelector: Selector, contextInfo contextInfo: UnsafeMutablePointer<Void>)

    Objective C

    - (void)beginSheetModalForWindow:(NSWindow *)window modalDelegate:(id)modalDelegate didEndSelector:(SEL)alertDidEndSelector contextInfo:(void *)contextInfo

    Параметры

    window

    Родительское окно для листа.

    modalDelegate

    Делегат к модально-диалоговому сеансу.

    alertDidEndSelector

    Обменивайтесь сообщениями предупреждение отправляет к modalDelegate после того, как пользователь отвечает, но прежде чем отклонен лист.

    contextInfo

    Контекстные данные передали modalDelegate в didEndSelector сообщение.

    Обсуждение

    Можно создать требуемое NSAlert объект или через стандарт выделяет - инициализируют процедуру или при помощи метода совместимости alertWithMessageText:defaultButton:alternateButton:otherButton:informativeTextWithFormat:.

    alertDidEndSelector параметром должен быть селектор, берущий три параметра, и соответствующему методу нужно смоделировать объявление на следующем примере:

    • - (void) alertDidEnd:(NSAlert *)
    • alert
    • returnCode:(NSInteger)
    • returnCode
    • contextInfo:(void *)
    • contextInfo
    • ;

    где alert NSAlert объект, returnCode указывает, которые снабжают кнопками пользователя, по которому щелкают, и contextInfo то же contextInfo переданный в исходном сообщении. returnCode параметр идентифицирует, какая кнопка использовалась для отклонения предупреждения (см. раздел «Special Considerations» этого метода). Модальный делегат определяет, какая кнопка была нажата («OK», «Отмена», и т.д.) и продолжается соответственно.

    Если Вы хотите отклонить лист из alertDidEndSelector метод перед модальным делегатом выполняет действие в ответ на возвращаемое значение, отправить orderOut: (NSWindow) к объекту окна, полученному путем отправки window к alert параметр. Это позволяет Вам цепочечным листам, например, путем отклонения одного листа прежде, чем показать следующее из alertDidEndSelector метод. Обратите внимание на то, что необходимо бояться вызывать orderOut: на листе откуда-либо в Вашей программе перед alertDidEndSelector метод вызывается, потому что родительское окно может зависнуть, когда требуют другое предупреждение. Если необходимо сделать это, используйте NSApplication метод endSheet:.

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

    Если Вы используете alertWithMessageText:defaultButton:alternateButton:otherButton:informativeTextWithFormat: для создания предупреждения следующие константы используются для идентификации кнопки, используемой для отклонения предупреждения: NSAlertDefaultReturn, NSAlertAlternateReturn, и NSAlertOtherReturn. Иначе, используемые константы являются теми описанными в Возвращаемых значениях Кнопки.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    См. также

    – runModal
    – beginSheetModalForWindow:completionHandler:

  • suppressionButton suppressionButton Свойство

    Флажок утаивания предупреждения. (только для чтения)

    Объявление

    Swift

    var suppressionButton: NSButton? { get }

    Objective C

    @property(readonly, strong) NSButton *suppressionButton

    Обсуждение

    Если Вы хотите настроить флажок утаивания предупреждения, получить доступ к нему через это свойство и затем использовать методы NSButton класс. Например, можно сделать это, чтобы изменить сообщение значения по умолчанию флажка утаивания или изменить его начальное состояние выбора (который «отменяется» по умолчанию). Для примера кода посмотрите showsSuppressionButton свойство.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    showsSuppressionButton

  • showsSuppressionButton showsSuppressionButton Свойство

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

    Объявление

    Swift

    var showsSuppressionButton: Bool

    Objective C

    @property BOOL showsSuppressionButton

    Обсуждение

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

    По умолчанию флажок утаивания имеет заголовок, “Не показывают это сообщение снова”. Для настройки его используйте флажок title свойство, следующим образом:

    • myAlert
    • .suppressionButton.title = @"Do not show this warning again";

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

    Перечисление 2Creating предупреждение с флажком утаивания
    • NSString *alertSuppressionKey = @"AlertSuppression";
    • NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
    • if ([defaults boolForKey: alertSuppressionKey]) {
    • NSLog (@"Alert suppressed");
    • } else {
    • NSAlert *anAlert = [[NSAlert alloc] init];
    • anAlert.messageText = @"Message text.";
    • anAlert.informativeText = @"Informative text.";
    • anAlert.showsSuppressionButton = YES; // Uses default checkbox title
    • [anAlert runModal];
    • if (anAlert.suppressionButton.state == NSOnState) {
    • // Suppress this alert from now on
    • [defaults setBool: YES forKey: alertSuppressionKey];
    • }
    • }
    Рисунок 2Alert с флажком утаивания и настроенным текстом image: ../Art/alert_suppression.png

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    suppressionButton

Доступ к предупредительному тексту
  • informativeText informativeText Свойство

    Информативный текст предупреждения.

    Объявление

    Swift

    var informativeText: String?

    Objective C

    @property(copy) NSString *informativeText

    Обсуждение

    Значение этого свойства не должно быть nil.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    messageText

  • messageText messageText Свойство

    Текст сообщения или заголовок предупреждения.

    Объявление

    Swift

    var messageText: String?

    Objective C

    @property(copy) NSString *messageText

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    informativeText

Доступ к пользовательскому значку предупреждения
  • значок значок Свойство

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

    Объявление

    Swift

    var icon: NSImage!

    Objective C

    @property(strong) NSImage *icon

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Доступ к предупредительным кнопкам ответа
  • кнопки кнопки Свойство

    Массив кнопок ответа для предупреждения. (только для чтения)

    Объявление

    Swift

    var buttons: [AnyObject] { get }

    Objective C

    @property(readonly, copy) NSArray *buttons

    Обсуждение

    Кнопка вывела на экран самый правый на предупреждении (для слева направо языка), соответствует кнопке в индексе 0 в массиве этого свойства, и считается кнопкой по умолчанию. Пользователь может вызвать эту кнопку путем нажатия клавиши Return.

    Любая кнопка с заголовком «Cancel» имеет ключевой эквивалент Escape, и любая кнопка с заголовком “не Сохраняет”, имеет ключевой эквивалент Команды-D (но только если это не первая кнопка). Можно также присвоить различные ключевые эквиваленты для кнопок с помощью setKeyEquivalent: метод NSButton класс.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – addButtonWithTitle:
    Возвращаемые значения кнопки

  • addButtonWithTitle (_:) - addButtonWithTitle:

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

    Объявление

    Swift

    func addButtonWithTitle(_ buttonTitle: String) -> NSButton

    Objective C

    - (NSButton *)addButtonWithTitle:(NSString *)buttonTitle

    Параметры

    buttonTitle

    Заголовок кнопки для добавления к предупреждению. Не должен быть nil.

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

    Кнопка добавила к предупреждению.

    Обсуждение

    Кнопки помещаются, запускаясь около правой стороны предупреждения и идя к левой стороне (для языков, читающих слева направо). Первые три кнопки идентифицируются позиционально как NSAlertFirstButtonReturn, NSAlertSecondButtonReturn, NSAlertThirdButtonReturn в параметре кода возврата, оцененном модальным делегатом. Последующие кнопки идентифицируются как NSAlertThirdButtonReturn +n, где n целое число

    По умолчанию первая кнопка имеет ключевой эквивалент Возврата, любая кнопка с заголовком «Cancel» имеет ключевой эквивалент Escape, и любая кнопка с заголовком “не Сохраняет”, имеет ключевой эквивалент Команды-D (но только если это не первая кнопка). Можно также присвоить различные ключевые эквиваленты для кнопок с помощью setKeyEquivalent: метод NSButton класс. Кроме того, можно использовать setTag: метод NSButton класс для установки возвращаемого значения.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – кнопки

Получение предупредительного Windows
  • окно окно Свойство

    Модальная приложением панель или модальный документом лист, соответствующий предупреждению. (только для чтения)

    Объявление

    Swift

    var window: AnyObject { get }

    Objective C

    @property(readonly, strong) id window

    Обсуждение

    Окно предупреждения имеет тип NSPanel. Используйте это свойство, когда Вы захотите отклонить предупреждение, создаваемое с beginSheetModalForWindow:completionHandler: метод в блоке обработчика завершения того метода.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Типы данных

  • NSAlertStyle NSAlertStyle

    NSAlert класс определяет предупредительные стили, используемые alertStyle свойство.

    Объявление

    Swift

    enum NSAlertStyle : UInt { case WarningAlertStyle case InformationalAlertStyle case CriticalAlertStyle }

    Objective C

    enum { NSWarningAlertStyle = 0, NSInformationalAlertStyle = 1, NSCriticalAlertStyle = 2 }; typedef NSUInteger NSAlertStyle;

    Константы

    • WarningAlertStyle

      NSWarningAlertStyle

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

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

    • InformationalAlertStyle

      NSInformationalAlertStyle

      Предупреждение раньше сообщало пользователю о текущем или нависшем событии.

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

    • CriticalAlertStyle

      NSCriticalAlertStyle

      Зарезервированный этот стиль для критических предупреждений, такой как тогда, когда могли бы быть серьезные последствия в результате определенного пользовательского ответа (например, “чистая установка” сотрет все данные по объему). Этот стиль заставляет значок быть под маркой со значком предупреждения.

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

    Обсуждение

    В настоящее время между информационными и предупреждающими предупреждениями нет никакого визуального различия. Необходимо только использовать критическое (или «предостережение») предупредительный стиль, если гарантировано, как указано в главе «Предупреждений» в Инструкциях по Интерфейсу пользователя OS X.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Константы
  • Возвращаемые значения кнопки

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

    Объявление

    Swift

    var NSAlertFirstButtonReturn: Int { get } var NSAlertSecondButtonReturn: Int { get } var NSAlertThirdButtonReturn: Int { get }

    Objective C

    enum { NSAlertFirstButtonReturn = 1000, NSAlertSecondButtonReturn = 1001, NSAlertThirdButtonReturn = 1002 };

    Константы

    • NSAlertFirstButtonReturn

      NSAlertFirstButtonReturn

      Пользователь нажал первую (самую правую) кнопку на диалоговом окне или листе.

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

    • NSAlertSecondButtonReturn

      NSAlertSecondButtonReturn

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

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

    • NSAlertThirdButtonReturn

      NSAlertThirdButtonReturn

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

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

    Обсуждение

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