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

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

Разработчик

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

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

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

NSAppearance

NSAppearance объект представляет файл, указывающий стандартное или пользовательское появление, применяющееся к подмножеству элементов UI в приложении. Приложение может содержать многократные файлы появления и — потому что NSAppearance соответствует NSCoding— можно использовать Интерфейсного Разработчика для присвоения элементов UI появлению.

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

Если искусство для определенного представления не может быть найдено, AppKit ищет искусство в появлениях наследователей представления. A nil появление означает, что представление использует появление Воды по умолчанию; не -nil появление означает, что представление использует появление наследователя.

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

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

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Создавание видимости
  • init (appearanceNamed:bundle:) - initWithAppearanceNamed:bundle:

    Создает NSAppearance объект, инициализированный к указанному файлу появления в указанном пакете.

    Объявление

    Swift

    init?(appearanceNamed name: String, bundle bundle: NSBundle?)

    Objective C

    - (instancetype)initWithAppearanceNamed:(NSString *)name bundle:(NSBundle *)bundle

    Параметры

    name

    Имя файла появления для поиска, без любой информации о пути.

    bundle

    Пакет, в котором можно искать файл появления. Если bundle nil, этот метод ищет в основном пакете.

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

    Инициализированный объект появления, или nil если происходит ошибка.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Получение появления
  • init (названный:) + appearanceNamed:

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

    Объявление

    Swift

    init?(named name: String) -> NSAppearance

    Objective C

    + (NSAppearance *)appearanceNamed:(NSString *)name

    Параметры

    name

    Имя стандартного или пользовательского появления. Посмотрите “Standard Appearances” для стандартных имен появления.

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

    Стандартный или пользовательский объект появления.

    Обсуждение

    Когда Вы указываете стандартное имя появления — такой как NSAppearanceNameAqua— этот метод возвращает встроенное появление. При указании пользовательского имени появления этот метод ищет основной пакет файл появления, имеющий указанное имя.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Получение и установка текущего появления
  • currentAppearance () + currentAppearance

    Возвраты NSAppearance объект это установлено на текущем потоке.

    Объявление

    Swift

    class func currentAppearance() -> NSAppearance

    Objective C

    + (NSAppearance *)currentAppearance

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

    Объект появления это установлено на текущем потоке.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • setCurrentAppearance (_:) + setCurrentAppearance:

    Устанавливает текущее появление в указанное NSAppearance объект.

    Объявление

    Swift

    class func setCurrentAppearance(_ appearance: NSAppearance?)

    Objective C

    + (void)setCurrentAppearance:(NSAppearance *)appearance

    Параметры

    appearance

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

    Обсуждение

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

    Можно использовать этот метод для установки текущего появления для внеэкранного представления к появлению, которое будет использоваться, когда будет нарисовано представление. Чтобы сделать это, используйте внеэкранное представление effectiveAppearance для appearance параметр.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Управление вибрацией
  • allowsVibrancy allowsVibrancy Свойство

    Указывает, позволяет ли текущее появление вибрацию.

    Объявление

    Swift

    var allowsVibrancy: Bool { get }

    Objective C

    @property(readonly) BOOL allowsVibrancy

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Константы
  • Стандартные появления

    Эти строки используются для указания стандартных появлений, предоставленных OS X.

    Объявление

    Swift

    let NSAppearanceNameAqua: NSString! let NSAppearanceNameLightContent: NSString! let NSAppearanceNameVibrantDark: NSString! let NSAppearanceNameVibrantLight: NSString!

    Objective C

    APPKIT_EXTERN NSString *const NSAppearanceNameAqua; APPKIT_EXTERN NSString *const NSAppearanceNameLightContent; APPKIT_EXTERN NSString *const NSAppearanceNameVibrantDark; APPKIT_EXTERN NSString *const NSAppearanceNameVibrantLight;

    Константы

    • NSAppearanceNameAqua

      NSAppearanceNameAqua

      Стандартное появление Воды.

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

    • NSAppearanceNameLightContent

      NSAppearanceNameLightContent

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

      В OS X v10.10 и позже, легкое содержание должно использовать появление Воды по умолчанию.

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

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

    • NSAppearanceNameVibrantDark

      NSAppearanceNameVibrantDark

      Вибрирующее появление для темного содержания.

      Это должно только быть установлено на NSVisualEffectView или одно из его подпредставлений.

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

    • NSAppearanceNameVibrantLight

      NSAppearanceNameVibrantLight

      Вибрирующее появление для легкого содержания.

      Это должно только быть установлено на NSVisualEffectView или одно из его подпредставлений.

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