NSMutableAttributedString
Наследование
-
NSObject
-
NSAttributedString
-
NSMutableAttributedString
-
NSTextStorage
-
NSObject
-
NSAttributedString
-
NSMutableAttributedString
-
NSTextStorage
Соответствует
-
AnyObject
-
CVarArgType
-
Сопоставимый
-
Hashable
-
NSCoding
-
NSCopying
-
NSMutableCopying
-
NSObjectProtocol
-
NSSecureCoding
-
Печатаемый
-
NSCopying
-
NSMutableCopying
-
NSObject
-
NSSecureCoding
Оператор импорта
Swift
import Foundation
Objective C
@import Foundation;
Доступность
Доступный в iOS 3.2 и позже.
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
. Посмотрите Бесплатное Образование моста для получения дополнительной информации.
-
mutableString
СвойствоСимвольное содержание получателя как
NSMutableString
объект.Объявление
Swift
var mutableString: NSMutableString { get }
Objective C
@property(readonly, retain) NSMutableString *mutableString
Возвращаемое значение
Непостоянный строковый объект.
Обсуждение
Получатель отслеживает изменения в этой строке и совершенствует ее отображения атрибута.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 3.2 и позже.
-
Заменяет символы в данном диапазоне с символами данной строки.
Объявление
Параметры
aRange
Диапазон, указывающий символы для замены.
aString
Строка, указывающая символы для замены тех в
aRange
.Обсуждение
Новые символы наследовали атрибуты первого замененного символа от
aRange
. Где длинаaRange
0, новые символы наследовали атрибуты символьного предыдущегоaRange
если это имеет кого-либо, иначе символа послеaRange
.Повышения
NSRangeException
если любая частьaRange
лежит за пределами конца символов получателя.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 3.2 и позже.
См. также
-
Удаляет символы в данном диапазоне вместе с их связанными атрибутами.
Объявление
Swift
func deleteCharactersInRange(_
aRange
: NSRange)Objective C
- (void)deleteCharactersInRange:(NSRange)
aRange
Параметры
aRange
Диапазон, указывающий символы для удаления.
Обсуждение
Повышения
NSRangeException
если любая частьaRange
лежит за пределами конца символов получателя.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 3.2 и позже.
-
Устанавливает атрибуты для символов в указанном диапазоне к указанным атрибутам.
Объявление
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
Доступность
Доступный в iOS 3.2 и позже.
-
Добавляет атрибут с именем и значением к символам в указанном диапазоне.
Объявление
Параметры
name
Строка, указывающая название атрибута. Ключи атрибута могут быть предоставлены другой платформой или могут быть пользовательскими, которые Вы определяете. Для получения информации о том, где найти предоставленные систему ключи атрибута, посмотрите раздел обзора в Ссылке класса NSAttributedString.
value
Значение атрибута связалось с
name
.aRange
Диапазон символов, к которым применяется указанная пара атрибут/значение.
Обсуждение
Можно присвоить любого
name
/value
пара Вы желаете к диапазону символов, в дополнение к стандартным атрибутам, описанным в разделе Constants Дополнений NSAttributedString. ПовышенияNSInvalidArgumentException
еслиname
илиvalue
nil
иNSRangeException
если любая частьaRange
лежит за пределами конца символов получателя.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 3.2 и позже.
-
Добавляет данный набор атрибутов к символам в указанном диапазоне.
Объявление
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
Доступность
Доступный в iOS 3.2 и позже.
-
Удаляет именованный атрибут из символов в указанном диапазоне.
Объявление
Параметры
name
Строка, указывающая название атрибута для удаления. Ключи атрибута могут быть предоставлены другой платформой или могут быть пользовательскими, которые Вы определяете. Для получения информации о том, где найти предоставленные систему ключи атрибута, посмотрите раздел обзора в Ссылке класса NSAttributedString.
aRange
Диапазон символов, из которых удален указанный атрибут.
Обсуждение
Повышения
NSRangeException
если любая частьaRange
лежит за пределами конца символов получателя.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 3.2 и позже.
-
Добавляют символы и атрибуты данной приписанной строки до конца получателя.
Объявление
Swift
func appendAttributedString(_
attributedString
: NSAttributedString)Objective C
- (void)appendAttributedString:(NSAttributedString *)
attributedString
Параметры
attributedString
Строка, символы которой и атрибуты добавляются.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 3.2 и позже.
См. также
– insertAttributedString:atIndex:
+ attributedStringWithAttachment:
(Дополнения NSAttributedString) -
Вставляет символы и атрибуты данной приписанной строки в получатель в данном индексе.
Объявление
Swift
func insertAttributedString(_
attributedString
: NSAttributedString, atIndexindex
: Int)Objective C
- (void)insertAttributedString:(NSAttributedString *)
attributedString
atIndex:(NSUInteger)index
Параметры
attributedString
Строка, символы которой и атрибуты вставляются.
index
Индекс, в котором вставляются символы и атрибуты.
Обсуждение
Новые символы и атрибуты начинаются в данном индексе и существующих символах, и атрибуты от индекса до конца получателя смещаются на длину приписанной строки. Повышения
NSRangeException
еслиindex
лежит за пределами конца символов получателя.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 3.2 и позже.
См. также
– appendAttributedString:
+ attributedStringWithAttachment:
(Дополнения NSAttributedString) -
replaceCharactersInRange (_: withAttributedString:) - replaceCharactersInRange:withAttributedString:
Заменяет символы и атрибуты в данном диапазоне с символами и атрибуты данной приписанной строки.
Объявление
Swift
func replaceCharactersInRange(_
aRange
: NSRange, withAttributedStringattributedString
: NSAttributedString)Objective C
- (void)replaceCharactersInRange:(NSRange)
aRange
withAttributedString:(NSAttributedString *)attributedString
Параметры
aRange
Диапазон символов и атрибутов заменяется.
attributedString
Приписанная строка, символы которой и атрибуты заменяют тех в указанном диапазоне.
Обсуждение
Повышения
NSRangeException
если любая частьaRange
лежит за пределами конца символов получателя.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 3.2 и позже.
См. также
-
Заменяет все содержание получателя символами и атрибутами данной приписанной строки.
Объявление
Swift
func setAttributedString(_
attributedString
: NSAttributedString)Objective C
- (void)setAttributedString:(NSAttributedString *)
attributedString
Параметры
attributedString
Приписанная строка, символы которой и атрибуты заменяют тех в получателе.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 3.2 и позже.
См. также
-
Переопределенный подклассами, чтобы буферизовать или оптимизировать серию изменений в символах или атрибутах получателя, пока это не получает соответствие
endEditing
сообщение, относительно которого это может консолидировать изменения и уведомить любых наблюдателей, что изменилось.Объявление
Swift
func beginEditing()
Objective C
- (void)beginEditing
Обсуждение
Можно вложить пар
beginEditing
иendEditing
сообщения.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 3.2 и позже.
-
Переопределенный подклассами для консолидации изменений, внесенных начиная с предыдущего
beginEditing
обменивайтесь сообщениями и уведомлять любых наблюдателей изменений.Объявление
Swift
func endEditing()
Objective C
- (void)endEditing
Обсуждение
NSMutableAttributedString
реализация ничего не делает.NSTextStorage
, например, переопределяет этот метод для вызоваfixAttributesInRange:
и сообщатьNSLayoutManager
объекты, что они должны передать текст.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в iOS 3.2 и позже.
См. также
– processEditing
(NSTextStorage
)