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

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

Разработчик

Ссылка платформы основы ссылка класса NSMutableAttributedString

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

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

NSMutableAttributedString

NSMutableAttributedString объявляет программируемый интерфейс к объектам, управляющим непостоянными приписанными строками. Можно добавить и удалить символы (необработанные строки) и атрибуты отдельно или вместе как приписанные строки. См. описание класса для NSAttributedString для получения дополнительной информации о приписанных строках.

При работе с Набором Приложения необходимо также очистить измененные атрибуты с помощью различного fix... методы. См. “Изменение Приписанной Строки “для получения дополнительной информации о фиксации атрибутов. Эти методы, а также другие, включающие установку графических атрибутов, описаны в Дополнениях NSMutableAttributedString в Наборе Приложения.

NSMutableAttributedString добавляют два примитивных метода к тем NSAttributedString. Эти примитивные методы обеспечивают основание для всех других методов в его классе. Примитив replaceCharactersInRange:withString: метод заменяет диапазон символов с теми от строки, оставляя всю информацию атрибута вне того диапазона неповрежденной. Примитив setAttributes:range: метод устанавливает атрибуты и значения для данного диапазона символов, заменяя любые предыдущие атрибуты и значения для того диапазона.

В OS X Набор Приложения также использует NSParagraphStyle и его подкласс NSMutableParagraphStyle для инкапсуляции абзаца или атрибутов линейки, используемых NSAttributedString классы.

Обратите внимание на то, что стандартный шрифт для NSAttributedString объекты являются Helvetica, с 12 точками, который отличается от системного шрифта OS X Lucida Grande, таким образом, можно хотеть создать строку с атрибутами не по умолчанию, подходящими для использования приложения, например, initWithString:attributes:.

NSMutableAttributedString “бесплатный соединенный мостом” с его Базовым дубликатом Основы, CFMutableAttributedStringRef. Посмотрите Бесплатное Образование моста для получения дополнительной информации.

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

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

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

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

Получение символьной информации
  • mutableString mutableString Свойство

    Символьное содержание получателя как NSMutableString объект.

    Объявление

    Swift

    var mutableString: NSMutableString { get }

    Objective C

    @property(readonly, retain) NSMutableString *mutableString

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

    Непостоянный строковый объект.

    Обсуждение

    Получатель отслеживает изменения в этой строке и совершенствует ее отображения атрибута.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

Изменение символов
  • replaceCharactersInRange (_: withString:) - replaceCharactersInRange:withString:

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

    Объявление

    Swift

    func replaceCharactersInRange(_ aRange: NSRange, withString aString: String)

    Objective C

    - (void)replaceCharactersInRange:(NSRange)aRange withString:(NSString *)aString

    Параметры

    aRange

    Диапазон, указывающий символы для замены.

    aString

    Строка, указывающая символы для замены тех в aRange.

    Обсуждение

    Новые символы наследовали атрибуты первого замененного символа от aRange. Где длина aRange 0, новые символы наследовали атрибуты символьного предыдущего aRange если это имеет кого-либо, иначе символа после aRange.

    Повышения NSRangeException если любая часть aRange лежит за пределами конца символов получателя.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – deleteCharactersInRange:

  • deleteCharactersInRange (_:) - deleteCharactersInRange:

    Удаляет символы в данном диапазоне вместе с их связанными атрибутами.

    Объявление

    Swift

    func deleteCharactersInRange(_ aRange: NSRange)

    Objective C

    - (void)deleteCharactersInRange:(NSRange)aRange

    Параметры

    aRange

    Диапазон, указывающий символы для удаления.

    Обсуждение

    Повышения NSRangeException если любая часть aRange лежит за пределами конца символов получателя.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – replaceCharactersInRange:withAttributedString:
    – replaceCharactersInRange:withString:

Изменение атрибутов
  • setAttributes (_: диапазон:) - setAttributes:range:

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

    Объявление

    Swift

    func setAttributes(_ attributes: [NSObject : AnyObject]?, range aRange: NSRange)

    Objective C

    - (void)setAttributes:(NSDictionary *)attributes range:(NSRange)aRange

    Параметры

    attributes

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

    aRange

    Диапазон символов, атрибуты которых установлены.

    Обсуждение

    Эти новые атрибуты заменяют любые атрибуты, ранее связанные с символами в aRange. Повышения NSRangeException если любая часть aRange лежит за пределами конца символов получателя.

    Установить атрибуты для нулевой длины NSMutableAttributedString выведенный на экран в текстовом представлении, используйте NSTextView метод setTypingAttributes:.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – addAttributes:range:
    – removeAttribute:range:

  • addAttribute (_: value:range:) - addAttribute:value:range:

    Добавляет атрибут с именем и значением к символам в указанном диапазоне.

    Объявление

    Swift

    func addAttribute(_ name: String, value value: AnyObject, range aRange: NSRange)

    Objective C

    - (void)addAttribute:(NSString *)name value:(id)value range:(NSRange)aRange

    Параметры

    name

    Строка, указывающая название атрибута. Ключи атрибута могут быть предоставлены другой платформой или могут быть пользовательскими, которые Вы определяете. Для получения информации о том, где найти предоставленные систему ключи атрибута, посмотрите раздел обзора в Ссылке класса NSAttributedString.

    value

    Значение атрибута связалось с name.

    aRange

    Диапазон символов, к которым применяется указанная пара атрибут/значение.

    Обсуждение

    Можно присвоить любого name/value пара Вы желаете к диапазону символов, в дополнение к стандартным атрибутам, описанным в разделе Constants Дополнений NSAttributedString. Повышения NSInvalidArgumentException если name или value nil и NSRangeException если любая часть aRange лежит за пределами конца символов получателя.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – addAttributes:range:
    – removeAttribute:range:

  • addAttributes (_: диапазон:) - addAttributes:range:

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

    Объявление

    Swift

    func addAttributes(_ attributes: [NSObject : AnyObject], range aRange: NSRange)

    Objective C

    - (void)addAttributes:(NSDictionary *)attributes range:(NSRange)aRange

    Параметры

    attributes

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

    aRange

    Диапазон символов, к которым применяются указанные атрибуты.

    Обсуждение

    Можно присвоить любую пару имя/значение, которой Вы желаете к диапазону символов, в дополнение к стандартным атрибутам, описанным в разделе Constants Дополнений NSAttributedString. Повышения NSInvalidArgumentException если attributes nil и NSRangeException если любая часть aRange лежит за пределами конца символов получателя.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – addAttribute:value:range:
    – removeAttribute:range:

  • removeAttribute (_: диапазон:) - removeAttribute:range:

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

    Объявление

    Swift

    func removeAttribute(_ name: String, range aRange: NSRange)

    Objective C

    - (void)removeAttribute:(NSString *)name range:(NSRange)aRange

    Параметры

    name

    Строка, указывающая название атрибута для удаления. Ключи атрибута могут быть предоставлены другой платформой или могут быть пользовательскими, которые Вы определяете. Для получения информации о том, где найти предоставленные систему ключи атрибута, посмотрите раздел обзора в Ссылке класса NSAttributedString.

    aRange

    Диапазон символов, из которых удален указанный атрибут.

    Обсуждение

    Повышения NSRangeException если любая часть aRange лежит за пределами конца символов получателя.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – addAttribute:value:range:
    – addAttributes:range:

Изменение символов и атрибутов
  • appendAttributedString (_:) - appendAttributedString:

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

    Объявление

    Swift

    func appendAttributedString(_ attributedString: NSAttributedString)

    Objective C

    - (void)appendAttributedString:(NSAttributedString *)attributedString

    Параметры

    attributedString

    Строка, символы которой и атрибуты добавляются.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – insertAttributedString:atIndex:
    + attributedStringWithAttachment: (Дополнения NSAttributedString)

  • insertAttributedString (_: atIndex:) - insertAttributedString:atIndex:

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

    Объявление

    Swift

    func insertAttributedString(_ attributedString: NSAttributedString, atIndex index: Int)

    Objective C

    - (void)insertAttributedString:(NSAttributedString *)attributedString atIndex:(NSUInteger)index

    Параметры

    attributedString

    Строка, символы которой и атрибуты вставляются.

    index

    Индекс, в котором вставляются символы и атрибуты.

    Обсуждение

    Новые символы и атрибуты начинаются в данном индексе и существующих символах, и атрибуты от индекса до конца получателя смещаются на длину приписанной строки. Повышения NSRangeException если index лежит за пределами конца символов получателя.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – appendAttributedString:
    + attributedStringWithAttachment: (Дополнения NSAttributedString)

  • replaceCharactersInRange (_: withAttributedString:) - replaceCharactersInRange:withAttributedString:

    Заменяет символы и атрибуты в данном диапазоне с символами и атрибуты данной приписанной строки.

    Объявление

    Swift

    func replaceCharactersInRange(_ aRange: NSRange, withAttributedString attributedString: NSAttributedString)

    Objective C

    - (void)replaceCharactersInRange:(NSRange)aRange withAttributedString:(NSAttributedString *)attributedString

    Параметры

    aRange

    Диапазон символов и атрибутов заменяется.

    attributedString

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

    Обсуждение

    Повышения NSRangeException если любая часть aRange лежит за пределами конца символов получателя.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – insertAttributedString:atIndex:

  • setAttributedString (_:) - setAttributedString:

    Заменяет все содержание получателя символами и атрибутами данной приписанной строки.

    Объявление

    Swift

    func setAttributedString(_ attributedString: NSAttributedString)

    Objective C

    - (void)setAttributedString:(NSAttributedString *)attributedString

    Параметры

    attributedString

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – appendAttributedString:

Группировка изменений
  • beginEditing () - beginEditing

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

    Объявление

    Swift

    func beginEditing()

    Objective C

    - (void)beginEditing

    Обсуждение

    Можно вложить пар beginEditing и endEditing сообщения.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • endEditing () - endEditing

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

    Объявление

    Swift

    func endEditing()

    Objective C

    - (void)endEditing

    Обсуждение

    NSMutableAttributedString реализация ничего не делает. NSTextStorage, например, переопределяет этот метод для вызова fixAttributesInRange: и сообщать NSLayoutManager объекты, что они должны передать текст.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – processEditing (NSTextStorage)