NSBox

NSBox класс реализует простые представления, могущие заголовок сами и рисовать границу вокруг их содержания. Эти объекты известны как поля. Можно использовать поле для группировки, визуально, некоторого числа других представлений.

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

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

Методы для переопределения

Необходимо переопределить drawRect: метод (наследованный от NSView) если Вы хотите настроить появление Вашего NSBox объекты. В зависимости от визуального эффекта Вы пытаетесь достигнуть, Вам, вероятно, придется вызвать superреализация сначала. Например, при составлении композита маленького изображения в углу поля Вы вызвали бы реализацию суперкласса сначала. Если бы Вы добавляете новый стиль строки, Вы обеспечили бы способ сохранить запрос на этот тип строки (такой как булева переменная экземпляра и связанные методы доступа). Затем в drawRect:, если бы запрос на этот тип строки существует, Вы нарисовали бы все представление сами (т.е. без вызова super). Иначе, Вы вызвали бы реализацию суперкласса.

Если Вы хотите изменить группирующееся поведение или другие поведенческие характеристики NSBox класс, рассмотрите переопределение setContentView:, sizeToFit, или addSubview: (наследованный от NSView).

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

Если Вы рисуете пользовательское NSBox полностью собой, и Вы хотите, чтобы он точно походил на суперобъект класса (за исключением Ваших изменений), может потребоваться некоторое усилие и время для разбираний в подробных данных.

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

NSObject
NSResponder
NSView
NSBox

NSObject
NSResponder
NSView
NSBox

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Конфигурирование полей

borderRect - borderRect

Возвращает прямоугольник, в котором нарисована граница получателя.

Объявление

Swift

var borderRect: NSRect { get }

Objective C

@property(readonly) NSRect borderRect

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

Прямоугольник тот, в который граница NSBox нарисован.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Возвращает тип поля получателя.

Объявление

Swift

var boxType: NSBoxType

Objective C

@property NSBoxType boxType

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

Постоянное описание типа поля. Эти константы описаны в NSBoxType. По умолчанию, тип поля NSBox NSBoxPrimary.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setBoxType:


    
    setBoxType:
    - setBoxType:

Устанавливает тип поля.

Объявление

Swift

var boxType: NSBoxType

Objective C

@property NSBoxType boxType

Параметры


      boxType

Постоянное описание типа поля; это должно быть допустимым типом поля. Эти константы описаны в NSBoxType.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– boxType

borderType - borderType

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

Объявление

Swift

var borderType: NSBorderType

Objective C

@property NSBorderType borderType

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

Постоянное описание типа границы. Типы границы определяются в NSView.h. В настоящее время следующие типы границы определяются: NSNoBorder,NSLineBorder,NSBezelBorder, NSGrooveBorder.
По умолчанию, тип границы NSBox NSGrooveBorder.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setBorderType:


    
    setBorderType:
    - setBorderType:

Устанавливает тип границы в aType, который должен быть допустимым типом границы.

Объявление

Swift

var borderType: NSBorderType

Objective C

@property NSBorderType borderType

Параметры


      aType

Постоянное описание типа границы. Типы границы определяются в NSView.h. В настоящее время следующие типы границы определяются: NSNoBorder,NSLineBorder,NSBezelBorder, NSGrooveBorder.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– borderType
– setNeedsDisplay: (NSView)

isTransparent - isTransparent Доступный в OS X v10.5 через OS X v10.9

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

Объявление

Objective C

- (BOOL)isTransparent

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

YEStrue когда получатель прозрачен, NOfalse иначе.

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

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.5 через OS X v10.9.

См. также

– setTransparent:


    
    setTransparent:
    - setTransparent:

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

Объявление

Swift

var transparent: Bool

Objective C

@property(getter=isTransparent) BOOL transparent

Параметры


      transparent

YEStrue делает получатель прозрачным.

NOfalse делает получатель непрозрачным.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– isTransparent

заголовок - заголовок

Возвращает заголовок получателя.

Объявление

Swift

var title: String

Objective C

@property(copy) NSString *title

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

Заголовок NSBox. По умолчанию заголовком поля является «Заголовок».

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setTitle:


    
    setTitle:
    - setTitle:

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

Объявление

Swift

var title: String

Objective C

@property(copy) NSString *title

Параметры


      aString

Новый заголовок NSBox. Заголовок по умолчанию NSBox «Заголовок». Если размер нового заголовка отличается от того из старого заголовка, довольное, представление изменено для поглощения различия.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– заголовок
– titleRect
– setNeedsDisplayInRect: (NSView)

titleFont - titleFont

Возвращается объект шрифта раньше составлял заголовок получателя.

Объявление

Swift

var titleFont: NSFont

Objective C

@property(strong) NSFont *titleFont

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

NSFont объект раньше составлял заголовок.

Обсуждение

По умолчанию заголовок составлен с помощью маленького системного шрифта (полученное использование (smallSystemFontSize как параметр systemFontOfSize:, оба NSFont методы класса).

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setTitleFont:
setTitleFont: - setTitleFont:

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

Объявление

Swift

var titleFont: NSFont

Objective C

@property(strong) NSFont *titleFont

Параметры

aFont

NSFont объект раньше составлял заголовок поля.

Обсуждение

По умолчанию заголовок составлен с помощью маленького системного шрифта (полученное использование (smallSystemFontSize как параметр systemFontOfSize:, оба NSFont методы класса). Если размер нового шрифта отличается от того из старого шрифта, довольное, представление изменено для поглощения различия.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– titleFont
– setNeedsDisplayInRect: (NSView)
titlePosition - titlePosition

Возвращает постоянное представление позиции заголовка.

Объявление

Swift

var titlePosition: NSTitlePosition

Objective C

@property NSTitlePosition titlePosition

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setTitlePosition:


    
    setTitlePosition:
    - setTitlePosition:

Устанавливает позицию заголовка поля.

Объявление

Swift

var titlePosition: NSTitlePosition

Objective C

@property NSTitlePosition titlePosition

Параметры


      aPosition

Постоянное описание позиции заголовка поля. Эти константы описаны в NSTitlePosition. Позиция по умолчанию NSAtTop.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– titlePosition
– setNeedsDisplay: (NSView)

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.

См. также

– setTitleWithMnemonic: (NSCell)
titleCell - titleCell

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

Объявление

Swift

var titleCell: AnyObject { get }

Objective C

@property(readonly, strong) id titleCell

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

NSCell объект раньше выводил на экран заголовок.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

var titleRect: NSRect { get }

Objective C

@property(readonly) NSRect titleRect

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

Прямоугольник, в котором составлен заголовок.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setTitlePosition:
– setTitle:
– setTitleFont:
– setFrameFromContentFrame:
– sizeToFit

Настройка

borderColor - borderColor

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

Объявление

Swift

@NSCopying var borderColor: NSColor

Objective C

@property(copy) NSColor *borderColor

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

Цвет рамки получателя. Это должно быть пользовательское поле — т.е. это имеет тип NSBoxCustom— и это должно иметь стиль границ NSLineBorder.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setBorderColor:
setBorderColor: - setBorderColor:

Указывает цвет рамки получателя.

Объявление

Swift

@NSCopying var borderColor: NSColor

Objective C

@property(copy) NSColor *borderColor

Параметры

borderColor

Цвет рамки для получателя.

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

Функциональный только, когда тип поля получателя (boxType) NSBoxCustom и его тип границы (borderType) NSLineBorder.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– borderColor
borderWidth - borderWidth

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

Объявление

Swift

var borderWidth: CGFloat

Objective C

@property CGFloat borderWidth

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

Ширина рамки получателя. Это должно быть пользовательское поле — т.е. это имеет тип NSBoxCustom— и это должно иметь стиль границ NSLineBorder.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setBorderWidth:
setBorderWidth: - setBorderWidth:

Указывает ширину рамки получателя.

Объявление

Swift

var borderWidth: CGFloat

Objective C

@property CGFloat borderWidth

Параметры

borderWidth

Ширина рамки для получателя.

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

Функциональный только, когда тип поля получателя (boxType) NSBoxCustom и его тип границы (borderType) NSLineBorder.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– borderWidth
cornerRadius - cornerRadius

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

Объявление

Swift

var cornerRadius: CGFloat

Objective C

@property CGFloat cornerRadius

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

Угловой радиус получателя. Это должно быть пользовательское поле — т.е. это имеет тип NSBoxCustom— и это должно иметь стиль границ NSLineBorder.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setCornerRadius:
setCornerRadius: - setCornerRadius:

Указывает угловой радиус получателя.

Объявление

Swift

var cornerRadius: CGFloat

Objective C

@property CGFloat cornerRadius

Параметры

cornerRadius

Угловой радиус для получателя.

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

Функциональный только, когда тип поля получателя (boxType) NSBoxCustom и его тип границы (borderType) NSLineBorder.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– cornerRadius
цвет заливки - цвет заливки

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

Объявление

Swift

@NSCopying var fillColor: NSColor

Objective C

@property(copy) NSColor *fillColor

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

Цвет заливки получателя. Это должно быть пользовательское поле — т.е. это имеет тип NSBoxCustom— и это должно иметь стиль границ NSLineBorder.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setFillColor:
setFillColor: - setFillColor:

Указывает цвет заливки получателя.

Объявление

Swift

@NSCopying var fillColor: NSColor

Objective C

@property(copy) NSColor *fillColor

Параметры

fillColor

Цвет заливки для получателя.

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

Функциональный только, когда тип поля получателя (boxType) NSBoxCustom и его тип границы (borderType) NSLineBorder.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– цвет заливки

Управление содержанием

contentView - contentView

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

Объявление

Swift

unowned(unsafe) var contentView: AnyObject?

Objective C

@property(assign) id contentView

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

Представление содержания NSBox объект. Довольное представление создается автоматически, когда поле создано и изменено как поле, изменено (Вы никогда не должны отправлять изменяющие кадр сообщения непосредственно в представление содержания поля). Можно заменить его NSView собственный через setContentView: метод.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setContentView:


    
    setContentView:
    - setContentView:

Устанавливает представление содержания получателя.

Объявление

Swift

unowned(unsafe) var contentView: AnyObject?

Objective C

@property(assign) id contentView

Параметры


      aView

Новое довольное представление. NSView объект изменен для адаптации в текущей предметной области поля, и поле отмечено для, восстанавливают изображение.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– contentView
– setFrameFromContentFrame:
– sizeToFit
– setNeedsDisplay: (NSView)

contentViewMargins - contentViewMargins

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

Объявление

Swift

var contentViewMargins: NSSize

Objective C

@property NSSize contentViewMargins

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

Ширина (горизонтальное расстояние между самым внутренним краем границы и довольным представление) и высота (вертикальное расстояние между самым внутренним краем границы и довольным представление) описание расстояния между границей и довольным представление. По умолчанию это оба 5.0 в системе координат поля.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setContentViewMargins:


    
    setContentViewMargins:
    - setContentViewMargins:

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

Объявление

Swift

var contentViewMargins: NSSize

Objective C

@property NSSize contentViewMargins

Параметры


      offsetSize

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– contentViewMargins

Калибровка


    
    setFrameFromContentFrame (_:)
    - setFrameFromContentFrame:

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

Объявление

Swift

func setFrameFromContentFrame(_ contentFrame: NSRect)

Objective C

- (void)setFrameFromContentFrame:(NSRect)contentFrame

Параметры


      contentFrame

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setContentViewMargins:
– setFrame: (NSView)
– setNeedsDisplay: (NSView)

sizeToFit () - sizeToFit
Изменяет размеры и перемещает представление содержания получателя, таким образом, оно просто включает свои подпредставления.

Объявление

Swift

func sizeToFit()

Objective C

- (void)sizeToFit
Обсуждение

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

Необходимо вызвать этот метод после:
- Добавление подпредставления (к довольному представление)
- Изменение размера или расположения такого подпредставления
- Установка полей вокруг довольного представление
Механизм, которым довольное представление перемещено и изменено, зависит от того, отвечает ли объект на свое собственное sizeToFit сообщение: Если это действительно отвечает, то то сообщение отправляется, и довольное, представление, как ожидают, будет так изменено. если довольное и изменяет размеры довольного само представление, представление не отвечает, поле перемещает
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Типы данных

NSTitlePosition NSTitlePosition
Укажите расположение заголовка поля относительно его границы.

Объявление

Swift

enum NSTitlePosition : UInt { case NoTitle case AboveTop case AtTop case BelowTop case AboveBottom case AtBottom case BelowBottom }

Objective C

typedef enum _NSTitlePosition { NSNoTitle = 0, NSAboveTop = 1, NSAtTop = 2, NSBelowTop = 3, NSAboveBottom = 4, NSAtBottom = 5, NSBelowBottom = 6 } NSTitlePosition;

Константы
- NoTitle
  
  NSNoTitle
  
  Поле не имеет никакого заголовка.
  
  Доступный в OS X v10.0 и позже.
- AboveTop
  
  NSAboveTop
  
  Заголовок расположен выше верхней границы поля.
  
  Доступный в OS X v10.0 и позже.
- AtTop
  
  NSAtTop
  
  Заголовок расположен в верхней границе поля.
  
  Доступный в OS X v10.0 и позже.
- BelowTop
  
  NSBelowTop
  
  Заголовок расположен ниже верхней границы поля.
  
  Доступный в OS X v10.0 и позже.
- AboveBottom
  
  NSAboveBottom
  
  Заголовок расположен выше нижней границы поля.
  
  Доступный в OS X v10.0 и позже.
- AtBottom
  
  NSAtBottom
  
  Заголовок расположен в нижней границе поля.
  
  Доступный в OS X v10.0 и позже.
- BelowBottom
  
  NSBelowBottom
  
  Заголовок расположен ниже нижней границы поля.
  
  Доступный в OS X v10.0 и позже.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
NSBoxType NSBoxType
Эти константы и тип данных идентифицируют типы поля, в сочетании с типом границы поля, определяющие появление поля.

Объявление

Swift

enum NSBoxType : UInt { case Primary case Secondary case Separator case OldStyle case Custom }

Objective C

enum { NSBoxPrimary = 0, NSBoxSecondary = 1, NSBoxSeparator = 2, NSBoxOldStyle = 3, NSBoxCustom = 4 }; typedef NSUInteger NSBoxType;

Константы
- Primary
  
  NSBoxPrimary
  
  Указывает основное появление поля. Это - тип поля по умолчанию.
  
  Доступный в OS X v10.0 и позже.
- Secondary
  
  NSBoxSecondary
  
  Указывает вторичное появление поля.
  
  Доступный в OS X v10.0 и позже.
- Separator
  
  NSBoxSeparator
  
  Указывает, что поле является разделителем.
  
  Доступный в OS X v10.0 и позже.
- OldStyle
  
  NSBoxOldStyle
  
  Указывает, что поле является полем v10.2-стиля OS X.
  
  Доступный в OS X v10.0 и позже.
- Custom
  
  NSBoxCustom
  
  Указывает, что появление поля определяется полностью кстати методы конфигурации поля, автоматически не применяя инструкции по интерфейсу пользователя Apple. Посмотрите “Customizing” для подробных данных.
  
  Доступный в OS X v10.5 и позже.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

NSBox

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

Методы для переопределения

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

Конфигурирование полей

Объявление

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

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

Доступность

Объявление

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

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

Доступность

См. также

Объявление

Параметры

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

Доступность

См. также

Объявление

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

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

Доступность

См. также

Объявление

Параметры

Обсуждение

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

Доступность

См. также

Объявление

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

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

Доступность

См. также

Объявление

Параметры

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

Доступность

См. также

Объявление

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

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

Доступность

См. также

Объявление

Параметры

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

Доступность

См. также

Объявление

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

Обсуждение

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

Доступность

См. также

Объявление

Параметры

Обсуждение

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

Доступность

См. также

Объявление

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

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

Доступность

См. также

Объявление

Параметры

Обсуждение

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

Доступность

См. также

Объявление

Обсуждение

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

Доступность

См. также

Объявление

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