NSTextField
NSTextField
объект - своего рода NSControl
это выводит на экран текст, который пользователь может выбрать или отредактировать, и это отправляет его сообщение действия в его цель, когда пользователь нажимает клавишу Return при редактировании.
NSTextField
класс использует NSTextFieldCell
класс для реализации его пользовательского интерфейса.
Родительский класс, NSControl
, обеспечивает методы для установки значений текстового поля, например: setStringValue:
, setDoubleValue:
, и т.д. Существуют соответствующие методы для получения значений.
Наследование
Соответствует
-
AnyObject
-
CVarArgType
-
Сопоставимый
-
Hashable
-
NSAccessibility
-
NSAccessibilityElementProtocol
-
NSAccessibilityNavigableStaticText
-
NSAccessibilityStaticText
-
NSAnimatablePropertyContainer
-
NSAppearanceCustomization
-
NSCoding
-
NSDraggingDestination
-
NSObjectProtocol
-
NSUserInterfaceItemIdentification
-
NSUserInterfaceValidations
-
Печатаемый
-
Reflectable
-
NSAccessibility
-
NSAccessibilityElement
-
NSAccessibilityNavigableStaticText
-
NSAnimatablePropertyContainer
-
NSAppearanceCustomization
-
NSCoding
-
NSDraggingDestination
-
NSObject
-
NSUserInterfaceItemIdentification
-
NSUserInterfaceValidations
Оператор импорта
Swift
import AppKit
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
-
Средства управления, может ли пользователь отредактировать текст получателя.
Объявление
Swift
var editable: Bool
Objective C
@property(getter=isEditable) BOOL editable
Параметры
flag
Если
YES
true
, тогда пользователю разрешают и выбрать и отредактировать текст. Еслиflag
NO
false
, тогда пользователю не разрешают отредактировать текст, и возможность выбрать содержание получателя зависит от значенияisSelectable
.Обсуждение
Например, если
NSTextField
объект можно выбрать, но не доступен для редактирования, затем сделал доступным для редактирования какое-то время, затем сделанным не доступный для редактирования, это остается можно выбрать. Чтобы гарантировать, что текст ни один доступен для редактирования или можно выбрать, использоватьsetSelectable:
отключить текстовый выбор.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
isEditable - isEditable
Доступный в OS X v10.0 через OS X v10.9Возвращает булево значение, указывающее, разрешают ли пользователю выбрать и отредактировать текст получателя.
Объявление
Objective C
- (BOOL)isEditable
Возвращаемое значение
YES
true
если пользователю разрешают выбрать и отредактировать текст получателя,NO
false
если пользователю не разрешают отредактировать его (хотя пользователь может быть в состоянии выбрать его).Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 через OS X v10.9.
См. также
-
Наборы, можно ли получатель выбрать (но не доступен для редактирования).
Объявление
Swift
var selectable: Bool
Objective C
@property(getter=isSelectable) BOOL selectable
Параметры
flag
Если
YES
true
, получатель сделан можно выбрать, но не доступный для редактирования (использованиеsetEditable:
сделать текст и можно выбрать и доступным для редактирования). ЕслиNO
false
, текст не доступен для редактирования и не можно выбрать.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
isSelectable - isSelectable
Доступный в OS X v10.0 через OS X v10.9Возвращает булево значение, указывающее, разрешают ли пользователю выбрать текст получателя.
Объявление
Objective C
- (BOOL)isSelectable
Возвращаемое значение
YES
true
если пользователю разрешают выбрать текст получателя; иначеNO
false
.Обсуждение
Выбираемый текст не обязательно доступен для редактирования; использовать
isEditable
определить, доступен ли текст для редактирования.Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 через OS X v10.9.
См. также
-
Средства управления, позволяет ли получатель пользователю изменять атрибуты шрифта строки получателя.
Объявление
Swift
var allowsEditingTextAttributes: Bool
Objective C
@property BOOL allowsEditingTextAttributes
Параметры
flag
Если
YES
true
, и текстовое значение является приписанной строкой, оно выведено на экран с помощью визуальных настроек приписанной строки, которые могут быть изменены в панели шрифта.; еслиflag
NO
false
и текст является приписанной строкой. строковые атрибуты (шрифт, цвет, и т.д.) проигнорированы, и строка выведена на экран на основе настроек текстового поля. Когда текстовое поле редактирует, установка атрибутов приписанной строки проигнорирована при отображении строки и.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает булево значение, указывающее, разрешают ли пользователю изменить атрибуты шрифта текста получателя.
Объявление
Swift
var allowsEditingTextAttributes: Bool
Objective C
@property BOOL allowsEditingTextAttributes
Возвращаемое значение
YES
true
если получатель позволяет пользователю изменять атрибуты шрифта текста получателя, иначеNO
false
. Можно изменить текстовые атрибуты программно независимо от этой установки.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Средства управления, позволяет ли получатель пользователю перетаскивать файлы образа в него.
Объявление
Swift
var importsGraphics: Bool
Objective C
@property BOOL importsGraphics
Параметры
flag
Если
YES
true
, получатель принимает перетащенные изображения; еслиNO
false
, это не делает. Можно добавить изображения программно независимо от этой установки.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
– setAllowsEditingTextAttributes:
setImportsGraphics:
(NSTextView)– importsGraphics
-
Возвращает булево значение, указывающее, позволяет ли получатель пользователю перетаскивать файлы образа в него.
Объявление
Swift
var importsGraphics: Bool
Objective C
@property BOOL importsGraphics
Возвращаемое значение
YES
true
если получатель позволяет пользователю перетаскивать файлы образа в него, иначеNO
false
. Можно добавить изображения программно независимо от этой установки.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
– allowsEditingTextAttributes
importsGraphics
(NSTextView
)– setImportsGraphics:
-
Выбирает цвет, используемый для рисования текста получателя.
Параметры
aColor
Цвет раньше составлял текст.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
– setBackgroundColor:
setTextColor:
(NSTextFieldCell
)– цвет текста
-
Возвращается цвет раньше составлял текст получателя.
Возвращаемое значение
Цвет раньше составлял текст.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
– backgroundColor
textColor
(NSTextFieldCell
)– setTextColor:
-
Возвращает предпочтительную максимальную ширину расположения.
Объявление
Swift
var preferredMaxLayoutWidth: CGFloat
Objective C
@property CGFloat preferredMaxLayoutWidth
Возвращаемое значение
Предпочтительная максимальная ширина расположения.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.8 и позже.
См. также
-
Устанавливает предпочтительную максимальную ширину текстового поля.
Объявление
Swift
var preferredMaxLayoutWidth: CGFloat
Objective C
@property CGFloat preferredMaxLayoutWidth
Параметры
width
Предпочтительная максимальная ширина.
Обсуждение
Значение определяет максимальную ширину
intrinsicContentSize
. Если текстовое поле перенесется, то внутренняя высота будет достаточно большой для показа всего текстового содержания в той ширине.Значение по умолчанию 0, который не подразумевает максимальной предпочтительной ширины.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.8 и позже.
См. также
-
Выбирает цвет фона, который ячейка получателя рисует позади текста.
Объявление
Swift
@NSCopying var backgroundColor: NSColor?
Objective C
@property(copy) NSColor *backgroundColor
Параметры
aColor
Цвет раньше рисовал фон.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает цвет фона, который ячейка получателя рисует позади текста.
Объявление
Swift
@NSCopying var backgroundColor: NSColor?
Objective C
@property(copy) NSColor *backgroundColor
Возвращаемое значение
Цвет раньше рисовал фон.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Средства управления, рисует ли ячейка получателя свой цвет фона позади ее текста.
Объявление
Swift
var drawsBackground: Bool
Objective C
@property BOOL drawsBackground
Параметры
flag
Если
YES
true
, ячейка получателя рисует свой фон; еслиNO
false
, это ничего не рисует позади своего текста.Обсуждение
Для предотвращения противоречивого рендеринга рендеринг цвета фона отключен для текстовых полей округленной внешней панели.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
– setBackgroundColor:
setDrawsBackground:
(NSTextFieldCell
)– drawsBackground
-
Возвращает булево значение, указывающее, рисует ли ячейка получателя свой цвет фона.
Объявление
Swift
var drawsBackground: Bool
Objective C
@property BOOL drawsBackground
Возвращаемое значение
YES
true
если ячейка получателя рисует свой цвет фона позади ее текста,NO
false
если это не рисует фона.Обсуждение
Для предотвращения противоречивого рендеринга рендеринг цвета фона отключен для текстовых полей округленной внешней панели.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
– backgroundColor
drawsBackground
(NSTextFieldCell
)– setDrawsBackground:
-
Средства управления, рисует ли получатель границу bezeled вокруг своего содержания.
Объявление
Swift
var bezeled: Bool
Objective C
@property(getter=isBezeled) BOOL bezeled
Параметры
flag
Если
YES
true
, это рисует границу bezeled и вызываетsetDrawsBackground:
с параметромNO
false
; еслиNO
false
, получатель не рисует границу.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
isBezeled - isBezeled
Доступный в OS X v10.0 через OS X v10.9Возвращает булево значение, указывающее, рисует ли получатель кадр bezeled.
Объявление
Objective C
- (BOOL)isBezeled
Возвращаемое значение
YES
true
если получатель рисует кадр bezeled вокруг своего содержания; иначе,NO
false
.Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 через OS X v10.9.
См. также
-
Устанавливает стиль внешней панели получателя.
Объявление
Swift
var bezelStyle: NSTextFieldBezelStyle
Objective C
@property NSTextFieldBezelStyle bezelStyle
Параметры
style
Постоянное указание стиля внешней панели. Возможные значения для
style
описаны вNSTextFieldBezelStyle
. Вы, должно быть, уже отправили получательsetBezeled:
с параметромYES
true
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.2 и позже.
См. также
-
Возвращает стиль внешней панели получателя.
Объявление
Swift
var bezelStyle: NSTextFieldBezelStyle
Objective C
@property NSTextFieldBezelStyle bezelStyle
Возвращаемое значение
Постоянное указание стиля внешней панели. Возможные значения, описанные в
NSTextFieldBezelStyle
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.2 и позже.
См. также
-
Средства управления, рисует ли получатель чистую черную границу вокруг своего содержания.
Объявление
Swift
var bordered: Bool
Objective C
@property(getter=isBordered) BOOL bordered
Параметры
flag
Если
YES
true
, получатель рисует границу; еслиNO
false
, это не рисует границы.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
isBordered - isBordered
Доступный в OS X v10.0 через OS X v10.9Возвращает булево значение, указывающее, рисует ли получатель черную границу вокруг своего содержания.
Объявление
Objective C
- (BOOL)isBordered
Возвращаемое значение
YES
true
если получатель рисует чистую черную границу вокруг своего содержания; иначеNO
false
.Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 через OS X v10.9.
См. также
-
Редактирование концов и выбирает все содержание получателя, если это можно выбрать.
Объявление
Swift
func selectText(_
sender
: AnyObject?)Objective C
- (void)selectText:(id)
sender
Параметры
sender
Отправитель сообщения.
Обсуждение
Если получатель не находится в иерархии представления некоторого окна, этот метод не имеет никакого эффекта.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает булево значение, указывающее, доступен ли получатель для редактирования.
Объявление
Swift
var acceptsFirstResponder: Bool { get }
Objective C
@property(readonly) BOOL acceptsFirstResponder
Возвращаемое значение
YES
true
если получатель доступен для редактирования,NO
false
иначе.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
setTitleWithMnemonic: - setTitleWithMnemonic:
(OS X v10.8)Устанавливает строковое значение получателя, с помощью встроенного символа в качестве мнемосхемы клавиатуры.
Объявление
Objective C
- (void)setTitleWithMnemonic:(NSString *)
aString
Параметры
aString
Строка для установки как заголовок. Первый символ, которому предшествует амперсанд (‘& ’), используется в качестве мнемосхемы (первый символ амперсанда разделяется).
Обсуждение
Мнемоника не поддерживается в OS X.
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.8.
-
Устанавливает делегата получателя.
Объявление
Swift
unowned(unsafe) var delegate: NSTextFieldDelegate?
Objective C
@property(assign) id<NSTextFieldDelegate> delegate
Параметры
anObject
Объект, действующий как делегат получателя.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает делегата получателя.
Объявление
Swift
unowned(unsafe) var delegate: NSTextFieldDelegate?
Objective C
@property(assign) id<NSTextFieldDelegate> delegate
Возвращаемое значение
Объект, действующий как делегат получателя.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Разрешение запросов начать редактировать текстовый объект.
Объявление
Swift
func textShouldBeginEditing(_
textObject
: NSText) -> BoolObjective C
- (BOOL)textShouldBeginEditing:(NSText *)
textObject
Параметры
textObject
Объект начать редактировать.
Возвращаемое значение
YES
true
если редактированию нужно позволить произойти,NO
false
иначе.Обсуждение
Если получатель не доступен для редактирования, возвраты
NO
false
сразу. Если это доступно для редактирования, и его делегат отвечает наcontrol:textShouldBeginEditing:
, это вызывает тот метод и возвращает результат. Иначе это просто возвращаетсяYES
true
позволить редактировать для появления. ПосмотритеNSControl
спецификация класса для получения дополнительной информации о текстовом методе делегата.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Отправляет уведомление, которое текст собирается начать редактировать к центру уведомления по умолчанию.
Объявление
Swift
func textDidBeginEditing(_
aNotification
: NSNotification)Objective C
- (void)textDidBeginEditing:(NSNotification *)
aNotification
Параметры
aNotification
NSControlTextDidBeginEditingNotification
уведомление сообщению.Обсуждение
Это действие заставляет делегата получателя получать a
controlTextDidBeginEditing:
сообщение. ПосмотритеNSControl
спецификация класса для получения дополнительной информации о текстовом методе делегата.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Отправляет уведомление, что текст изменил и передает это сообщение к ячейке получателя, если это отвечает.
Объявление
Swift
func textDidChange(_
aNotification
: NSNotification)Objective C
- (void)textDidChange:(NSNotification *)
aNotification
Параметры
aNotification
NSControlTextDidChangeNotification
уведомление, отправляющееся на центр уведомления по умолчанию.Обсуждение
Этот метод заставляет делегата получателя получать a
controlTextDidChange:
сообщение. ПосмотритеNSControl
спецификация класса для получения дополнительной информации о текстовом методе делегата.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Выполняет проверку на новом значении получателя.
Объявление
Swift
func textShouldEndEditing(_
textObject
: NSText) -> BoolObjective C
- (BOOL)textShouldEndEditing:(NSText *)
textObject
Параметры
textObject
Разрешение запроса текстового объекта закончить редактирование.
Возвращаемое значение
YES
true
если новое значение допустимо; иначеNO
false
.Обсуждение
Этот метод проверяет новое значение получателя с помощью
NSCell
методisEntryAcceptable:
. Если новое значение допустимо, и делегат отвечает наcontrol:textShouldEndEditing:
, если делегат возвращается, вызывает тот метод и возвращает результат, кроме того подавая звуковой сигналNO
false
. ПосмотритеNSControl
спецификация класса для получения дополнительной информации о текстовом методе делегата.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Обрабатывает конец редактирования.
Объявление
Swift
func textDidEndEditing(_
aNotification
: NSNotification)Objective C
- (void)textDidEndEditing:(NSNotification *)
aNotification
Параметры
aNotification
Уведомление, которое закончило редактирование.
Обсуждение
После проверки нового значения, сообщения
NSControlTextDidEndEditingNotification
к центру уведомления по умолчанию. Эта регистрация заставляет делегата получателя получать acontrolTextDidEndEditing:
сообщение. После этого сообщения, отправляетendEditing:
к получателю’ ячейка и дескрипторы ключ, заставивший редактирование заканчиваться:Если пользователь закончил редактирование путем нажатия Return, этот метод пытается отправить действие получателя в свою цель; если неуспешный, это отправляет
performKeyEquivalent:
кNSView
(например, для обработки кнопки по умолчанию на панели); если это также перестало работать, получатель просто выбирает свой текст.Если пользователь закончил редактирование путем нажатия Tab или Shift-Tab, получатель пытается иметь
NSWindow
возразите выбирают его следующее или предыдущее ключевое представление, с помощьюNSWindow
методselectKeyViewFollowingView:
илиselectKeyViewPrecedingView:
. Если неуспешный в выполнении этого, получатель просто выбирает свой текст.
Посмотрите
NSControl
спецификация класса для получения дополнительной информации о текстовом методе делегата.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.