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

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

Разработчик

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

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

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

NSSegmentedControl

NSSegmentedControl возразите реализует горизонтальную кнопку, сделанную из многократных сегментов.

NSSegmentedControl класс использует NSSegmentedCell класс для реализации большой части функциональности управления. Большинство методов в NSSegmentedControl просто “методы покрытия”, призывающие соответствующий метод NSSegmentedCell. Методы NSSegmentedCell это не имеет покрытий, касаются доступа и установки значений для тегов и подсказок; программно устанавливая ключевой сегмент; и установление режима управления.

Функции сегментированного управления включают:

  • Каждый сегмент может иметь изображение, текст (метка), меню, подсказка и тег

  • Или целое управление или отдельные сегменты могут быть включены или отключены

  • Существует три режима отслеживания для сегментов: выберите один режим (также известный как режим переключателя и проиллюстрированный управлением селекцией мод представления Средства поиска), мгновенный режим (как проиллюстрировано кнопками на панели инструментов Safari), или выберите любой режим (где любая комбинация кнопок может идти или прочь),

  • Каждый сегмент может быть или фиксированной шириной или автоизмеренный для адаптации содержанию

  • Если сегмент имеет текст и отмечен как автокалибровка, то текст может быть усеченным так, чтобы полностью соответствовало управление

  • Если изображение является слишком большим для помещений в сегмент, оно отсекается

  • Полное управление клавиатурой пользовательского интерфейса

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

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Указание числа сегментов
  • segmentCount segmentCount Свойство

    Число сегментов в получателе.

    Объявление

    Swift

    var segmentCount: Int

    Objective C

    @property NSInteger segmentCount

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Указание выбранного сегмента
  • selectedSegment selectedSegment Свойство

    Индекс выбранного сегмента получателя или -1 если не выбран никакой сегмент.

    Объявление

    Swift

    var selectedSegment: Int

    Objective C

    @property NSInteger selectedSegment

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setSelected:forSegment:

  • selectSegmentWithTag (_:) - selectSegmentWithTag:

    Выбирает сегмент с указанным тегом.

    Объявление

    Swift

    func selectSegmentWithTag(_ tag: Int) -> Bool

    Objective C

    - (BOOL)selectSegmentWithTag:(NSInteger)tag

    Параметры

    tag

    Тег связался с желаемым сегментом.

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

    YEStrue если сегмент был выбран успешно; иначе, NOfalse.

    Обсуждение

    Как правило, Вы используете Интерфейсного Разработчика для указания тега для каждого сегмента. Можно также установить это значение программно с помощью setTag:forSegment: метод NSSegmentedCell.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    setTag:forSegment: (NSSegmentedCell)

Работа с отдельными сегментами
  • setWidth (_: forSegment:) - setWidth:forSegment:

    Устанавливает ширину указанного сегмента.

    Объявление

    Swift

    func setWidth(_ width: CGFloat, forSegment segment: Int)

    Objective C

    - (void)setWidth:(CGFloat)width forSegment:(NSInteger)segment

    Параметры

    width

    Ширина сегмента, измеренного в точках. Укажите значение 0 если Вы хотите, чтобы сегмент был измерен для адаптации свободному месту автоматически.

    segment

    Индекс сегмента, ширину которого Вы хотите установить. Этот метод повышает NSRangeException если индекс выходит за пределы.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – widthForSegment:

  • widthForSegment (_:) - widthForSegment:

    Возвращает ширину указанного сегмента.

    Объявление

    Swift

    func widthForSegment(_ segment: Int) -> CGFloat

    Objective C

    - (CGFloat)widthForSegment:(NSInteger)segment

    Параметры

    segment

    Индекс сегмента, ширину которого Вы хотите получить. Этот метод повышает NSRangeException если индекс выходит за пределы.

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

    Ширина сегмента, измеренного в точках, или 0, если сегмент измерен для адаптации свободному месту автоматически.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setWidth:forSegment:

  • setImage (_: forSegment:) - setImage:forSegment:

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

    Объявление

    Swift

    func setImage(_ image: NSImage?, forSegment segment: Int)

    Objective C

    - (void)setImage:(NSImage *)image forSegment:(NSInteger)segment

    Параметры

    image

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

    segment

    Индекс сегмента, изображение которого Вы хотите установить. Этот метод повышает NSRangeException если индекс выходит за пределы.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – imageForSegment:

  • imageForSegment (_:) - imageForSegment:

    Возвращает изображение, связанное с указанным сегментом.

    Объявление

    Swift

    func imageForSegment(_ segment: Int) -> NSImage?

    Objective C

    - (NSImage *)imageForSegment:(NSInteger)segment

    Параметры

    segment

    Индекс сегмента, изображение которого Вы хотите получить. Этот метод повышает NSRangeException если индекс выходит за пределы.

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

    Изображение связалось с сегментом; иначе, nil.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setImage:forSegment:

  • setLabel (_: forSegment:) - setLabel:forSegment:

    Устанавливает метку для указанного сегмента.

    Объявление

    Swift

    func setLabel(_ label: String, forSegment segment: Int)

    Objective C

    - (void)setLabel:(NSString *)label forSegment:(NSInteger)segment

    Параметры

    label

    Метка Вы хотите вывести на экран в сегменте. Если ширина строки больше, чем ширина сегмента, текст строки является усеченным во время получения.

    segment

    Индекс сегмента, метку которого Вы хотите установить. Этот метод повышает NSRangeException если индекс выходит за пределы.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – labelForSegment:

  • labelForSegment (_:) - labelForSegment:

    Возвращает метку указанного сегмента

    Объявление

    Swift

    func labelForSegment(_ segment: Int) -> String?

    Objective C

    - (NSString *)labelForSegment:(NSInteger)segment

    Параметры

    segment

    Индекс сегмента, метку которого Вы хотите получить. Этот метод повышает NSRangeException если индекс выходит за пределы.

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setLabel:forSegment:

  • setMenu (_: forSegment:) - setMenu:forSegment:

    Устанавливает меню для указанного сегмента.

    Объявление

    Swift

    func setMenu(_ menu: NSMenu?, forSegment segment: Int)

    Objective C

    - (void)setMenu:(NSMenu *)menu forSegment:(NSInteger)segment

    Параметры

    menu

    Меню Вы хотите добавить к сегменту или nil очистить текущее меню.

    segment

    Индекс сегмента, меню которого Вы хотите установить. Этот метод повышает NSRangeException если индекс выходит за пределы.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – menuForSegment:

  • menuForSegment (_:) - menuForSegment:

    Возвращает меню для указанного сегмента

    Объявление

    Swift

    func menuForSegment(_ segment: Int) -> NSMenu?

    Objective C

    - (NSMenu *)menuForSegment:(NSInteger)segment

    Параметры

    segment

    Индекс сегмента, меню которого Вы хотите получить. Этот метод повышает NSRangeException если индекс выходит за пределы.

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

    Меню связалось с сегментом; иначе, nil.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setMenu:forSegment:

  • setSelected (_: forSegment:) - setSelected:forSegment:

    Устанавливает состояние выбора указанного сегмента.

    Объявление

    Swift

    func setSelected(_ flag: Bool, forSegment segment: Int)

    Objective C

    - (void)setSelected:(BOOL)flag forSegment:(NSInteger)segment

    Параметры

    flag

    YEStrue если Вы хотите выбрать сегмент; иначе, NOfalse.

    segment

    Индекс сегмента, выбор которого утверждает Вас, хочет установить. Этот метод повышает NSRangeException если индекс выходит за пределы.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – isSelectedForSegment:

  • isSelectedForSegment (_:) - isSelectedForSegment:

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

    Объявление

    Swift

    func isSelectedForSegment(_ segment: Int) -> Bool

    Objective C

    - (BOOL)isSelectedForSegment:(NSInteger)segment

    Параметры

    segment

    Индекс сегмента, выбор которого утверждает Вас, хочет добраться. Этот метод повышает NSRangeException если индекс выходит за пределы.

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

    YEStrue если выбран сегмент; иначе, NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setSelected:forSegment:

  • setEnabled (_: forSegment:) - setEnabled:forSegment:

    Устанавливает включенное состояние указанного сегмента

    Объявление

    Swift

    func setEnabled(_ flag: Bool, forSegment segment: Int)

    Objective C

    - (void)setEnabled:(BOOL)flag forSegment:(NSInteger)segment

    Параметры

    flag

    YEStrue включить сегмент; иначе, NOfalse отключить его.

    segment

    Индекс сегмента Вы хотите включить или отключить. Этот метод повышает NSRangeException если индекс выходит за пределы.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – isEnabledForSegment:

  • isEnabledForSegment (_:) - isEnabledForSegment:

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

    Объявление

    Swift

    func isEnabledForSegment(_ segment: Int) -> Bool

    Objective C

    - (BOOL)isEnabledForSegment:(NSInteger)segment

    Параметры

    segment

    Индекс сегмента, чей включенный состояние Вы хотите добраться. Этот метод повышает NSRangeException если индекс выходит за пределы.

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

    YEStrue если включен сегмент; иначе, NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setEnabled:forSegment:

Указание дисплея сегмента
  • segmentStyle segmentStyle Свойство

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

    Объявление

    Swift

    var segmentStyle: NSSegmentStyle

    Objective C

    @property NSSegmentStyle segmentStyle

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • setImageScaling (_: forSegment:) - setImageScaling:forSegment:

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

    Объявление

    Swift

    func setImageScaling(_ scaling: NSImageScaling, forSegment segment: Int)

    Objective C

    - (void)setImageScaling:(NSImageScaling)scaling forSegment:(NSInteger)segment

    Параметры

    scaling

    Одна из констант масштабирования изображения. Для списка возможных значений посмотрите NSImageScaling.

    segment

    Индекс сегмента, чей включенный состояние Вы хотите добраться. Этот метод повышает NSRangeException если индекс выходит за пределы.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – imageForSegment:

  • imageScalingForSegment (_:) - imageScalingForSegment:

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

    Объявление

    Swift

    func imageScalingForSegment(_ segment: Int) -> NSImageScaling

    Objective C

    - (NSImageScaling)imageScalingForSegment:(NSInteger)segment

    Параметры

    segment

    Индекс сегмента, чей включенный состояние Вы хотите добраться. Этот метод повышает NSRangeException если индекс выходит за пределы.

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

    Одна из констант масштабирования изображения. Для списка возможных значений посмотрите NSImageScaling. Значение по умолчанию NSImageScaleProportionallyDown.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setImageScaling:forSegment:

Константы
  • NSSegmentStyle

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

    Объявление

    Swift

    enum NSSegmentStyle : Int { case Automatic case Rounded case RoundRect case TexturedSquare case SmallSquare case Separated case TexturedRounded case Capsule }

    Objective C

    enum { NSSegmentStyleAutomatic = 0, NSSegmentStyleRounded = 1, NSSegmentStyleTexturedRounded = 2, NSSegmentStyleRoundRect = 3, NSSegmentStyleTexturedSquare = 4, NSSegmentStyleCapsule = 5, NSSegmentStyleSmallSquare = 6, NSSegmentStyleSeparated = 8, }; typedef NSInteger NSSegmentStyle;

    Константы

    • Automatic

      NSSegmentStyleAutomatic

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

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

    • Rounded

      NSSegmentStyleRounded

      Управление выведено на экран с помощью округленного стиля.

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

    • TexturedRounded

      NSSegmentStyleTexturedRounded

      Управление выведено на экран с помощью текстурированного округленного стиля. В OS X v10.7 и позже, этот стиль использует иллюстрации, определенные для NSSegmentStyleTexturedSquare, таким образом, необходимо указать NSSegmentStyleTexturedSquare вместо этого.

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

    • RoundRect

      NSSegmentStyleRoundRect

      Управление выведено на экран с помощью раунда rect стиль.

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

    • TexturedSquare

      NSSegmentStyleTexturedSquare

      Управление выведено на экран с помощью текстурированного квадратного стиля.

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

    • Capsule

      NSSegmentStyleCapsule

      Управление выведено на экран с помощью краткого стиля. В OS X v10.7 и позже, этот стиль использует иллюстрации, определенные для NSSegmentStyleTexturedSquare, таким образом, необходимо указать NSSegmentStyleTexturedSquare вместо этого.

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

    • SmallSquare

      NSSegmentStyleSmallSquare

      Управление выведено на экран с помощью стиля небольшого квадрата.

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

    • Separated

      NSSegmentStyleSeparated

      Сегменты в управлении выведены на экран очень друг близко к другу, но не касанию. Например, Safari в OS X v10.10 и более позднее использование этот стиль для предыдущей и следующей страницы сегментировал управление.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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