NSString

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

Не применимый

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

Не применимый

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

Доступный в iOS 2.0 и позже.

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

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

Методы, описанные в этом расширении класса, должны использоваться от основного потока Вашего приложения.

Вычисления метрик для одной строки текста

- sizeWithFont: (iOS 7.0)

Возвращает размер строки, если это должно было быть представлено с указанным шрифтом на одной строке.

Оператор осуждения

Использовать sizeWithAttributes: вместо этого.

Объявление

Objective C

- (CGSize)sizeWithFont:(UIFont *)font

Параметры

font

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

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

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

Обсуждение

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

В iOS 6 этот метод обертывает текст с помощью NSLineBreakByWordWrapping опция по умолчанию. В более ранних версиях iOS этот метод не выполняет обертывания строки и возвращает абсолютную ширину и высоту строки с помощью указанного шрифта.

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

Objective C

@import UIKit;

Доступность

Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 7.0.


    
    - sizeWithFont:forWidth:lineBreakMode:

(iOS 7.0)

Возвращает размер строки, если это должно было быть представлено с указанным шрифтом и атрибутами линии на одной строке.

Оператор осуждения

Использовать boundingRectWithSize:options:attributes:context:.

Объявление

Objective C

- (CGSize)sizeWithFont:(UIFont *)font forWidth:(CGFloat)width lineBreakMode:(NSLineBreakMode)lineBreakMode

Параметры

`font`	Шрифт для использования для вычислений размера строки.
`width`	Максимальная приемлемая ширина для строки. Это значение используется для вычисления, куда были бы помещены разрывы строки.
`lineBreakMode`	Опции разрыва строки для вычислений размера строки. Для списка возможных значений посмотрите `NSLineBreakMode`.

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

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

Обсуждение

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

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

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

Objective C

@import UIKit;

Доступность

Доступный в iOS 2.0 и позже.

Осуждаемый в iOS 7.0.


    
    - sizeWithFont:minFontSize:actualFontSize:forWidth:lineBreakMode:

(iOS 7.0)

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

Оператор осуждения

Нет никакой точной альтернативы для этого метода. Инструкции по интерфейсу пользователя препятствуют изменению размера шрифта этот путь, потому что это приводит к противоречивому пользовательскому опыту. Посмотрите UILabel как возможная альтернатива для некоторых вариантов использования.

Объявление

Objective C

- (CGSize)sizeWithFont:(UIFont *)font minFontSize:(CGFloat)minFontSize actualFontSize:(CGFloat *)actualFontSize forWidth:(CGFloat)width lineBreakMode:(NSLineBreakMode)lineBreakMode

Параметры

`font`	Шрифт для использования для вычислений размера строки.
`minFontSize`	Минимальный размер, к которому шрифт может быть сокращен прежде, чем обратиться к усечению текста.
`actualFontSize`	На вводе, указателе на значение с плавающей точкой. По возврату это значение содержит фактический размер шрифта, использовавшийся для вычислений размера строки.
`width`	Максимальная приемлемая ширина для строки. Это значение используется для вычисления, куда были бы помещены разрывы строки.
`lineBreakMode`	Опции разрыва строки для вычислений размера строки. Для списка возможных значений посмотрите `NSLineBreakMode`.

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

Обсуждение

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

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

Objective C

@import UIKit;

Доступность

Доступный в iOS 2.0 и позже.

Осуждаемый в iOS 7.0.

Вычисления метрик для многократных строк текста


    
    - sizeWithFont:constrainedToSize:

(iOS 7.0)

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

Оператор осуждения

Использовать boundingRectWithSize:options:attributes:context: вместо этого. См. также UILabel как возможная альтернатива для некоторых вариантов использования.

Объявление

Objective C

- (CGSize)sizeWithFont:(UIFont *)font constrainedToSize:(CGSize)size

Параметры

`font`	Шрифт для использования для вычислений размера строки.
`size`	Максимальный приемлемый размер для строки. Это значение используется для вычисления, где разрывы строки и обертывание произошли бы.

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

Обсуждение

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

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

Objective C

@import UIKit;

Доступность

Доступный в iOS 2.0 и позже.

Осуждаемый в iOS 7.0.


    
    - sizeWithFont:constrainedToSize:lineBreakMode:

(iOS 7.0)

Возвращает размер строки, если это было представлено с указанными ограничениями.

Оператор осуждения

Использовать boundingRectWithSize:options:attributes:context: вместо этого.

Объявление

Objective C

- (CGSize)sizeWithFont:(UIFont *)font constrainedToSize:(CGSize)size lineBreakMode:(NSLineBreakMode)lineBreakMode

Параметры

`font`	Шрифт для использования для вычислений размера строки.
`size`	Максимальный приемлемый размер для строки. Это значение используется для вычисления, где разрывы строки и обертывание произошли бы.
`lineBreakMode`	Опции разрыва строки для вычислений размера строки. Для списка возможных значений посмотрите `NSLineBreakMode`.

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

Обсуждение

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

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

Objective C

@import UIKit;

Доступность

Доступный в iOS 2.0 и позже.

Осуждаемый в iOS 7.0.

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


    
    - drawAtPoint:withFont:

(iOS 7.0)

Рисует строку в одной строке в указанной точке в текущем графическом контексте с помощью указанного шрифта.

Оператор осуждения

Использовать drawAtPoint:withAttributes: вместо этого.

Объявление

Objective C

- (CGSize)drawAtPoint:(CGPoint)point withFont:(UIFont *)font

Параметры

`point`	Расположение (в системе координат текущего графического контекста), в котором можно нарисовать строку. Эта точка представляет верхний левый угол ограничительной рамки строки.
`font`	Шрифт для использования для рендеринга.

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

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

Обсуждение

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

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

Objective C

@import UIKit;

Доступность

Доступный в iOS 2.0 и позже.

Осуждаемый в iOS 7.0.


    
    - drawAtPoint:forWidth:withFont:lineBreakMode:

(iOS 7.0)

Рисует строку в одной строке в указанной точке в текущем графическом контексте с помощью указанного шрифта и атрибутов.

Оператор осуждения

Использовать drawInRect:withAttributes: вместо этого.

Объявление

Objective C

- (CGSize)drawAtPoint:(CGPoint)point forWidth:(CGFloat)width withFont:(UIFont *)font lineBreakMode:(NSLineBreakMode)lineBreakMode

Параметры

`point`	Расположение (в системе координат текущего графического контекста), в котором можно нарисовать строку. Эта точка представляет верхний левый угол ограничительной рамки строки.
`width`	Максимальная ширина строки.
`font`	Шрифт для использования для рендеринга.
`lineBreakMode`	Опции разрыва строки для вычислений размера строки. Для списка возможных значений посмотрите `NSLineBreakMode`.

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

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

Обсуждение

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

Если значение в width параметр меньше, чем фактическая ширина строки, усечение может произойти. В той ситуации, опциях в lineBreakMode параметр определяет, где закончить текст.

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

Objective C

@import UIKit;

Доступность

Доступный в iOS 2.0 и позже.

Осуждаемый в iOS 7.0.


    
    - drawAtPoint:forWidth:withFont:fontSize:lineBreakMode:baselineAdjustment:

(iOS 7.0)

Оператор осуждения

Использовать drawInRect:withAttributes: вместо этого.

Объявление

Objective C

- (CGSize)drawAtPoint:(CGPoint)point forWidth:(CGFloat)width withFont:(UIFont *)font fontSize:(CGFloat)fontSize lineBreakMode:(NSLineBreakMode)lineBreakMode baselineAdjustment:(UIBaselineAdjustment)baselineAdjustment

Параметры

`point`	Расположение (в системе координат текущего графического контекста), в котором можно нарисовать строку. Эта точка представляет верхний левый угол ограничительной рамки строки.
`width`	Максимальная ширина строки.
`font`	Шрифт для использования для рендеринга.
`fontSize`	Размер шрифта для использования вместо того связался с объектом шрифта в `font` параметр.
`lineBreakMode`	Опции разрыва строки для вычислений размера строки. Для списка возможных значений посмотрите `NSLineBreakMode`.
`baselineAdjustment`	Указывает правило внесения поправок вертикального текста для использования. Это правило используется для определения позиции текста в случаях, где текст должен быть составлен в меньшем размере.

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

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

Обсуждение

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

Objective C

@import UIKit;

Доступность

Доступный в iOS 2.0 и позже.

Осуждаемый в iOS 7.0.

См. также

– sizeWithFont:minFontSize:actualFontSize:forWidth:lineBreakMode:


    
    - drawAtPoint:forWidth:withFont:minFontSize:actualFontSize:lineBreakMode:baselineAdjustment:

(iOS 7.0)

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

Оператор осуждения

Использовать drawInRect:withAttributes: вместо этого.

Объявление

Objective C

- (CGSize)drawAtPoint:(CGPoint)point forWidth:(CGFloat)width withFont:(UIFont *)font minFontSize:(CGFloat)minFontSize actualFontSize:(CGFloat *)actualFontSize lineBreakMode:(NSLineBreakMode)lineBreakMode baselineAdjustment:(UIBaselineAdjustment)baselineAdjustment

Параметры

`point`	Расположение (в системе координат текущего графического контекста), в котором можно нарисовать строку. Эта точка представляет верхний левый угол ограничительной рамки строки.
`width`	Максимальная ширина строки.
`font`	Шрифт для использования для рендеринга.
`minFontSize`	Минимальный размер, к которому шрифт может быть сокращен прежде, чем обратиться к усечению текста.
`actualFontSize`	На вводе, указателе на значение с плавающей точкой. По возврату это значение содержит фактический размер шрифта, использовавшийся для рендеринга строки.
`lineBreakMode`	Опции разрыва строки для вычислений размера строки. Для списка возможных значений посмотрите `NSLineBreakMode`.
`baselineAdjustment`	Указывает правило внесения поправок вертикального текста для использования. Это правило используется для определения позиции текста в случаях, где текст должен быть составлен в меньшем размере.

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

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

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

Objective C

@import UIKit;

Доступность

Доступный в iOS 2.0 и позже.

Осуждаемый в iOS 7.0.


    
    drawAtPoint (_: withAttributes:)
    - drawAtPoint:withAttributes:

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

Объявление

Swift

func drawAtPoint(_ point: CGPoint, withAttributes attrs: [NSObject : AnyObject]?)

Objective C

- (void)drawAtPoint:(CGPoint)point withAttributes:(NSDictionary *)attrs

Параметры

`point`	Точка в текущем графическом контексте, где Вы хотите начать рисовать строку. Система координат графического контекста обычно определяется представлением, в котором Вы рисуете.
`attrs`	Словарь текста приписывает, чтобы быть примененным к строке. Это те же атрибуты, которым можно примениться к `NSAttributedString` объект, но в случае `NSString` объекты, атрибуты применяются ко всей строке, а не диапазонам в строке.

Обсуждение

Ширина (высота для вертикального макета) области рендеринга неограниченна в отличие от этого drawInRect:withAttributes:, который использует ограничительный прямоугольник. В результате этот метод представляет текст в одной строке. Однако, если символы новой строки присутствуют в строке, те символы соблюдают и заставляют последующий текст быть помещенным в следующую строку под начальной точкой.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 7.0 и позже.

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


    
    - drawInRect:withFont:

(iOS 7.0)

Рисует строку в текущем графическом контексте с помощью указанного ограничительного прямоугольника и шрифта.

Оператор осуждения

Использовать drawInRect:withAttributes: вместо этого.

Объявление

Objective C

- (CGSize)drawInRect:(CGRect)rect withFont:(UIFont *)font

Параметры

`rect`	Ограничительный прямоугольник (в текущем графическом контексте), в котором можно нарисовать строку.
`font`	Шрифт для использования для рендеринга.

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

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

Обсуждение

Этот метод рисует как можно больше строки использование данного шрифта и ограничений. Этот метод использует UILineBreakModeWordWrap режим разрыва строки и UITextAlignmentLeft выравнивание.

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

Objective C

@import UIKit;

Доступность

Доступный в iOS 2.0 и позже.

Осуждаемый в iOS 7.0.


    
    - drawInRect:withFont:lineBreakMode:

(iOS 7.0)

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

Оператор осуждения

Использовать drawInRect:withAttributes: вместо этого.

Объявление

Objective C

- (CGSize)drawInRect:(CGRect)rect withFont:(UIFont *)font lineBreakMode:(NSLineBreakMode)lineBreakMode

Параметры

`rect`	Ограничительный прямоугольник (в текущем графическом контексте), в котором можно нарисовать строку.
`font`	Шрифт для использования для рендеринга.
`lineBreakMode`	Опции разрыва строки для вычислений размера строки. Для списка возможных значений посмотрите `NSLineBreakMode`.

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

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

Обсуждение

Этот метод рисует как можно больше строки использование данного шрифта, режима разрыва строки и ограничений размера. Текст составлен с помощью UITextAlignmentLeft выравнивание.

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

Objective C

@import UIKit;

Доступность

Доступный в iOS 2.0 и позже.

Осуждаемый в iOS 7.0.


    
    - drawInRect:withFont:lineBreakMode:alignment:

(iOS 7.0)

Оператор осуждения

Использовать drawInRect:withAttributes: вместо этого.

Объявление

Objective C

- (CGSize)drawInRect:(CGRect)rect withFont:(UIFont *)font lineBreakMode:(NSLineBreakMode)lineBreakMode alignment:(NSTextAlignment)alignment

Параметры

`rect`	Ограничительный прямоугольник (в текущем графическом контексте), в котором можно нарисовать строку.
`font`	Шрифт для использования для рендеринга.
`lineBreakMode`	Опции разрыва строки для вычислений размера строки. Для списка возможных значений посмотрите `NSLineBreakMode`.
`alignment`	Выравнивание текста в ограничительном прямоугольнике. Для списка возможных значений посмотрите UITextAlignment.

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

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

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

Objective C

@import UIKit;

Доступность

Доступный в iOS 2.0 и позже.

Осуждаемый в iOS 7.0.


    
    boundingRectWithSize (_: options:attributes:context:)
    - boundingRectWithSize:options:attributes:context:

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

Объявление

Swift

func boundingRectWithSize(_ size: CGSize, options options: NSStringDrawingOptions, attributes attributes: [NSObject : AnyObject]!, context context: NSStringDrawingContext!) -> CGRect

Objective C

- (CGRect)boundingRectWithSize:(CGSize)size options:(NSStringDrawingOptions)options attributes:(NSDictionary *)attributes context:(NSStringDrawingContext *)context

Параметры

`size`	Размер прямоугольника для подхождения к концу.
`options`	Строковые опции рисования.
`attributes`	Словарь текста приписывает, чтобы быть примененным к строке. Это те же атрибуты, которым можно примениться к `NSAttributedString` объект, но в случае `NSString` объекты, атрибуты применяются ко всей строке, а не диапазонам в строке.
`context`	Строковый контекст рисования для использования для получателя, указание минимального масштабного коэффициента и отслеживание корректировок.

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

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

Обсуждение

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

Этот метод возвращает дробные размеры (в size компонент возвращенного CGRect); для использования возвращенного размера для калибровки представлений необходимо повысить его значение до самого близкого более высокого целого числа с помощью ceil функция.

Этот метод возвращает фактические границы глифов в строке. Некоторым глифам (пробелы, например) позволяют наложиться, ограничения макета, указанные размером, передали в, так в некоторых случаях значение ширины компонента размера возвращенного CGRect может превысить значение ширины size параметр.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 7.0 и позже.

См. также

– drawInRect:withAttributes:


    
    drawInRect (_: withAttributes:)
    - drawInRect:withAttributes:

Рисует приписанную строку в указанном ограничительном прямоугольнике в текущем графическом контексте.

Объявление

Swift

func drawInRect(_ rect: CGRect, withAttributes attrs: [NSObject : AnyObject]?)

Objective C

- (void)drawInRect:(CGRect)rect withAttributes:(NSDictionary *)attrs

Параметры

`rect`	Ограничительный прямоугольник, в котором можно нарисовать строку.
`attrs`	Текст приписывает, с которым можно нарисовать строку. Это те же атрибуты, которым можно примениться к `NSAttributedString` объект, но в случае `NSString` объекты, атрибуты применяются ко всей строке, а не диапазонам в строке.

Обсуждение

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

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 7.0 и позже.


    
    drawWithRect (_: options:attributes:context:)
    - drawWithRect:options:attributes:context:

Рисует приписанную строку в указанном ограничительном прямоугольнике с помощью предоставленных возможностей.

Объявление

Swift

func drawWithRect(_ rect: CGRect, options options: NSStringDrawingOptions, attributes attributes: [NSObject : AnyObject]!, context context: NSStringDrawingContext!)

Objective C

- (void)drawWithRect:(CGRect)rect options:(NSStringDrawingOptions)options attributes:(NSDictionary *)attributes context:(NSStringDrawingContext *)context

Параметры

`rect`	Ограничительный прямоугольник, в котором можно нарисовать строку.
`options`	Дополнительные опции получения примениться к строке во время рендеринга. Для списка возможных значений посмотрите `NSStringDrawingOptions`.
`attributes`	Текст приписывает, с которым можно нарисовать строку. Это те же атрибуты, которым можно примениться к `NSAttributedString` объект, но в случае `NSString` объекты, атрибуты применяются ко всей строке, а не диапазонам в строке.
`context`	Объект контекста с информацией о том, как скорректировать шрифт отслеживающая и масштабирующаяся информация. По возврату указанный объект содержит информацию о фактических значениях, используемых для рендеринга строки. Этот параметр может быть `nil`.

Обсуждение

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

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

Специальные замечания

Этот метод использует базовый источник по умолчанию.

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 7.0 и позже.


    
    sizeWithAttributes (_:)
    - sizeWithAttributes:

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

Объявление

Swift

func sizeWithAttributes(_ attrs: [NSObject : AnyObject]?) -> CGSize

Objective C

- (CGSize)sizeWithAttributes:(NSDictionary *)attrs

Параметры


      attrs

Словарь текста приписывает, чтобы быть примененным к строке. Это те же атрибуты, которым можно примениться к NSAttributedString объект, но в случае NSString объекты, атрибуты применяются ко всей строке, а не диапазонам в строке.

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

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

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 7.0 и позже.

Константы

UILineBreakMode
Опции для обертывания и усечения текста.

Использовать NSLineBreakMode вместо этого.

Объявление

Objective C

typedef enum { UILineBreakModeWordWrap = 0, UILineBreakModeCharacterWrap, UILineBreakModeClip, UILineBreakModeHeadTruncation, UILineBreakModeTailTruncation, UILineBreakModeMiddleTruncation, } UILineBreakMode;

Константы
- UILineBreakModeWordWrap
  
  Оберните или отсеките строку только на границах слова. Это - опция обертывания значения по умолчанию.
  Использовать NSLineBreakByWordWrapping вместо этого.
  
  Доступный в iOS 2.0 и позже.
  Осуждаемый в iOS 6.0.
- UILineBreakModeCharacterWrap
  
  Оберните или отсеките строку на самой близкой символьной границе.
  Использовать NSLineBreakByCharWrapping вместо этого.
  
  Доступный в iOS 2.0 и позже.
  Осуждаемый в iOS 6.0.
- UILineBreakModeClip
  
  Отсеките текст, когда будет достигнут конец прямоугольника получения. Эта опция могла привести к частично представленному символу в конце строки.
  Использовать NSLineBreakByClipping вместо этого.
  
  Доступный в iOS 2.0 и позже.
  Осуждаемый в iOS 6.0.
- UILineBreakModeHeadTruncation
  
  Усеченный текст (по мере необходимости) с начала строки. Для многократных строк текста только текст на первой строке является усеченным.
  Использовать NSLineBreakByTruncatingHead вместо этого.
  
  Доступный в iOS 2.0 и позже.
  Осуждаемый в iOS 6.0.
- UILineBreakModeTailTruncation
  
  Усеченный текст (по мере необходимости) от конца строки. Для многократных строк текста только текст на последней строке является усеченным.
  Использовать NSLineBreakByTruncatingTail вместо этого.
  
  Доступный в iOS 2.0 и позже.
  Осуждаемый в iOS 6.0.
- UILineBreakModeMiddleTruncation
  
  Усеченный текст (по мере необходимости) с середины строки. Для многократных строк текста текст является усеченным только в средней точке строки.
  Использовать NSLineBreakByTruncatingMiddle вместо этого.
  
  Доступный в iOS 2.0 и позже.
  Осуждаемый в iOS 6.0.
Обсуждение

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

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

Objective C

@import UIKit;

Доступность

Доступный в iOS 2.0 и позже.
NSTextAlignment
Опции для выравнивания текста горизонтально.

Объявление

Swift

enum NSTextAlignment : Int { case Left case Center case Right case Justified case Natural }

Objective C

enum { NSTextAlignmentLeft = 0, NSTextAlignmentCenter = 1, NSTextAlignmentRight = 2, NSTextAlignmentJustified = 3, NSTextAlignmentNatural = 4, }; typedef NSInteger NSTextAlignment;

Константы
- Left
  
  NSTextAlignmentLeft
  
  Выровняйте текст вдоль левого края.
  
  Доступный в iOS 6.0 и позже.
- Center
  
  NSTextAlignmentCenter
  
  Выровняйте текст одинаково вдоль обеих сторон осевой линии.
  
  Доступный в iOS 6.0 и позже.
- Right
  
  NSTextAlignmentRight
  
  Выровняйте текст вдоль правого края.
  
  Доступный в iOS 6.0 и позже.
- Justified
  
  NSTextAlignmentJustified
  
  Полностью выровняйте текст так, чтобы последняя строка в абзаце была естественная выровненный.
  
  Доступный в iOS 6.0 и позже.
- Natural
  
  NSTextAlignmentNatural
  
  Используйте выравнивание по умолчанию, связанное с текущим сценарием.
  
  Доступный в iOS 6.0 и позже.
Оператор импорта

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 6.0 и позже.
UITextAlignment
Опции для выравнивания текста горизонтально.

Использовать “NSTextAlignment” вместо этого.

Объявление

Objective C

typedef enum { UITextAlignmentLeft, UITextAlignmentCenter, UITextAlignmentRight, } UITextAlignment;

Константы
- UITextAlignmentLeft
  
  Выровняйте текст вдоль левого края.
  Использовать NSTextAlignmentLeft вместо этого.
  
  Доступный в iOS 2.0 и позже.
  Осуждаемый в iOS 6.0.
- UITextAlignmentCenter
  
  Выровняйте текст одинаково вдоль обеих сторон осевой линии.
  Использовать NSTextAlignmentCenter вместо этого.
  
  Доступный в iOS 2.0 и позже.
  Осуждаемый в iOS 6.0.
- UITextAlignmentRight
  
  Выровняйте текст вдоль правого края.
  Использовать NSTextAlignmentRight вместо этого.
  
  Доступный в iOS 2.0 и позже.
  Осуждаемый в iOS 6.0.
Оператор импорта

Objective C

@import UIKit;

Доступность

Доступный в iOS 2.0 и позже.
UIBaselineAdjustment
Вертикальные опции корректировки.

Объявление

Swift

enum UIBaselineAdjustment : Int { case AlignBaselines case AlignCenters case None }

Objective C

typedef enum { UIBaselineAdjustmentAlignBaselines, UIBaselineAdjustmentAlignCenters, UIBaselineAdjustmentNone, } UIBaselineAdjustment;

Константы
- AlignBaselines
  
  UIBaselineAdjustmentAlignBaselines
  
  Скорректируйте текст относительно позиции его базовой линии.
  
  Доступный в iOS 2.0 и позже.
- AlignCenters
  
  UIBaselineAdjustmentAlignCenters
  
  Скорректируйте текст, базируемый относительно центра его ограничительной рамки.
  
  Доступный в iOS 2.0 и позже.
- None
  
  UIBaselineAdjustmentNone
  
  Скорректируйте текст относительно верхнего левого угла ограничительной рамки. Это - корректировка по умолчанию.
  
  Доступный в iOS 2.0 и позже.
Обсуждение

Базовые опции корректировки определяют, как скорректировать позицию текста в случаях, где текст должен быть составлен с помощью различного размера шрифта, чем один первоначально указанный. Например, с UIBaselineAdjustmentAlignBaselines в то время как текст, кажется, перемещается к той базовой линии, опция, позиция базовой линии остается фиксированной в своем начальном расположении. Точно так же UIBaselineAdjustmentNone опция заставляет его появиться, как будто текст перемещается вверх к верхнему левому углу ограничительной рамки.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 2.0 и позже.
NSWritingDirection
Константы для указания направления записи для использования.

Объявление

Swift

enum NSWritingDirection : Int { case Natural case LeftToRight case RightToLeft }

Objective C

enum { NSWritingDirectionNatural = -1, NSWritingDirectionLeftToRight = 0, NSWritingDirectionRightToLeft = 1 }; typedef NSInteger NSWritingDirection;

Константы
- Natural
  
  NSWritingDirectionNatural
  
  Используйте Unicode правила P2 и P3 алгоритма Bidi определить который направление использовать.
  
  Доступный в iOS 6.0 и позже.
- LeftToRight
  
  NSWritingDirectionLeftToRight
  
  Используйте левое для правильного направления записи.
  
  Доступный в iOS 6.0 и позже.
- RightToLeft
  
  NSWritingDirectionRightToLeft
  
  Используйте справа налево направление записи.
  
  Доступный в iOS 6.0 и позже.
Оператор импорта

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 6.0 и позже.
Ключи для текста приписывают словари
Ключи для словарей, содержащих текстовые атрибуты.

Объявление

Objective C

NSString *const UITextAttributeFont; NSString *const UITextAttributeTextColor; NSString *const UITextAttributeTextShadowColor; NSString *const UITextAttributeTextShadowOffset;

Константы
- UITextAttributeFont
  
  Ключ к шрифту в тексте приписывает словарь.
  
  Соответствующее значение является экземпляром UIFont.
  
  Используйте шрифт с размером 0.0 получить размер стандартного шрифта для текущего контекста.
  
  Доступный в iOS 5.0 и позже.
  Осуждаемый в iOS 7.0.
- UITextAttributeTextColor
  
  Ключ к цвету текста в тексте приписывает словарь.
  
  Соответствующее значение является экземпляром UIColor.
  
  Доступный в iOS 5.0 и позже.
  Осуждаемый в iOS 7.0.
- UITextAttributeTextShadowColor
  
  Ключ к текстовому цвету тени в тексте приписывает словарь.
  
  Соответствующее значение является экземпляром UIColor.
  
  Доступный в iOS 5.0 и позже.
  Осуждаемый в iOS 7.0.
- UITextAttributeTextShadowOffset
  
  Ключ к смещению, используемому для текстовой тени в тексте, приписывает словарь.
  
  Соответствующее значение является экземпляром NSValue обертывание a UIOffset структура.
  
  Доступный в iOS 5.0 и позже.
  Осуждаемый в iOS 7.0.