NSForm

NSForm объект является вертикальной матрицей NSFormCell объекты реализовать поля.

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

NSObject
NSResponder
NSView
NSControl
NSMatrix
NSForm

NSObject
NSResponder
NSView
NSControl
NSMatrix
NSForm

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

Добавление и удаление записей

addEntry (_:) - addEntry: (OS X v10.10)

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

Объявление

Swift

func addEntry(_ title: String) -> NSFormCell

Objective C

- (NSFormCell *)addEntry:(NSString *)title

Параметры

title

Заголовок для новой записи формы.

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

Объект ячейки формы, создававшийся для записи.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– insertEntry:atIndex:
setEditable: (NSCell)
setTag: (NSActionCell)
setTarget: (NSActionCell)
setAction: (NSActionCell)
setEnabled: (NSCell)


    
    insertEntry (_: atIndex:)
    - insertEntry:atIndex:

(OS X v10.10)

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

Объявление

Swift

func insertEntry(_ title: String, atIndex entryIndex: Int) -> NSFormCell!

Objective C

- (NSFormCell *)insertEntry:(NSString *)title atIndex:(NSInteger)entryIndex

Параметры

`title`	Заголовок для новой записи формы.
`entryIndex`	Основанный на нуле индекс, в котором можно вставить запись.

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

Объект ячейки формы, создававшийся для записи.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

См. также

– addEntry:
– removeEntryAtIndex:

removeEntryAtIndex (_:) - removeEntryAtIndex: (OS X v10.10)

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

Объявление

Swift

func removeEntryAtIndex(_ entryIndex: Int)

Objective C

- (void)removeEntryAtIndex:(NSInteger)entryIndex

Параметры

entryIndex

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

Обсуждение

Если указанный индекс недопустим, этот метод ничего не делает.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

Изменение появления всех записей


    
    setBezeled (_:)
    - setBezeled:

(OS X v10.10)

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

Объявление

Swift

func setBezeled(_ flag: Bool)

Objective C

- (void)setBezeled:(BOOL)flag

Параметры


      flag

YEStrue вывести на экран внешнюю панель вокруг всех записей; иначе, NOfalse не показать внешнюю панель вокруг всех записей.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

См. также

– setBordered:
isBezeled (NSCell)


    
    setBordered (_:)
    - setBordered:

(OS X v10.10)

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

Объявление

Swift

func setBordered(_ flag: Bool)

Objective C

- (void)setBordered:(BOOL)flag

Параметры


      flag

YEStrue вывести на экран границу вокруг всех записей; иначе, NOfalse не показать границу вокруг всех записей.

Обсуждение

Граница нарисована как тонкая строка вокруг доступного для редактирования текстового поля. Запись может иметь границу или внешнюю панель, но не обоих.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

См. также

– setBezeled:
isBordered (NSCell)


    
    setEntryWidth (_:)
    - setEntryWidth:

(OS X v10.10)

Устанавливает ширину всех записей в получателе.

Объявление

Swift

func setEntryWidth(_ width: CGFloat)

Objective C

- (void)setEntryWidth:(CGFloat)width

Параметры


      width

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

setFrameSize (_:) - setFrameSize: (OS X v10.10)

Устанавливает размер типа телосложения получателя к указанному значению.

Объявление

Swift

func setFrameSize(_ newSize: NSSize)

Objective C

- (void)setFrameSize:(NSSize)newSize

Параметры

newSize

Новый размер формы.

Обсуждение

Ширина NSFormCell объекты всегда соответствуют ширину своего затрагивания NSForm объект. Ширина ячеек всегда изменяется для соответствия представления независимо от значения, возвращенного autosizesCells.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.3 и позже.
Осуждаемый в OS X v10.10.


    
    setInterlineSpacing (_:)
    - setInterlineSpacing:

(OS X v10.10)

Устанавливает интервал между записями

Объявление

Swift

func setInterlineSpacing(_ spacing: CGFloat)

Objective C

- (void)setInterlineSpacing:(CGFloat)spacing

Параметры


      spacing

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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


    
    setTitleAlignment (_:)
    - setTitleAlignment:

(OS X v10.10)

Устанавливает выравнивание для всех заголовков записи.

Объявление

Swift

func setTitleAlignment(_ alignment: NSTextAlignment)

Objective C

- (void)setTitleAlignment:(NSTextAlignment)alignment

Параметры


      alignment

Выравнивание может быть одной из следующих констант: NSRightTextAlignment, NSCenterTextAlignment, или NSLeftTextAlignment.

Обсуждение

Выравнивание по умолчанию NSRightTextAlignment.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

См. также

– setTextAlignment:


    
    setTitleBaseWritingDirection (_:)
    - setTitleBaseWritingDirection:

(OS X v10.10)

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

Объявление

Swift

func setTitleBaseWritingDirection(_ writingDirection: NSWritingDirection)

Objective C

- (void)setTitleBaseWritingDirection:(NSWritingDirection)writingDirection

Параметры


      writingDirection

Это значение может быть одной из следующих констант: NSWritingDirectionNatural, NSWritingDirectionLeftToRight, или NSWritingDirectionRightToLeft.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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


    
    setTextAlignment (_:)
    - setTextAlignment:

(OS X v10.10)

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

Объявление

Swift

func setTextAlignment(_ alignment: NSTextAlignment)

Objective C

- (void)setTextAlignment:(NSTextAlignment)alignment

Параметры


      alignment

Выравнивание может быть одной из следующих констант: NSRightTextAlignment, NSCenterTextAlignment, или NSLeftTextAlignment.

Обсуждение

Выравнивание по умолчанию NSLeftTextAlignment.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

См. также

– setTitleAlignment:


    
    setTextBaseWritingDirection (_:)
    - setTextBaseWritingDirection:

(OS X v10.10)

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

Объявление

Swift

func setTextBaseWritingDirection(_ writingDirection: NSWritingDirection)

Objective C

- (void)setTextBaseWritingDirection:(NSWritingDirection)writingDirection

Параметры


      writingDirection

Это значение может быть одной из следующих констант: NSWritingDirectionNatural, NSWritingDirectionLeftToRight, или NSWritingDirectionRightToLeft.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

См. также

baseWritingDirection (NSControl)

setTitleFont (_:) - setTitleFont: (OS X v10.10)

Устанавливает шрифт для всех заголовков записи.

Объявление

Swift

func setTitleFont(_ font: NSFont)

Objective C

- (void)setTitleFont:(NSFont *)font

Параметры

font

Шрифт для использования для всех заголовков записи.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– setTextFont:


    
    setTextFont (_:)
    - setTextFont:

(OS X v10.10)

Устанавливает шрифт для всех доступных для редактирования текстовых полей получателя

Объявление

Swift

func setTextFont(_ font: NSFont)

Objective C

- (void)setTextFont:(NSFont *)font

Параметры


      font

Шрифт для использования для всех доступных для редактирования текстовых полей.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

См. также

– setTextFont:

Получение ячеек и индексов

indexOfCellWithTag (_:) - indexOfCellWithTag: (OS X v10.10)

Возвращает индекс записи, тег которой tag.

Объявление

Swift

func indexOfCellWithTag(_ tag: Int) -> Int

Objective C

- (NSInteger)indexOfCellWithTag:(NSInteger)tag

Параметры

tag

Тег желаемой записи.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

tag (NSCell)
indexOfSelectedItem () - indexOfSelectedItem (OS X v10.10)

Возвращает индекс выбранной записи.

Объявление

Swift

func indexOfSelectedItem() -> Int

Objective C

- (NSInteger)indexOfSelectedItem

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

Индекс выбранной записи, или -1 если не выбрана никакая запись.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.
cellAtIndex (_:) - cellAtIndex: (OS X v10.10)

Возвращает запись в указанном индексе.

Объявление

Swift

func cellAtIndex(_ entryIndex: Int) -> AnyObject!

Objective C

- (id)cellAtIndex:(NSInteger)entryIndex

Параметры

entryIndex

Индекс желаемой записи.

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

Ячейка формы возражает в указанном индексе.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– indexOfCellWithTag:
– indexOfSelectedItem

Отображение ячейки

drawCellAtIndex (_:) - drawCellAtIndex: (OS X v10.10)

Выводит на экран запись в указанном индексе.

Объявление

Swift

func drawCellAtIndex(_ entryIndex: Int)

Objective C

- (void)drawCellAtIndex:(NSInteger)entryIndex

Параметры

entryIndex

Индекс записи для рисования.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– indexOfCellWithTag:
– indexOfSelectedItem

Автоматическая калибровка расположения

preferredTextFieldWidth () - preferredTextFieldWidth (OS X v10.10)

Предпочтительная ширина ячеек формы при использовании Автоматического Расположения.

Объявление

Swift

func preferredTextFieldWidth() -> CGFloat

Objective C

- (CGFloat)preferredTextFieldWidth

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

Поле width.

Обсуждение

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

Значение по умолчанию-1.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.8 и позже.
Осуждаемый в OS X v10.10.

См. также

– setPreferredTextFieldWidth:
setPreferredTextFieldWidth (_:) - setPreferredTextFieldWidth: (OS X v10.10)

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

Объявление

Swift

func setPreferredTextFieldWidth(_ preferredWidth: CGFloat)

Objective C

- (void)setPreferredTextFieldWidth:(CGFloat)preferredWidth

Параметры

preferredWidth

Предпочтительная ширина.

Обсуждение

Предпочтительная ширина отражается в ячейке cellSize, который будет достаточно большим для размещения заголовка, внешней панели и текстового поля ширины preferredTextWidth. Это также отражается в intrinsicContentSize из формы. Т.е. при Автоматическом Расположении форма попытается измерить себя так, чтобы ячейка текстового поля была данной шириной, согласно обычным ограничительным приоритетам размера содержания.

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

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

Этот метод может помочь миграции к Автоматическому Расположению и достаточен для простых случаев. Однако для новых приложений, использовать NSTextField объекты непосредственно вместо NSForm.

Значение по умолчанию-1.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.8 и позже.
Осуждаемый в OS X v10.10.

См. также

– preferredTextFieldWidth

Редактирование текста


    
    selectTextAtIndex (_:)
    - selectTextAtIndex:

(OS X v10.10)

Выбирает запись в указанном индексе.

Объявление

Swift

func selectTextAtIndex(_ entryIndex: Int)

Objective C

- (void)selectTextAtIndex:(NSInteger)entryIndex

Параметры


      entryIndex

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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