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

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

Разработчик

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

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

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

NSButton

NSButton класс является подклассом NSControl это прерывает события mouseDown и отправляет сообщение действия в целевой объект, когда по этому щелкают или нажимают.

NSButton класс использует NSButtonCell для реализации его пользовательского интерфейса.

NSButton и NSMatrix оба обеспечивают представление управления, которое необходимо для отображения NSButtonCell объект. Однако, в то время как NSMatrix требует Вас к доступу NSButtonCell объекты непосредственно, большая часть NSButton методы класса являются «прикрытиями» для тождественно заявленных методов в NSButtonCell. (Другими словами, реализация NSButton метод вызывает соответствие NSButtonCell метод для Вас, позволяя Вам быть равнодушным к существованию NSButtonCell.) Единственное NSButtonCell методы, не имеющие покрытий, касаются шрифта, используемого для отображения ключевого эквивалента и к определенным методам для выделения или показа состояния NSButton (они в последний раз обычно устанавливаются вместе с NSButton setButtonType: метод).

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

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Конфигурирование кнопок
  • setButtonType (_:) - setButtonType:

    Наборы, как подсветки кнопки получателя, в то время как нажато и как это показывает свое состояние.

    Объявление

    Swift

    func setButtonType(_ aType: NSButtonType)

    Objective C

    - (void)setButtonType:(NSButtonType)aType

    Параметры

    aType

    Постоянное указание типа кнопки — одна из констант, описанных в разделе Constants NSButtonCell.

    Обсуждение

    setButtonType: восстанавливает изображение кнопки перед возвратом.

    Доступные типы для наиболее распространенных типов кнопки, которые также доступны в Интерфейсном Разработчике. Можно сконфигурировать различное поведение с NSButtonCell методы setHighlightsBy: и setShowsStateBy:.

    Обратите внимание на то, что существует нет -buttonType метод. Метод установки устанавливает различные свойства кнопки, вместе устанавливающие поведение типа.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    alternateImage
    изображение
    – setButtonType: (NSButtonCell)

  • getPeriodicDelay (_: интервал:) - getPeriodicDelay:interval:

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

    Объявление

    Swift

    func getPeriodicDelay(_ delay: UnsafeMutablePointer<Float>, interval interval: UnsafeMutablePointer<Float>)

    Objective C

    - (void)getPeriodicDelay:(float *)delay interval:(float *)interval

    Параметры

    delay

    По возврату количество времени (в секундах) кнопка приостановится прежде, чем начать периодически отправлять сообщения действия в целевой объект. Задержка по умолчанию взята от значения по умолчанию пользователя (максимум 60 секунд). Если пользователь не указал значение по умолчанию, delay значения по умолчанию к 0,4 секундам,

    interval

    По возврату, количество времени (в секундах) между каждым отправляющимся сообщением действия. Интервал по умолчанию взят от значения по умолчанию пользователя (максимум 60 секунд). Если пользователь не указал значение по умолчанию, interval значения по умолчанию к 0,075 секундам.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – isContinuous (NSControl)

  • setPeriodicDelay (_: интервал:) - setPeriodicDelay:interval:

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

    Объявление

    Swift

    func setPeriodicDelay(_ delay: Float, interval interval: Float)

    Objective C

    - (void)setPeriodicDelay:(float)delay interval:(float)interval

    Параметры

    delay

    Количество времени (в секундах), который непрерывная кнопка приостановит прежде, чем начать периодически отправлять сообщения действия в целевой объект. Максимальное позволенное значение составляет 60,0 секунды; если большее значение предоставляется, оно проигнорировано, и используются 60,0 секунды.

    interval

    Количество времени (в секундах) между каждым сообщением действия. Максимальное значение составляет 60,0 секунды; если большее значение предоставляется, оно проигнорировано, и используются 60,0 секунды.

    Обсуждение

    Задержка и значения интервала используются, если кнопка сконфигурирована (a setContinuous: сообщение) для непрерывной отправки сообщения действия в целевой объект при отслеживании мыши.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setContinuous: (NSControl)

  • alternateTitle alternateTitle Свойство

    Заголовок, который выводит на экран кнопка, когда это находится в своем альтернативном состоянии.

    Объявление

    Swift

    var alternateTitle: String

    Objective C

    @property(copy) NSString *alternateTitle

    Обсуждение

    Это свойство содержит строку, появляющуюся на получателе, когда это находится в своем альтернативном состоянии или пустой строке, если получатель не выводит на экран альтернативный заголовок. По умолчанию альтернативным заголовком кнопки является «Кнопка».

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    attributedAlternateTitle
    – setButtonType:
    заголовок

  • attributedTitle attributedTitle Свойство

    Заголовок, который кнопка выводит на экран в ее нормальном состоянии как приписанная строка.

    Объявление

    Swift

    @NSCopying var attributedTitle: NSAttributedString

    Objective C

    @property(copy) NSAttributedString *attributedTitle

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    attributedAlternateTitle
    – setButtonType:

  • attributedAlternateTitle attributedAlternateTitle Свойство

    Заголовок, который выводит на экран кнопка, когда это находится в своем альтернативном состоянии как приписанная строка.

    Объявление

    Swift

    @NSCopying var attributedAlternateTitle: NSAttributedString

    Objective C

    @property(copy) NSAttributedString *attributedAlternateTitle

    Обсуждение

    Это свойство содержит строку, появляющуюся на получателе, когда это находится в своем альтернативном состоянии, как NSAttributedString, или пустая строка, если получатель не выводит на экран альтернативный заголовок. По умолчанию альтернативным заголовком кнопки является «Кнопка».

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    attributedTitle
    – setButtonType:

  • заголовок заголовок Свойство

    Заголовок вывел на экран на кнопке, когда это находится в своем нормальном состоянии.

    Объявление

    Swift

    var title: String

    Objective C

    @property(copy) NSString *title

    Обсуждение

    Это свойство содержит заголовок, выведенный на экран на получателе, когда это находится в своем нормальном состоянии или пустой строке, если кнопка не выводит на экран заголовок. Если кнопка не использует свое альтернативное содержание для выделения или отображения альтернативного состояния, этот заголовок всегда выводится на экран. По умолчанию заголовком кнопки является «Кнопка». Установка значения этого свойства перерисовывает содержание кнопки, при необходимости.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    alternateTitle
    – setButtonType:
    – setTitleWithMnemonic:

  • setTitleWithMnemonic: - setTitleWithMnemonic: (OS X v10.8)

    Устанавливает заголовок кнопки с символом, обозначающим ключ доступа.

    Объявление

    Objective C

    - (void)setTitleWithMnemonic:(NSString *)stringWithAmpersand

    Обсуждение

    Мнемоника не поддерживается в OS X.

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

    Objective C

    @import AppKit;

    Доступность

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

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

    См. также

    заголовок
    alternateTitle
    – setButtonType:
    – setFont: (NSButtonCell)

  • звук звук Свойство

    Звук это играется, когда пользователь нажимает кнопку.

    Объявление

    Swift

    var sound: NSSound?

    Objective C

    @property(strong) NSSound *sound

    Обсуждение

    Звук, представленный этим свойством, играется во время события mouseDown, такой как NSLeftMouseDown.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Конфигурирование изображений кнопки
  • изображение изображение Свойство

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

    Объявление

    Swift

    var image: NSImage?

    Objective C

    @property(strong) NSImage *image

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    alternateImage
    – setButtonType:

  • alternateImage alternateImage Свойство

    Изображение, появляющееся на кнопке, когда это находится в своем альтернативном состоянии.

    Объявление

    Swift

    var alternateImage: NSImage?

    Objective C

    @property(strong) NSImage *alternateImage

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    изображение
    imagePosition
    keyEquivalent
    – setButtonType:

  • imagePosition imagePosition Свойство

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

    Объявление

    Swift

    var imagePosition: NSCellImagePosition

    Objective C

    @property NSCellImagePosition imagePosition

    Обсуждение

    Если заголовок выше, ниже, или наложение изображения, или если нет никакого изображения, текст горизонтально центрируется в кнопке. Значение этого свойства является одной из позиций изображения, описанных в разделе Constants NSCell.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setButtonType:
    изображение
    заголовок

  • ограниченный ограниченный Свойство

    Булево значение, определяющее, имеет ли кнопка границу.

    Объявление

    Swift

    var bordered: Bool

    Objective C

    @property(getter=isBordered) BOOL bordered

    Обсуждение

    Значение этого свойства YEStrue если получатель имеет границу, NOfalse иначе. Граница кнопки не является одной строкой границ большинства других средств управления — вместо этого, это - повышенная внешняя панель. По умолчанию кнопки ограничены. Если ограниченное состояние кнопки изменяется, оно перерисовывается.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • прозрачный прозрачный Свойство

    Булево значение, указывающее, прозрачна ли кнопка.

    Объявление

    Swift

    var transparent: Bool

    Objective C

    @property(getter=isTransparent) BOOL transparent

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • bezelStyle bezelStyle Свойство

    Появление границы получателя.

    Объявление

    Swift

    var bezelStyle: NSBezelStyle

    Objective C

    @property NSBezelStyle bezelStyle

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

    Стиль внешней панели кнопки. Посмотрите раздел Constants NSButtonCell для списка возможных значений.

    Обратите внимание на то, что, если кнопка не ограничена, стиль внешней панели проигнорирован.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • showsBorderOnlyWhileMouseInside showsBorderOnlyWhileMouseInside Свойство

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

    Объявление

    Swift

    var showsBorderOnlyWhileMouseInside: Bool

    Objective C

    @property BOOL showsBorderOnlyWhileMouseInside

    Обсуждение

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

    Если bordered NOfalse, граница никогда не выводится на экран, независимо от значения showsBorderOnlyWhileMouseInside.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Управление состоянием кнопки
  • allowsMixedState allowsMixedState Свойство

    Булево значение, указывающее, позволяет ли кнопка смешанное состояние.

    Объявление

    Swift

    var allowsMixedState: Bool

    Objective C

    @property BOOL allowsMixedState

    Обсуждение

    Значение этого свойства YEStrue если получатель имеет три состояния (на, прочь, и смешанный) или NOfalse если получатель имеет два состояния (на и прочь). Значение по умолчанию NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setNextState

  • состояние состояние Свойство

    Состояние получателя.

    Объявление

    Swift

    var state: Int

    Objective C

    @property NSInteger state

    Обсуждение

    Значение этого свойства представляет состояние кнопки. Кнопка может иметь два или три состояния. Если это имеет два, это значение также NSOffState (нормальное или ненажатое состояние) или NSOnState (альтернативное или нажатое состояние). Если это имеет три, это значение может быть NSOnState (функция имеет силу везде), NSOffState (функция не имеет силу нигде), или NSMixedState (функция имеет силу где-нибудь). Обратите внимание на то, что, если кнопка имеет только два состояния, и Вы устанавливаете значение state к NSMixedState, состояние кнопки становится NSOnState. Установка этого свойства перерисовывает кнопку, при необходимости.

    Несмотря на то, что использование перечислимых констант предпочтено, можно также установить state к целочисленному значению. Если кнопка имеет два состояния, 0 обрабатывается как NSOffState, и ненулевое значение обрабатывается как NSOnState. Если кнопка имеет три состояния, 0 обрабатывается как NSOffState; отрицательная величина, как NSMixedState; и положительное значение, как NSOnState.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • setNextState () - setNextState

    Устанавливает получатель в его следующее состояние.

    Объявление

    Swift

    func setNextState()

    Objective C

    - (void)setNextState

    Обсуждение

    Если кнопка имеет три состояния, она циклически повторяется через них в этом порядке: на, прочь, смешанный, на, и т.д. Если кнопка имеет два состояния, она переключается между ними.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    allowsMixedState

  • выделитесь (_:) - выделение:

    Выделения (или невыделения) получатель.

    Объявление

    Swift

    func highlight(_ flag: Bool)

    Objective C

    - (void)highlight:(BOOL)flag

    Параметры

    flag

    YEStrue выделить кнопку; NOfalse не выделить кнопку. Если текущее состояние соответствий кнопки flag, никакие меры не приняты.

    Обсуждение

    Выделение может включить кнопку, кажущуюся “продвинутым в” на экран, выведя на экран его альтернативный заголовок или изображение, или заставив кнопку, казаться, быть «освещенным».

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setButtonType:

Доступ к ключевым эквивалентам
  • keyEquivalent keyEquivalent Свойство

    Ключевой эквивалентный символ получателя.

    Объявление

    Swift

    var keyEquivalent: String

    Objective C

    @property(copy) NSString *keyEquivalent

    Обсуждение

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

    Если Вы устанавливаете ключ, эквивалентный вместо изображения, внутренняя часть кнопки перерисовывается. Если позиция изображения установлена в, Однако ключевой эквивалент не выведен на экран NSNoImage, NSImageOnly, или NSImageOverlaps; т.е. кнопка должна вывести на экран и свой заголовок и свое «изображение» (который является ключевым эквивалентом в этом случае), и они не должны накладываться.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – performKeyEquivalent:
    – keyEquivalentFont (NSButtonCell)

  • keyEquivalentModifierMask keyEquivalentModifierMask Свойство

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

    Объявление

    Swift

    var keyEquivalentModifierMask: Int

    Objective C

    @property NSUInteger keyEquivalentModifierMask

    Обсуждение

    Это свойство содержит маску, указывающую модифицирующие клавиши, применяющиеся к ключевому эквиваленту кнопки. Биты маски определяются во Флагах Модификатора. Единственные биты маски, релевантные в кнопке ключевые эквивалентные маски модификатора, NSControlKeyMask, NSAlternateKeyMask, и NSCommandKeyMask.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    keyEquivalent

Обработка событий клавиатуры
  • performKeyEquivalent (_:) - performKeyEquivalent:

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

    Объявление

    Swift

    func performKeyEquivalent(_ anEvent: NSEvent) -> Bool

    Objective C

    - (BOOL)performKeyEquivalent:(NSEvent *)anEvent

    Параметры

    anEvent

    Событие, содержащее ключевой эквивалент.

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

    YEStrue если ключевой эквивалент в anEvent соответствует ключевой эквивалент кнопки; NOfalse если это не делает. Этот метод также возвращается NOfalse если он, получатель блокируется модальной панелью или кнопкой, отключен.

    Обсуждение

    Если символ в anEvent соответствует ключевой эквивалент получателя, и флаги модификатора в anEvent соответствуйте ключевую эквивалентную маску модификатора, performKeyEquivalent: моделирует пользователя, нажимающего кнопку и возврат YEStrue. Иначе, performKeyEquivalent: не делает ничего и возвратов NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    keyEquivalent
    keyEquivalentModifierMask