NSString

Приложение Кит добавляет три метода к NSString класс для поддержки строки получения возражает непосредственно в NSView экземпляр: drawAtPoint:withAttributes:, drawInRect:withAttributes:, и sizeWithAttributes:.

Приложение Кит добавляет похожие методы для NSAttributedString класс, описанный в дополнительной NSAttributedString AppKit Ссылке. Эти два метода рисования рисуют строковый объект с единственным набором атрибутов, применяющихся ко всей строке. Для рисования строки с многократными атрибутами, такими как многократные шрифты текста, необходимо использовать приписанную строку.

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

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

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

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Рисование строковых объектов


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

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

Объявление

Swift

func drawAtPoint(_ aPoint: NSPoint, withAttributes attributes: [NSObject : AnyObject]?)

Objective C

- (void)drawAtPoint:(NSPoint)aPoint withAttributes:(NSDictionary *)attributes

Параметры


      aPoint

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


      attributes

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

Обсуждение

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

Необходимо только вызвать этот метод когда NSView объект фокусируется.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

drawInRect:withAttributes: (NSView)
drawWithRect:options:attributes:
lockFocus


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

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

Объявление

Swift

func drawInRect(_ aRect: NSRect, withAttributes attributes: [NSObject : AnyObject]?)

Objective C

- (void)drawInRect:(NSRect)aRect withAttributes:(NSDictionary *)attributes

Параметры

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

Обсуждение

Область рендеринга ограничена aRect, в отличие от этого drawAtPoint:withAttributes:, который имеет неограниченную ширину. В результате этот метод представляет текст в многократных строках.

Необходимо только вызвать этот метод когда NSView объект фокусируется.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

drawAtPoint:withAttributes: (NSView)
drawWithRect:options:attributes:
lockFocus


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

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

Объявление

Swift

func drawWithRect(_ rect: NSRect, options options: NSStringDrawingOptions, attributes attributes: [NSObject : AnyObject]?)

Objective C

- (void)drawWithRect:(NSRect)rect options:(NSStringDrawingOptions)options attributes:(NSDictionary *)attributes

Параметры

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

Обсуждение

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

size поле указывает текстовый размер контейнера. width часть поля размера указывает максимальную ширину фрагмента строки, если больше, чем 0.0. height определяет максимальный размер, который может быть занят текстом, если больше, чем 0.0 и NSStringDrawingUsesLineFragmentOrigin указан. Если NSStringDrawingUsesLineFragmentOrigin не указан, высота проигнорирована и считавший однострочный рендеринг (NSLineBreakByWordWrapping и NSLineBreakByCharWrapping обрабатываются как NSLineBreakByClipping).

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

drawAtPoint:withAttributes: (NSView)
drawInRect:withAttributes:
lockFocus


    
    sizeWithAttributes (_:)
    - sizeWithAttributes:

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

Объявление

Swift

func sizeWithAttributes(_ attributes: [NSObject : AnyObject]?) -> NSSize

Objective C

- (NSSize)sizeWithAttributes:(NSDictionary *)attributes

Параметры


      attributes

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Получение ограничения rect представленных строк


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

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

Объявление

Swift

func boundingRectWithSize(_ size: NSSize, options options: NSStringDrawingOptions, attributes attributes: [NSObject : AnyObject]?) -> NSRect

Objective C

- (NSRect)boundingRectWithSize:(NSSize)size options:(NSStringDrawingOptions)options attributes:(NSDictionary *)attributes

Параметры

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

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

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

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

drawInRect:withAttributes:
drawWithRect:options:attributes:

Константы

NSStringDrawingOptions
Следующие константы предоставлены как рендеринг опций для строки, когда он нарисован.

Объявление

Swift

struct NSStringDrawingOptions : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var TruncatesLastVisibleLine: NSStringDrawingOptions { get } static var UsesLineFragmentOrigin: NSStringDrawingOptions { get } static var UsesFontLeading: NSStringDrawingOptions { get } static var DisableScreenFontSubstitution: NSStringDrawingOptions { get } static var UsesDeviceMetrics: NSStringDrawingOptions { get } static var OneShot: NSStringDrawingOptions { get } }

Objective C

enum { NSStringDrawingUsesLineFragmentOrigin = (1 << 0), NSStringDrawingUsesFontLeading = (1 << 1), NSStringDrawingDisableScreenFontSubstitution = (1 << 2), NSStringDrawingUsesDeviceMetrics = (1 << 3), NSStringDrawingOneShot = (1 << 4), NSStringDrawingTruncatesLastVisibleLine = (1 << 5) }; typedef NSInteger NSStringDrawingOptions;

Константы
- UsesLineFragmentOrigin
  
  NSStringDrawingUsesLineFragmentOrigin
  
  Указанный источник является источником фрагмента строки, не базовым источником.
  
  Доступный в OS X v10.4 и позже.
- UsesFontLeading
  
  NSStringDrawingUsesFontLeading
  
  Использует продвижение шрифта для вычисления высот строки.
  
  Доступный в OS X v10.4 и позже.
- DisableScreenFontSubstitution
  
  NSStringDrawingDisableScreenFontSubstitution
  
  Отключите экранную замену шрифтов (эквивалентный [NSLayoutManager setUsesScreenFonts:NO]).
  
  Доступный в OS X v10.4 и позже.
- UsesDeviceMetrics
  
  NSStringDrawingUsesDeviceMetrics
  
  Использование отображает границы глифа вместо типографских границ.
  
  Доступный в OS X v10.4 и позже.
- OneShot
  
  NSStringDrawingOneShot
  
  Подавляет кэширующуюся информацию макета.
  
  Доступный в OS X v10.4 и позже.
- TruncatesLastVisibleLine
  
  NSStringDrawingTruncatesLastVisibleLine
  
  Если текст не вписывается в указанные границы, усекает и добавляет символ замещающего знака к последней видимой строке.
  
  Эта опция проигнорирована если NSStringDrawingUsesLineFragmentOrigin также не установлен. Кроме того, режим разрыва строки должен быть также NSLineBreakByWordWrapping или NSLineBreakByCharWrapping для этой опции вступить в силу. Режим разрыва строки может быть указан в стиле абзаца, переданном в параметре словаря атрибутов методов рисования.
  
  Доступный в OS X v10.5 и позже.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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