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

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

Разработчик

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

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

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

NSTextField

NSTextField объект - своего рода NSControl это выводит на экран текст, который пользователь может выбрать или отредактировать, и это отправляет его сообщение действия в его цель, когда пользователь нажимает клавишу Return при редактировании.

NSTextField класс использует NSTextFieldCell класс для реализации его пользовательского интерфейса.

Родительский класс, NSControl, обеспечивает методы для установки значений текстового поля, например: setStringValue:, setDoubleValue:, и т.д. Существуют соответствующие методы для получения значений.

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


Swift

import AppKit

Objective C

@import AppKit;

Доступность


Доступный в OS X v10.0 и позже.
  • Средства управления, может ли пользователь отредактировать текст получателя.

    Объявление

    Swift

    var editable: Bool

    Objective C

    @property(getter=isEditable) BOOL editable

    Параметры

    flag

    Если YEStrue, тогда пользователю разрешают и выбрать и отредактировать текст. Если flag NOfalse, тогда пользователю не разрешают отредактировать текст, и возможность выбрать содержание получателя зависит от значения isSelectable.

    Обсуждение

    Например, если NSTextField объект можно выбрать, но не доступен для редактирования, затем сделал доступным для редактирования какое-то время, затем сделанным не доступный для редактирования, это остается можно выбрать. Чтобы гарантировать, что текст ни один доступен для редактирования или можно выбрать, использовать setSelectable: отключить текстовый выбор.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – isEditable

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

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

    Объявление

    Objective C

    - (BOOL)isEditable

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

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

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

    Objective C

    @import AppKit;

    Доступность

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

  • Наборы, можно ли получатель выбрать (но не доступен для редактирования).

    Объявление

    Swift

    var selectable: Bool

    Objective C

    @property(getter=isSelectable) BOOL selectable

    Параметры

    flag

    Если YEStrue, получатель сделан можно выбрать, но не доступный для редактирования (использование setEditable: сделать текст и можно выбрать и доступным для редактирования). Если NOfalse, текст не доступен для редактирования и не можно выбрать.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setEditable:

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

    Возвращает булево значение, указывающее, разрешают ли пользователю выбрать текст получателя.

    Объявление

    Objective C

    - (BOOL)isSelectable

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

    YEStrue если пользователю разрешают выбрать текст получателя; иначе NOfalse.

    Обсуждение

    Выбираемый текст не обязательно доступен для редактирования; использовать isEditable определить, доступен ли текст для редактирования.

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

    Objective C

    @import AppKit;

    Доступность

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

    См. также

    – setSelectable:

  • Средства управления, позволяет ли получатель пользователю изменять атрибуты шрифта строки получателя.

    Объявление

    Swift

    var allowsEditingTextAttributes: Bool

    Objective C

    @property BOOL allowsEditingTextAttributes

    Параметры

    flag

    Если YEStrue, и текстовое значение является приписанной строкой, оно выведено на экран с помощью визуальных настроек приписанной строки, которые могут быть изменены в панели шрифта.; если flag NOfalse и текст является приписанной строкой. строковые атрибуты (шрифт, цвет, и т.д.) проигнорированы, и строка выведена на экран на основе настроек текстового поля. Когда текстовое поле редактирует, установка атрибутов приписанной строки проигнорирована при отображении строки и.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Возвращает булево значение, указывающее, разрешают ли пользователю изменить атрибуты шрифта текста получателя.

    Объявление

    Swift

    var allowsEditingTextAttributes: Bool

    Objective C

    @property BOOL allowsEditingTextAttributes

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

    YEStrue если получатель позволяет пользователю изменять атрибуты шрифта текста получателя, иначе NOfalse. Можно изменить текстовые атрибуты программно независимо от этой установки.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Средства управления, позволяет ли получатель пользователю перетаскивать файлы образа в него.

    Объявление

    Swift

    var importsGraphics: Bool

    Objective C

    @property BOOL importsGraphics

    Параметры

    flag

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Возвращает булево значение, указывающее, позволяет ли получатель пользователю перетаскивать файлы образа в него.

    Объявление

    Swift

    var importsGraphics: Bool

    Objective C

    @property BOOL importsGraphics

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

    YEStrue если получатель позволяет пользователю перетаскивать файлы образа в него, иначе NOfalse. Можно добавить изображения программно независимо от этой установки.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    @NSCopying var textColor: NSColor?

    Objective C

    @property(copy) NSColor *textColor

    Параметры

    aColor

    Цвет раньше составлял текст.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Возвращается цвет раньше составлял текст получателя.

    Объявление

    Swift

    @NSCopying var textColor: NSColor?

    Objective C

    @property(copy) NSColor *textColor

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

    Цвет раньше составлял текст.

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

    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 и позже.

    См. также

    – preferredMaxLayoutWidth

  • Выбирает цвет фона, который ячейка получателя рисует позади текста.

    Объявление

    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

    Если YEStrue, ячейка получателя рисует свой фон; если NOfalse, это ничего не рисует позади своего текста.

    Обсуждение

    Для предотвращения противоречивого рендеринга рендеринг цвета фона отключен для текстовых полей округленной внешней панели.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Возвращает булево значение, указывающее, рисует ли ячейка получателя свой цвет фона.

    Объявление

    Swift

    var drawsBackground: Bool

    Objective C

    @property BOOL drawsBackground

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

    YEStrue если ячейка получателя рисует свой цвет фона позади ее текста, NOfalse если это не рисует фона.

    Обсуждение

    Для предотвращения противоречивого рендеринга рендеринг цвета фона отключен для текстовых полей округленной внешней панели.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Средства управления, рисует ли получатель границу bezeled вокруг своего содержания.

    Объявление

    Swift

    var bezeled: Bool

    Objective C

    @property(getter=isBezeled) BOOL bezeled

    Параметры

    flag

    Если YEStrue, это рисует границу bezeled и вызывает setDrawsBackground: с параметром NOfalse; если NOfalse, получатель не рисует границу.

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

    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

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

    YEStrue если получатель рисует кадр bezeled вокруг своего содержания; иначе, NOfalse.

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

    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: с параметром YEStrue

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – bezelStyle

  • Возвращает стиль внешней панели получателя.

    Объявление

    Swift

    var bezelStyle: NSTextFieldBezelStyle

    Objective C

    @property NSTextFieldBezelStyle bezelStyle

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

    Постоянное указание стиля внешней панели. Возможные значения, описанные в NSTextFieldBezelStyle.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setBezelStyle:

  • Средства управления, рисует ли получатель чистую черную границу вокруг своего содержания.

    Объявление

    Swift

    var bordered: Bool

    Objective C

    @property(getter=isBordered) BOOL bordered

    Параметры

    flag

    Если YEStrue, получатель рисует границу; если NOfalse, это не рисует границы.

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

    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

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

    YEStrue если получатель рисует чистую черную границу вокруг своего содержания; иначе NOfalse.

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

    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 и позже.

    См. также

    – isSelectable

  • Возвращает булево значение, указывающее, доступен ли получатель для редактирования.

    Объявление

    Swift

    var acceptsFirstResponder: Bool { get }

    Objective C

    @property(readonly) BOOL acceptsFirstResponder

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

    YEStrue если получатель доступен для редактирования, NOfalse иначе.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Устанавливает строковое значение получателя, с помощью встроенного символа в качестве мнемосхемы клавиатуры.

    Объявление

    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 и позже.

    См. также

    – setDelegate:

  • Разрешение запросов начать редактировать текстовый объект.

    Объявление

    Swift

    func textShouldBeginEditing(_ textObject: NSText) -> Bool

    Objective C

    - (BOOL)textShouldBeginEditing:(NSText *)textObject

    Параметры

    textObject

    Объект начать редактировать.

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

    YEStrue если редактированию нужно позволить произойти, NOfalse иначе.

    Обсуждение

    Если получатель не доступен для редактирования, возвраты NOfalse сразу. Если это доступно для редактирования, и его делегат отвечает на control:textShouldBeginEditing:, это вызывает тот метод и возвращает результат. Иначе это просто возвращается YEStrue позволить редактировать для появления. Посмотрите 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) -> Bool

    Objective C

    - (BOOL)textShouldEndEditing:(NSText *)textObject

    Параметры

    textObject

    Разрешение запроса текстового объекта закончить редактирование.

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

    YEStrue если новое значение допустимо; иначе NOfalse.

    Обсуждение

    Этот метод проверяет новое значение получателя с помощью NSCell метод isEntryAcceptable:. Если новое значение допустимо, и делегат отвечает на control:textShouldEndEditing:, если делегат возвращается, вызывает тот метод и возвращает результат, кроме того подавая звуковой сигнал NOfalse. Посмотрите 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 к центру уведомления по умолчанию. Эта регистрация заставляет делегата получателя получать a controlTextDidEndEditing: сообщение. После этого сообщения, отправляет endEditing: к получателю’ ячейка и дескрипторы ключ, заставивший редактирование заканчиваться:

    • Если пользователь закончил редактирование путем нажатия Return, этот метод пытается отправить действие получателя в свою цель; если неуспешный, это отправляет performKeyEquivalent: к NSView (например, для обработки кнопки по умолчанию на панели); если это также перестало работать, получатель просто выбирает свой текст.

    • Если пользователь закончил редактирование путем нажатия Tab или Shift-Tab, получатель пытается иметь NSWindow возразите выбирают его следующее или предыдущее ключевое представление, с помощью NSWindow метод selectKeyViewFollowingView: или selectKeyViewPrecedingView:. Если неуспешный в выполнении этого, получатель просто выбирает свой текст.

    Посмотрите NSControl спецификация класса для получения дополнительной информации о текстовом методе делегата.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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