NSTypesetter

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

Разделение на подклассы примечаний

NSTypesetter предоставляет конкретным подклассам реализацию по умолчанию, взаимодействующую через интерфейс с текстовой системой Какао. Путем разделения на подклассы NSTypesetter, приложение может переопределить layoutParagraphAtPoint: метод для интеграции пользовательского наборного механизма в текстовую систему Какао. С другой стороны, приложение может разделить на подклассы NSATSTypesetter и переопределите интерфейс хранения глифа для интеграции конкретного подкласса в его собственную систему расположения.

NSTypesetter методы принадлежат трем категориям: методы интерфейса хранения глифа, методы интерфейса фазы макета и базовые методы наборного устройства. Методы интерфейса хранения глифа отображаются на NSLayoutManager методы. Само наборное устройство вызывает эти методы, и их реализации по умолчанию вызывают менеджера по расположению Какао. NSTypesetter подкласс может переопределить эти методы для вызова его собственного склада глифа, когда он должен переопределить всех их. (Это не устраняет переопределенный метод, вызывая его реализацию суперкласса в подходящих случаях.)

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

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

Интерфейс хранения глифа

Переопределите эти методы для использования NSTypesetterвстроенный конкретный подкласс, NSATSTypesetter, с пользовательской системой хранения и расположения глифа кроме менеджера по расположению Какао и текстового механизма контейнера.

characterRangeForGlyphRange:actualGlyphRange:
glyphRangeForCharacterRange:actualCharacterRange:
getGlyphsInRange:glyphs:characterIndexes:glyphInscriptions:elasticBits:bidiLevels:
getLineFragmentRect:usedRect:remainingRect:forStartingGlyphAtIndex:proposedRect:lineSpacing:paragraphSpacingBefore:paragraphSpacingAfter:
setLineFragmentRect:forGlyphRange:usedRect:baselineOffset:
substituteGlyphsInRange:withGlyphs:
insertGlyph:atGlyphIndex:characterIndex:
deleteGlyphsInRange:
setNotShownAttribute:forGlyphRange:
setDrawsOutsideLineFragment:forGlyphRange:
setLocation:withAdvancements:forStartOfGlyphRange:
setAttachmentSize:forGlyphRange:
setBidiLevels:forGlyphRange:

Интерфейс фазы макета

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

willSetLineFragmentRect:forGlyphRange:usedRect:baselineOffset:
shouldBreakLineByWordBeforeCharacterAtIndex:
shouldBreakLineByHyphenatingBeforeCharacterAtIndex:
hyphenationFactorForGlyphAtIndex:
hyphenCharacterForGlyphAtIndex:
boundingBoxForControlGlyphAtIndex:forTextContainer:proposedLineFragment:glyphPosition:characterIndex:

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

NSObject
NSTypesetter
NSATSTypesetter

NSObject
NSTypesetter
NSATSTypesetter

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

AnyObject
CVarArgType
Equatable
Hashable
NSObjectProtocol
Печатаемый
NSObject

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Получение наборного устройства

sharedSystemTypesetter () + sharedSystemTypesetter

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

Объявление

Swift

class func sharedSystemTypesetter() -> AnyObject

Objective C

+ (id)sharedSystemTypesetter

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

Совместно используемое системное наборное устройство. Это наборное устройство повторно используемо.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
sharedSystemTypesetterForBehavior (_:) + sharedSystemTypesetterForBehavior:

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

Объявление

Swift

class func sharedSystemTypesetterForBehavior(_ theBehavior: NSTypesetterBehavior) -> AnyObject

Objective C

+ (id)sharedSystemTypesetterForBehavior:(NSTypesetterBehavior)theBehavior

Параметры

theBehavior

Желаемое поведение.

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

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

Обсуждение

Возможные возвращаемые значения описаны в NSTypesetterBehavior раздел для NSLayoutManager.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setTypesetterBehavior:
– typesetterBehavior

Получение информации о наборном устройстве

defaultTypesetterBehavior () + defaultTypesetterBehavior

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

Объявление

Swift

class func defaultTypesetterBehavior() -> NSTypesetterBehavior

Objective C

+ (NSTypesetterBehavior)defaultTypesetterBehavior

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

Поведение наборного устройства по умолчанию.

Обсуждение

Возможные возвращаемые значения описаны в NSTypesetterBehavior раздел для NSLayoutManager.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Получение информации о глифах


    
    printingAdjustmentInLayoutManager (_: forNominallySpacedGlyphRange:packedGlyphs:count:)
    + printingAdjustmentInLayoutManager:forNominallySpacedGlyphRange:packedGlyphs:count:

Возвращает интервал межглифа в указанном диапазоне, когда отправлено в принтер.

Объявление

Swift

class func printingAdjustmentInLayoutManager(_ layoutMgr: NSLayoutManager, forNominallySpacedGlyphRange nominallySpacedGlyphsRange: NSRange, packedGlyphs packedGlyphs: UnsafePointer<UInt8>, count packedGlyphsCount: Int) -> NSSize

Objective C

+ (NSSize)printingAdjustmentInLayoutManager:(NSLayoutManager *)layoutMgr forNominallySpacedGlyphRange:(NSRange)nominallySpacedGlyphsRange packedGlyphs:(const unsigned char *)packedGlyphs count:(NSUInteger)packedGlyphsCount

Параметры

`layoutMgr`	Менеджер по расположению, который сделает получение.
`nominallySpacedGlyphsRange`	Диапазон глифов, интервал которых желаем.
`packedGlyphs`	Глифы, поскольку они упаковываются для отправки, которая будет нарисована в `layoutMgr`.
`packedGlyphsCount`	Число глифов в `packedGlyphs`.

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    baselineOffsetInLayoutManager (_: glyphIndex:)
    - baselineOffsetInLayoutManager:glyphIndex:

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

Объявление

Swift

func baselineOffsetInLayoutManager(_ layoutMgr: NSLayoutManager, glyphIndex glyphIndex: Int) -> CGFloat

Objective C

- (CGFloat)baselineOffsetInLayoutManager:(NSLayoutManager *)layoutMgr glyphIndex:(NSUInteger)glyphIndex

Параметры

`layoutMgr`	Менеджер по расположению используется для получения.
`glyphIndex`	Индекс рассматриваемого глифа.

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

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

Обсуждение

Текстовая система использует это значение для вычисления вертикальной позиции подчеркиваний.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Управление менеджером по расположению

layoutManager - layoutManager

Возвращает менеджера по расположению по набираемому тексту.

Объявление

Swift

unowned(unsafe) var layoutManager: NSLayoutManager? { get }

Objective C

@property(readonly, assign) NSLayoutManager *layoutManager

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    setUsesFontLeading:
    - setUsesFontLeading:

Наборы, использует ли наборное устройство продвижение (или разрыв строки) значение, указанное в информации о метрике шрифта.

Объявление

Swift

var usesFontLeading: Bool

Objective C

@property BOOL usesFontLeading

Параметры


      flag

YEStrue использовать информацию в метриках шрифта, NOfalse проигнорировать его.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– usesFontLeading

usesFontLeading - usesFontLeading

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

Объявление

Swift

var usesFontLeading: Bool

Objective C

@property BOOL usesFontLeading

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

YEStrue если это использует информацию в метриках шрифта, NOfalse иначе.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setUsesFontLeading:
setTypesetterBehavior: - setTypesetterBehavior:

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

Объявление

Swift

var typesetterBehavior: NSTypesetterBehavior

Objective C

@property NSTypesetterBehavior typesetterBehavior

Параметры

behavior

Новое поведение.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– typesetterBehavior
typesetterBehavior - typesetterBehavior

Возвращает текущее поведение наборного устройства.

Объявление

Swift

var typesetterBehavior: NSTypesetterBehavior

Objective C

@property NSTypesetterBehavior typesetterBehavior

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

Текущее поведение наборного устройства.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setTypesetterBehavior:


    
    setHyphenationFactor:
    - setHyphenationFactor:

Когда расстановка переносов опробована, устанавливает пороговое управление.

Объявление

Swift

var hyphenationFactor: Float

Objective C

@property float hyphenationFactor

Параметры


      factor

Фактор частоты в диапазоне 0,0 к 1,0. По умолчанию значение 0.0, означая, что расстановка переносов выключена. A factor из 1,0 расстановок переносов причин, которые будут всегда пробоваться.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– hyphenationFactor

hyphenationFactor - hyphenationFactor

Возвращает текущий фактор расстановки переносов.

Объявление

Swift

var hyphenationFactor: Float

Objective C

@property float hyphenationFactor

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setHyphenationFactor:

Управление текстовыми контейнерами

currentTextContainer - currentTextContainer

Возвращает текстовый контейнер для набираемого текста.

Объявление

Swift

unowned(unsafe) var currentTextContainer: NSTextContainer? { get }

Objective C

@property(readonly, assign) NSTextContainer *currentTextContainer

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– textContainers
textContainers - textContainers

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

Объявление

Swift

var textContainers: [AnyObject]? { get }

Objective C

@property(readonly, assign) NSArray *textContainers

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– layoutManager
– currentTextContainer


    
    setLineFragmentPadding:
    - setLineFragmentPadding:

Устанавливает сумму (в точках), которым текст вставляется в прямоугольниках фрагмента строки.

Объявление

Swift

var lineFragmentPadding: CGFloat

Objective C

@property CGFloat lineFragmentPadding

Параметры


      padding

Сумма (в точках), которым текст вставляется в прямоугольниках фрагмента строки.

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– lineFragmentPadding

lineFragmentPadding - lineFragmentPadding

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

Объявление

Swift

var lineFragmentPadding: CGFloat

Objective C

@property CGFloat lineFragmentPadding

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

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

Обсуждение

Текст вставляется в прямоугольнике фрагмента строки этой суммой.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setLineFragmentPadding:

Отображение экрана и шрифтов принтера

substituteFontForFont (_:) - substituteFontForFont:

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

Объявление

Swift

func substituteFontForFont(_ originalFont: NSFont) -> NSFont

Objective C

- (NSFont *)substituteFontForFont:(NSFont *)originalFont

Параметры

originalFont

Исходный шрифт.

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

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Обработка управляющих символов


    
    textTabForGlyphLocation (_: writingDirection:maxLocation:)
    - textTabForGlyphLocation:writingDirection:maxLocation:

Возвращает текстовую вкладку, затем самую близкую к данному расположению глифа в данных параметрах.

Объявление

Swift

func textTabForGlyphLocation(_ glyphLocation: CGFloat, writingDirection direction: NSWritingDirection, maxLocation maxLocation: CGFloat) -> NSTextTab?

Objective C

- (NSTextTab *)textTabForGlyphLocation:(CGFloat)glyphLocation writingDirection:(NSWritingDirection)direction maxLocation:(CGFloat)maxLocation

Параметры

`glyphLocation`	Расположение, в котором можно начать искать.
`direction`	Направление, в котором можно искать.
`maxLocation`	Максимальное расположение для поиска.

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

Текстовая вкладка, затем самая близкая к glyphLocation, индексация в direction но не вне maxLocation.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

actionForControlCharacterAtIndex (_:) - actionForControlCharacterAtIndex:

Возвращает действие, связанное с управляющим символом.

Объявление

Swift

func actionForControlCharacterAtIndex(_ charIndex: Int) -> NSTypesetterControlCharacterAction

Objective C

- (NSTypesetterControlCharacterAction)actionForControlCharacterAtIndex:(NSUInteger)charIndex

Параметры

charIndex

Индекс управляющего символа.

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

Действие связалось с управляющим символом в charIndex.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Обработка двунаправленного текста

setBidiProcessingEnabled: - setBidiProcessingEnabled:

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

Объявление

Swift

var bidiProcessingEnabled: Bool

Objective C

@property BOOL bidiProcessingEnabled

Параметры

flag

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– bidiProcessingEnabled
bidiProcessingEnabled - bidiProcessingEnabled

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

Объявление

Swift

var bidiProcessingEnabled: Bool

Objective C

@property BOOL bidiProcessingEnabled

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

YEStrue если обработка двунаправленного текста включена, NOfalse иначе.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setBidiProcessingEnabled:

Доступ к абзацу наборная информация

currentParagraphStyle - currentParagraphStyle

Возвращает объект стиля абзаца для набираемого текста.

Объявление

Swift

@NSCopying var currentParagraphStyle: NSParagraphStyle? { get }

Objective C

@property(readonly, copy) NSParagraphStyle *currentParagraphStyle

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    setAttributedString:
    - setAttributedString:

Устанавливает текстовое запоминающее устройство, на которое воздействует это наборное устройство.

Объявление

Swift

unowned(unsafe) var attributedString: NSAttributedString?

Objective C

@property(assign) NSAttributedString *attributedString

Параметры


      attrString

Текстовое запоминающее устройство, на которое должно воздействовать наборное устройство.

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– attributedString

attributedString - attributedString

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

Объявление

Swift

unowned(unsafe) var attributedString: NSAttributedString?

Objective C

@property(assign) NSAttributedString *attributedString

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

Текстовое запоминающее устройство.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setAttributedString:


    
    setParagraphGlyphRange (_: separatorGlyphRange:)
    - setParagraphGlyphRange:separatorGlyphRange:

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

Объявление

Swift

func setParagraphGlyphRange(_ paragraphRange: NSRange, separatorGlyphRange paragraphSeparatorRange: NSRange)

Objective C

- (void)setParagraphGlyphRange:(NSRange)paragraphRange separatorGlyphRange:(NSRange)paragraphSeparatorRange

Параметры

`paragraphRange`	Текущий обрабатываемый диапазон глифа.
`paragraphSeparatorRange`	Диапазон символа разделителя абзацев или символов.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– paragraphGlyphRange
– paragraphSeparatorGlyphRange

paragraphGlyphRange - paragraphGlyphRange

Возвращает диапазон глифа в настоящее время быть обработанным.

Объявление

Swift

var paragraphGlyphRange: NSRange { get }

Objective C

@property(readonly) NSRange paragraphGlyphRange

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

Диапазон глифа, в настоящее время обрабатываемый.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setParagraphGlyphRange:separatorGlyphRange:
– paragraphSeparatorGlyphRange
– paragraphCharacterRange
– paragraphSeparatorCharacterRange
paragraphSeparatorGlyphRange - paragraphSeparatorGlyphRange

Возвращает диапазон разделителя текущего абзаца.

Объявление

Swift

var paragraphSeparatorGlyphRange: NSRange { get }

Objective C

@property(readonly) NSRange paragraphSeparatorGlyphRange

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setParagraphGlyphRange:separatorGlyphRange:
– paragraphGlyphRange
– paragraphSeparatorCharacterRange
– paragraphCharacterRange
paragraphCharacterRange - paragraphCharacterRange

Возвращает диапазон символов, в настоящее время обрабатываемый.

Объявление

Swift

var paragraphCharacterRange: NSRange { get }

Objective C

@property(readonly) NSRange paragraphCharacterRange

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

Диапазон символов, в настоящее время обрабатываемый.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– paragraphSeparatorCharacterRange
– paragraphSeparatorGlyphRange
– paragraphGlyphRange
paragraphSeparatorCharacterRange - paragraphSeparatorCharacterRange

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

Объявление

Swift

var paragraphSeparatorCharacterRange: NSRange { get }

Objective C

@property(readonly) NSRange paragraphSeparatorCharacterRange

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– paragraphGlyphRange
– paragraphSeparatorGlyphRange
– paragraphCharacterRange
attributesForExtraLineFragment - attributesForExtraLineFragment

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

Объявление

Swift

var attributesForExtraLineFragment: [NSObject : AnyObject]? { get }

Objective C

@property(readonly, copy) NSDictionary *attributesForExtraLineFragment

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

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

Обсуждение

Реализация по умолчанию пытается использовать NSTextView метод typingAttributes если возможный; иначе, это использует атрибуты для последнего знака.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Расположение абзаца


    
    layoutParagraphAtPoint (_:)
    - layoutParagraphAtPoint:

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

Объявление

Swift

func layoutParagraphAtPoint(_ lineFragmentOrigin: NSPointPointer) -> Int

Objective C

- (NSUInteger)layoutParagraphAtPoint:(NSPointPointer)lineFragmentOrigin

Параметры


      lineFragmentOrigin

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

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

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

Обсуждение

Конкретные подклассы должны реализовать этот метод. Конкретная реализация должна вызвать beginParagraph, beginLineWithGlyphAtIndex:, endLineWithGlyphRange:, и endParagraph.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

beginParagraph () - beginParagraph

Устанавливает параметры расположения в начале абзаца.

Объявление

Swift

func beginParagraph()

Objective C

- (void)beginParagraph

Обсуждение

Конкретные подклассы должны вызвать этот метод в начале их layoutParagraphAtPoint: реализация.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– endParagraph
endParagraph () - endParagraph

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

Объявление

Swift

func endParagraph()

Objective C

- (void)endParagraph

Обсуждение

Конкретные подклассы должны вызвать этот метод в конце их layoutParagraphAtPoint: реализация.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– beginParagraph
beginLineWithGlyphAtIndex (_:) - beginLineWithGlyphAtIndex:

Устанавливает параметры расположения в начале строки во время набора.

Объявление

Swift

func beginLineWithGlyphAtIndex(_ glyphIndex: Int)

Objective C

- (void)beginLineWithGlyphAtIndex:(NSUInteger)glyphIndex

Параметры

glyphIndex

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

Обсуждение

Конкретные реализации подкласса layoutParagraphAtPoint: должен вызвать этот метод в начале каждой строки.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– endLineWithGlyphRange:
endLineWithGlyphRange (_:) - endLineWithGlyphRange:

Устанавливает параметры расположения в конце строки во время набора.

Объявление

Swift

func endLineWithGlyphRange(_ lineGlyphRange: NSRange)

Objective C

- (void)endLineWithGlyphRange:(NSRange)lineGlyphRange

Параметры

lineGlyphRange

Диапазон глифов размечается в строке.

Обсуждение

Конкретные реализации подкласса layoutParagraphAtPoint: должен вызвать этот метод в конце каждой строки.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– beginLineWithGlyphAtIndex:

Символьное расположение


    
    layoutCharactersInRange (_: forLayoutManager:maximumNumberOfLineFragments:)
    - layoutCharactersInRange:forLayoutManager:maximumNumberOfLineFragments:

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

Объявление

Swift

func layoutCharactersInRange(_ characterRange: NSRange, forLayoutManager layoutManager: NSLayoutManager, maximumNumberOfLineFragments maxNumLines: Int) -> NSRange

Objective C

- (NSRange)layoutCharactersInRange:(NSRange)characterRange forLayoutManager:(NSLayoutManager *)layoutManager maximumNumberOfLineFragments:(NSUInteger)maxNumLines

Параметры

`characterRange`	Диапазон символов для разметки.
`layoutManager`	Менеджер по расположению, делающий получение.
`maxNumLines`	Максимальное количество фрагментов строки для разметки. Указать `NSUIntegerMax` для неограниченного количества фрагментов строки.

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

Метод возвращает фактический диапазон символов что получение NSTypesetter обработанный.

Обсуждение

Когда число фрагментов строки превышает, процесс создания макета может быть прерван maxNumLines.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Межстрочный интервал и расстояние между абзацами


    
    lineSpacingAfterGlyphAtIndex (_: withProposedLineFragmentRect:)
    - lineSpacingAfterGlyphAtIndex:withProposedLineFragmentRect:

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

Объявление

Swift

func lineSpacingAfterGlyphAtIndex(_ glyphIndex: Int, withProposedLineFragmentRect rect: NSRect) -> CGFloat

Objective C

- (CGFloat)lineSpacingAfterGlyphAtIndex:(NSUInteger)glyphIndex withProposedLineFragmentRect:(NSRect)rect

Параметры

`glyphIndex`	Индекс рассматриваемого глифа.
`rect`	Предложенный прямоугольник фрагмента строки.

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

межстрочный интервал в действительности после глифа в glyphIndex.

Обсуждение

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

Межстрочный интервал, также названный продвижением, является атрибутом NSParagraphStyle, который можно установить на NSMutableParagraphStyle объект. Шрифт обычно включает минимальную метрику межстрочного интервала по умолчанию, используемую, если ни один не установлен в стиле абзаца.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    paragraphSpacingAfterGlyphAtIndex (_: withProposedLineFragmentRect:)
    - paragraphSpacingAfterGlyphAtIndex:withProposedLineFragmentRect:

Возвращает расстояние между абзацами, имеющее силу после указанного глифа.

Объявление

Swift

func paragraphSpacingAfterGlyphAtIndex(_ glyphIndex: Int, withProposedLineFragmentRect rect: NSRect) -> CGFloat

Objective C

- (CGFloat)paragraphSpacingAfterGlyphAtIndex:(NSUInteger)glyphIndex withProposedLineFragmentRect:(NSRect)rect

Параметры

`glyphIndex`	Индекс рассматриваемого глифа.
`rect`	Прямоугольник фрагмента строки последней строки в абзаце.

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

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

Обсуждение

Наборное устройство добавляет число очков, указанное в возвращаемом значении к нижней части прямоугольника фрагмента строки, указанного rect (но не к используемому прямоугольнику фрагмента строки для той строки). Расстояние между абзацами добавило после того, как абзац коррелирует к значению, возвращенному paragraphSpacing метод NSParagraphStyle, который можно установить использование setParagraphSpacing: метод NSMutableParagraphStyle.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– paragraphSpacingBeforeGlyphAtIndex:withProposedLineFragmentRect:


    
    paragraphSpacingBeforeGlyphAtIndex (_: withProposedLineFragmentRect:)
    - paragraphSpacingBeforeGlyphAtIndex:withProposedLineFragmentRect:

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

Объявление

Swift

func paragraphSpacingBeforeGlyphAtIndex(_ glyphIndex: Int, withProposedLineFragmentRect rect: NSRect) -> CGFloat

Objective C

- (CGFloat)paragraphSpacingBeforeGlyphAtIndex:(NSUInteger)glyphIndex withProposedLineFragmentRect:(NSRect)rect

Параметры

`glyphIndex`	Индекс рассматриваемого глифа.
`rect`	Прямоугольник фрагмента строки первой строки в абзаце.

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

Число очков пространства — добавило перед абзацем — который имеет силу перед глифом, указанным glyphIndex.

Обсуждение

Наборное устройство добавляет число очков, указанное в возвращаемом значении к вершине прямоугольника фрагмента строки, указанного rect (но не к используемому прямоугольнику фрагмента строки для той строки). Расстояние между абзацами добавило, прежде чем абзац будет коррелировать к значению, возвращенному paragraphSpacingBefore метод NSParagraphStyle, который можно установить использование setParagraphSpacingBefore: метод NSMutableParagraphStyle.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– paragraphSpacingAfterGlyphAtIndex:withProposedLineFragmentRect:

Кэширование глифа


    
    setHardInvalidation (_: forGlyphRange:)
    - setHardInvalidation:forGlyphRange:

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

Объявление

Swift

func setHardInvalidation(_ flag: Bool, forGlyphRange glyphRange: NSRange)

Objective C

- (void)setHardInvalidation:(BOOL)flag forGlyphRange:(NSRange)glyphRange

Параметры

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Разметка Глифов


    
    layoutGlyphsInLayoutManager (_: startingAtGlyphIndex:maxNumberOfLineFragments:nextGlyphIndex:)
    - layoutGlyphsInLayoutManager:startingAtGlyphIndex:maxNumberOfLineFragments:nextGlyphIndex:

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

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

Объявление

Swift

func layoutGlyphsInLayoutManager(_ layoutMgr: NSLayoutManager, startingAtGlyphIndex startGlyphIndex: Int, maxNumberOfLineFragments maxNumLines: Int, nextGlyphIndex nextGlyph: UnsafeMutablePointer<Int>)

Objective C

- (void)layoutGlyphsInLayoutManager:(NSLayoutManager *)layoutMgr startingAtGlyphIndex:(NSUInteger)startGlyphIndex maxNumberOfLineFragments:(NSUInteger)maxNumLines nextGlyphIndex:(NSUInteger *)nextGlyph

Параметры

`layoutMgr`	Менеджер по расположению, в котором можно разметить глифы.
`startGlyphIndex`	Индекс стартового глифа.
`maxNumLines`	Максимальное количество строк для генерации. Если хранение глифа исчерпывает глифы, может быть размечено меньше строк.
`nextGlyph`	По возврату, набору к индексу следующего глифа, который должен быть размечен.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    boundingBoxForControlGlyphAtIndex (_: forTextContainer:proposedLineFragment:glyphPosition:characterIndex:)
    - boundingBoxForControlGlyphAtIndex:forTextContainer:proposedLineFragment:glyphPosition:characterIndex:

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

Объявление

Swift

func boundingBoxForControlGlyphAtIndex(_ glyphIndex: Int, forTextContainer textContainer: NSTextContainer, proposedLineFragment proposedRect: NSRect, glyphPosition glyphPosition: NSPoint, characterIndex charIndex: Int) -> NSRect

Objective C

- (NSRect)boundingBoxForControlGlyphAtIndex:(NSUInteger)glyphIndex forTextContainer:(NSTextContainer *)textContainer proposedLineFragment:(NSRect)proposedRect glyphPosition:(NSPoint)glyphPosition characterIndex:(NSUInteger)charIndex

Параметры

`glyphIndex`	Индекс рассматриваемого глифа управления.
`textContainer`	Текстовый контейнер для использования для вычисления позиции.
`proposedRect`	Предложенный прямоугольник фрагмента строки.
`glyphPosition`	Позиция глифа в `textContainer`.
`charIndex`	Индекс символа в `textContainer`.

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

Ограничительный прямоугольник глифа управления в glyphIndex, в данном glyphPosition и индекс символа charIndex, в textContainer.

Обсуждение

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

NSGlyphGenerator может выбрать, отобразить ли управляющие символы на NSControlGlyph. Символы табуляции, например, не используют это средство.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    getLineFragmentRect (_: usedRect:forParagraphSeparatorGlyphRange:atProposedOrigin:)
    - getLineFragmentRect:usedRect:forParagraphSeparatorGlyphRange:atProposedOrigin:

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

Объявление

Swift

func getLineFragmentRect(_ lineFragmentRect: NSRectPointer, usedRect lineFragmentUsedRect: NSRectPointer, forParagraphSeparatorGlyphRange paragraphSeparatorGlyphRange: NSRange, atProposedOrigin lineOrigin: NSPoint)

Objective C

- (void)getLineFragmentRect:(NSRectPointer)lineFragmentRect usedRect:(NSRectPointer)lineFragmentUsedRect forParagraphSeparatorGlyphRange:(NSRange)paragraphSeparatorGlyphRange atProposedOrigin:(NSPoint)lineOrigin

Параметры

`lineFragmentRect`	По возврату, расчетному прямоугольнику фрагмента строки.
`lineFragmentUsedRect`	По возврату, используемый прямоугольник (часть прямоугольника фрагмента строки, фактически содержащего метки).
`paragraphSeparatorGlyphRange`	Диапазон глифов на рассмотрении. A `paragraphSeparatorGlyphRange` с длиной 0 указывает дополнительный фрагмент строки (который происходит, если последний знак в абзаце является разделителем строки).
`lineOrigin`	Точка источника прямоугольника фрагмента строки.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    getLineFragmentRect(_:usedRect:remainingRect:forStartingGlyphAtIndex:proposedRect:lineSpacing:paragraphSpacingBefore:paragraphSpacingAfter:)
    - getLineFragmentRect:usedRect:remainingRect:forStartingGlyphAtIndex:proposedRect:lineSpacing:paragraphSpacingBefore:paragraphSpacingAfter:

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

Объявление

Swift

func getLineFragmentRect(_ lineFragmentRect: NSRectPointer, usedRect lineFragmentUsedRect: NSRectPointer, remainingRect remainingRect: NSRectPointer, forStartingGlyphAtIndex startingGlyphIndex: Int, proposedRect proposedRect: NSRect, lineSpacing lineSpacing: CGFloat, paragraphSpacingBefore paragraphSpacingBefore: CGFloat, paragraphSpacingAfter paragraphSpacingAfter: CGFloat)

Objective C

- (void)getLineFragmentRect:(NSRectPointer)lineFragmentRect usedRect:(NSRectPointer)lineFragmentUsedRect remainingRect:(NSRectPointer)remainingRect forStartingGlyphAtIndex:(NSUInteger)startingGlyphIndex proposedRect:(NSRect)proposedRect lineSpacing:(CGFloat)lineSpacing paragraphSpacingBefore:(CGFloat)paragraphSpacingBefore paragraphSpacingAfter:(CGFloat)paragraphSpacingAfter

Параметры

`lineFragmentRect`	По возврату, расчетному прямоугольнику фрагмента строки.
`lineFragmentUsedRect`	По возврату, используемый прямоугольник (часть прямоугольника фрагмента строки, фактически содержащего метки).
`remainingRect`	По возврату, остающемуся прямоугольнику `proposedRect`.
`startingGlyphIndex`	Индекс глифа, где запускается фрагмент строки.
`proposedRect`	Предложенный прямоугольник фрагмента строки.
`lineSpacing`	Межстрочный интервал.
`paragraphSpacingBefore`	Интервал перед абзацем.
`paragraphSpacingAfter`	Интервал после абзаца.

Обсуждение

Высота фрагмента строки определяется с помощью lineSpacing, paragraphSpacingBefore, и paragraphSpacingAfter а также proposedRect. Ширина для lineFragmentUsedRect установлен в lineFragmentRect ширина. В стандартной реализации расстояние между абзацами включено в прямоугольник фрагмента строки, но не фрагмент строки использовал прямоугольник; межстрочный интервал включен в обоих.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

hyphenCharacterForGlyphAtIndex (_:) - hyphenCharacterForGlyphAtIndex:

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

Объявление

Swift

func hyphenCharacterForGlyphAtIndex(_ glyphIndex: Int) -> UTF32Char

Objective C

- (UTF32Char)hyphenCharacterForGlyphAtIndex:(NSUInteger)glyphIndex

Параметры

glyphIndex

Индекс рассматриваемого глифа.

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

Символ дефиса, который будет вставлен после глифа в glyphIndex.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– hyphenationFactorForGlyphAtIndex:
hyphenationFactorForGlyphAtIndex (_:) - hyphenationFactorForGlyphAtIndex:

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

Объявление

Swift

func hyphenationFactorForGlyphAtIndex(_ glyphIndex: Int) -> Float

Objective C

- (float)hyphenationFactorForGlyphAtIndex:(NSUInteger)glyphIndex

Параметры

glyphIndex

Индекс позиции глифа для исследования.

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

Фактор расстановки переносов в действительности в glyphIndex. Фактором расстановки переносов является значение в пределах от 0,0 к 1,0, который управляет, когда опробована расстановка переносов. По умолчанию значение 0.0, означая, что расстановка переносов выключена. Фактор 1,0 расстановок переносов причин, которые будут всегда пробоваться.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– hyphenCharacterForGlyphAtIndex:


    
    shouldBreakLineByHyphenatingBeforeCharacterAtIndex (_:)
    - shouldBreakLineByHyphenatingBeforeCharacterAtIndex:

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

Объявление

Swift

func shouldBreakLineByHyphenatingBeforeCharacterAtIndex(_ charIndex: Int) -> Bool

Objective C

- (BOOL)shouldBreakLineByHyphenatingBeforeCharacterAtIndex:(NSUInteger)charIndex

Параметры


      charIndex

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

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

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

Обсуждение

Наборное устройство вызывает этот метод, если реализовано подклассом, прежде, чем повредить строку путем записи через дефис перед символом в charIndex, то, чтобы позволять подкласс управлять повреждением строки.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– shouldBreakLineByWordBeforeCharacterAtIndex:


    
    shouldBreakLineByWordBeforeCharacterAtIndex (_:)
    - shouldBreakLineByWordBeforeCharacterAtIndex:

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

Объявление

Swift

func shouldBreakLineByWordBeforeCharacterAtIndex(_ charIndex: Int) -> Bool

Objective C

- (BOOL)shouldBreakLineByWordBeforeCharacterAtIndex:(NSUInteger)charIndex

Параметры


      charIndex

Индекс символа сразу после предложенного разрыва слова произошел бы.

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

YEStrue если строка должна быть повреждена разрывом слова, NOfalse иначе.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– shouldBreakLineByHyphenatingBeforeCharacterAtIndex:


    
    willSetLineFragmentRect (_: forGlyphRange:usedRect:baselineOffset:)
    - willSetLineFragmentRect:forGlyphRange:usedRect:baselineOffset:

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

Объявление

Swift

func willSetLineFragmentRect(_ lineRect: NSRectPointer, forGlyphRange glyphRange: NSRange, usedRect usedRect: NSRectPointer, baselineOffset baselineOffset: UnsafeMutablePointer<CGFloat>)

Objective C

- (void)willSetLineFragmentRect:(NSRectPointer)lineRect forGlyphRange:(NSRange)glyphRange usedRect:(NSRectPointer)usedRect baselineOffset:(CGFloat *)baselineOffset

Параметры

`lineRect`	Прямоугольник тот, в который глифы в `glyphRange` размечаются.
`glyphRange`	Диапазон глифов для разметки.
`usedRect`	Часть `lineRect`, в системе координат объекта NSTextContainer, фактически содержащей глифы или другие метки, нарисованные (включая текстовое дополнение фрагмента строки контейнера). `usedRect` должно быть равно или содержавший в `lineRect`.
`baselineOffset`	Вертикальное расстояние в пикселях от источника фрагмента строки до базовой линии, на которой выравниваются глифы.

Обсуждение

Вызванный наборным устройством только до вызова setLineFragmentRect:forGlyphRange:usedRect:baselineOffset: который хранит фактическое прямоугольное расположение фрагмента строки в менеджере по расположению.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Взаимодействие через интерфейс с хранением глифа


    
    characterRangeForGlyphRange (_: actualGlyphRange:)
    - characterRangeForGlyphRange:actualGlyphRange:

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

Объявление

Swift

func characterRangeForGlyphRange(_ glyphRange: NSRange, actualGlyphRange actualGlyphRange: NSRangePointer) -> NSRange

Objective C

- (NSRange)characterRangeForGlyphRange:(NSRange)glyphRange actualGlyphRange:(NSRangePointer)actualGlyphRange

Параметры

`glyphRange`	Диапазон глифов.
`actualGlyphRange`	По возврату диапазон всех глифов отобразился на символы в текстовом хранилище получателя. Может быть `NULL`.

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

Диапазон для символов в текстовом хранилище получателя, отображающихся на глифах в glyphRange.

Обсуждение

Подкласс может переопределить этот метод для взаимодействия с пользовательским хранением глифа.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– glyphRangeForCharacterRange:actualCharacterRange:

deleteGlyphsInRange (_:) - deleteGlyphsInRange:

Удаляет указанные глифы из кэша глифа, сохраняемого менеджером по расположению.

Объявление

Swift

func deleteGlyphsInRange(_ glyphRange: NSRange)

Objective C

- (void)deleteGlyphsInRange:(NSRange)glyphRange

Параметры

glyphRange

Диапазон глифов, которые будут удалены.

Обсуждение

Подкласс может переопределить этот метод для взаимодействия с пользовательским хранением глифа.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

insertGlyph:atGlyphIndex:characterIndex:


    
    substituteGlyphsInRange (_: withGlyphs:)
    - substituteGlyphsInRange:withGlyphs:

Заменяет указанные глифы указанными заменяющими глифами.

Объявление

Swift

func substituteGlyphsInRange(_ glyphRange: NSRange, withGlyphs glyphs: UnsafeMutablePointer<NSGlyph>)

Objective C

- (void)substituteGlyphsInRange:(NSRange)glyphRange withGlyphs:(NSGlyph *)glyphs

Параметры

`glyphRange`	Диапазон глифов, которыми заменят.
`glyphs`	Глифы для заменения глифы в `glyphRange`.

Обсуждение

Этот метод не изменяет отображение глифа к символу или лишает законной силы информацию макета.

Подкласс может переопределить этот метод для взаимодействия с пользовательским хранением глифа.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    getGlyphsInRange (_: glyphs:characterIndexes:glyphInscriptions:elasticBits:bidiLevels:)
    - getGlyphsInRange:glyphs:characterIndexes:glyphInscriptions:elasticBits:bidiLevels:

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

Объявление

Swift

func getGlyphsInRange(_ glyphsRange: NSRange, glyphs glyphBuffer: UnsafeMutablePointer<NSGlyph>, characterIndexes charIndexBuffer: UnsafeMutablePointer<Int>, glyphInscriptions inscribeBuffer: UnsafeMutablePointer<NSGlyphInscription>, elasticBits elasticBuffer: UnsafeMutablePointer<ObjCBool>, bidiLevels bidiLevelBuffer: UnsafeMutablePointer<UInt8>) -> Int

Objective C

- (NSUInteger)getGlyphsInRange:(NSRange)glyphsRange glyphs:(NSGlyph *)glyphBuffer characterIndexes:(NSUInteger *)charIndexBuffer glyphInscriptions:(NSGlyphInscription *)inscribeBuffer elasticBits:(BOOL *)elasticBuffer bidiLevels:(unsigned char *)bidiLevelBuffer

Параметры

`glyphsRange`	Диапазон глифов.
`glyphBuffer`	Глифы для разметки.
`charIndexBuffer`	Исходные символы для глифов. Обратите внимание на то, что глиф в индексе 1 не обязательно отображается на символе в индексе 1, потому что глиф может быть для лигатуры или диакритического знака.
`inscribeBuffer`	Надпись приписывает для каждого глифа, которые привыкли к символам расположения, объединенным вместе.
`elasticBuffer`	Содержит булево значение, указывающее, эластичен ли глиф для каждого глифа. Эластичный глиф может быть сделан более длинным в конце строки или, когда необходимый для выравнивания.
`bidiLevelBuffer`	Содержит двунаправленное значение уровня, сгенерированное `NSGlyphGenerator`, в случае, если подкласс принимает решение использовать это значение.

Обсуждение

Подкласс может переопределить этот метод для взаимодействия с пользовательским хранением глифа.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    glyphRangeForCharacterRange (_: actualCharacterRange:)
    - glyphRangeForCharacterRange:actualCharacterRange:

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

Объявление

Swift

func glyphRangeForCharacterRange(_ charRange: NSRange, actualCharacterRange actualCharRange: NSRangePointer) -> NSRange

Objective C

- (NSRange)glyphRangeForCharacterRange:(NSRange)charRange actualCharacterRange:(NSRangePointer)actualCharRange

Параметры

`charRange`	Диапазон символов, диапазон глифа которых желаем.
`actualCharRange`	По возврату все символы отобразились на те глифы; может быть `NULL`.

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

Диапазон для глифов отобразился на символы текстового хранилища в charRange.

Обсуждение

Подкласс может переопределить этот метод для взаимодействия с пользовательским хранением глифа.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– characterRangeForGlyphRange:actualGlyphRange:


    
    insertGlyph (_: atGlyphIndex:characterIndex:)
    - insertGlyph:atGlyphIndex:characterIndex:

Позволяет наборному устройству вставить новый глиф в поток.

Объявление

Swift

func insertGlyph(_ glyph: NSGlyph, atGlyphIndex glyphIndex: Int, characterIndex charIndex: Int)

Objective C

- (void)insertGlyph:(NSGlyph)glyph atGlyphIndex:(NSUInteger)glyphIndex characterIndex:(NSUInteger)charIndex

Параметры

`glyph`	Глиф для вставки в кэш глифа.
`glyphIndex`	Индекс, в котором можно вставить `glyph`.
`charIndex`	Индекс символа это `glyph` карты к. Если глиф отображается на нескольких символах, `charIndex` должен указать первый символ, на котором это отображается.

Обсуждение

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

Подкласс может переопределить этот метод для взаимодействия с пользовательским хранением глифа.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    setAttachmentSize (_: forGlyphRange:)
    - setAttachmentSize:forGlyphRange:

Устанавливает размер, в котором указанные глифы (предполагаемый быть присоединениями) попросят нарисовать себя.

Объявление

Swift

func setAttachmentSize(_ attachmentSize: NSSize, forGlyphRange glyphRange: NSRange)

Objective C

- (void)setAttachmentSize:(NSSize)attachmentSize forGlyphRange:(NSRange)glyphRange

Параметры

`attachmentSize`	Размер глифы в `glyphRange` (предполагаемый быть присоединениями), попросится привлечь себя в.
`glyphRange`	Диапазон глифов присоединяемый размер применяется к.

Обсуждение

Подкласс может переопределить этот метод для взаимодействия с пользовательским хранением глифа.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    setBidiLevels (_: forGlyphRange:)
    - setBidiLevels:forGlyphRange:

Устанавливает направление указанных глифов для двунаправленного текста.

Объявление

Swift

func setBidiLevels(_ levels: UnsafePointer<UInt8>, forGlyphRange glyphRange: NSRange)

Objective C

- (void)setBidiLevels:(const uint8_t *)levels forGlyphRange:(NSRange)glyphRange

Параметры

`levels`	Значения в `levels` может колебаться от 0 до 61, как определено Приложением № 9 Стандарта Unicode.
`glyphRange`	Диапазон глифов, для которых желаемы уровни двунаправленного текста.

Обсуждение

Подкласс может переопределить этот метод для взаимодействия с пользовательским хранением глифа.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    setDrawsOutsideLineFragment (_: forGlyphRange:)
    - setDrawsOutsideLineFragment:forGlyphRange:

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

Объявление

Swift

func setDrawsOutsideLineFragment(_ flag: Bool, forGlyphRange glyphRange: NSRange)

Objective C

- (void)setDrawsOutsideLineFragment:(BOOL)flag forGlyphRange:(NSRange)glyphRange

Параметры

`flag`	`YEStrue` если глифы в `glyphRange` превысьте границы фрагмента строки, в котором они размечаются, `NOfalse` иначе.
`glyphRange`	Диапазон рассматриваемых глифов.

Обсуждение

Когда текст установлен на фиксированной высоте строки, это может произойти. Например, если пользователь укажет фиксированную высоту строки 12 точек и установит размер шрифта в 24 точки, то глифы превысят свои прямоугольники расположения.

Подкласс может переопределить этот метод для взаимодействия с пользовательским хранением глифа.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    setLineFragmentRect (_: forGlyphRange:usedRect:baselineOffset:)
    - setLineFragmentRect:forGlyphRange:usedRect:baselineOffset:

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

Объявление

Swift

func setLineFragmentRect(_ fragmentRect: NSRect, forGlyphRange glyphRange: NSRange, usedRect usedRect: NSRect, baselineOffset baselineOffset: CGFloat)

Objective C

- (void)setLineFragmentRect:(NSRect)fragmentRect forGlyphRange:(NSRange)glyphRange usedRect:(NSRect)usedRect baselineOffset:(CGFloat)baselineOffset

Параметры

`fragmentRect`	Прямоугольник фрагмента строки, где глифы в `glyphRange` размечаются.
`glyphRange`	Диапазон указанных глифов.
`usedRect`	Часть `fragmentRect`, в системе координат объекта NSTextContainer, фактически содержащей глифы или другие метки, нарисованные (включая текстовое дополнение фрагмента строки контейнера). `usedRect` должно быть равно или содержавший в `fragmentRect`.
`baselineOffset`	Вертикальное расстояние в пикселях от источника фрагмента строки до базовой линии, на которой выравниваются глифы.

Обсуждение

Точные позиции глифов должны быть установлены после прямоугольника фрагмента строки с setLocation:forStartOfGlyphRange:.

Подкласс может переопределить этот метод для взаимодействия с пользовательским хранением глифа.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    setLocation (_: withAdvancements:forStartOfGlyphRange:)
    - setLocation:withAdvancements:forStartOfGlyphRange:

Устанавливает расположение, где размечаются указанные глифы.

Объявление

Swift

func setLocation(_ location: NSPoint, withAdvancements advancements: UnsafePointer<CGFloat>, forStartOfGlyphRange glyphRange: NSRange)

Objective C

- (void)setLocation:(NSPoint)location withAdvancements:(const CGFloat *)advancements forStartOfGlyphRange:(NSRange)glyphRange

Параметры

`location`	Расположение, где глифы в `glyphRange` размечаются. X-координата `location` выражен относительно прямоугольного источника фрагмента строки, и y-координата выражена относительно базовой линии, ранее указанной `setLineFragmentRect:forGlyphRange:usedRect:baselineOffset:`.
`advancements`	Номинальный глиф совершенствует ширину, указанную в информации о метрике шрифта.
`glyphRange`	Диапазон глифов, расположение расположения которых устанавливается. Эта серия глифов может быть выведена на экран с единственным PostScript `show` работа (номинальный диапазон).

Обсуждение

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

Прежде, чем установить расположение для диапазона глифа, необходимо указать прямоугольник фрагмента строки с setLineFragmentRect:forGlyphRange:usedRect:baselineOffset:.

Подкласс может переопределить этот метод для взаимодействия с пользовательским хранением глифа.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    setNotShownAttribute (_: forGlyphRange:)
    - setNotShownAttribute:forGlyphRange:

Наборы, не показаны ли указанные глифы.

Объявление

Swift

func setNotShownAttribute(_ flag: Bool, forGlyphRange glyphRange: NSRange)

Objective C

- (void)setNotShownAttribute:(BOOL)flag forGlyphRange:(NSRange)glyphRange

Параметры

`flag`	`YEStrue` если глифы в `glyphRange` не показаны, `NOfalse` если они показаны.
`glyphRange`	Диапазон рассматриваемых глифов.

Обсуждение

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

Подкласс может переопределить этот метод для взаимодействия с пользовательским хранением глифа.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Константы

NSTypesetterControlCharacterAction
Следующие константы являются возможными значениями, возвращенными actionForControlCharacterAtIndex: метод для определения действия связался с управляющим символом.

Объявление

Swift

struct NSTypesetterControlCharacterAction : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var ZeroAdvancementAction: NSTypesetterControlCharacterAction { get } static var WhitespaceAction: NSTypesetterControlCharacterAction { get } static var HorizontalTabAction: NSTypesetterControlCharacterAction { get } static var LineBreakAction: NSTypesetterControlCharacterAction { get } static var ParagraphBreakAction: NSTypesetterControlCharacterAction { get } static var ContainerBreakAction: NSTypesetterControlCharacterAction { get } }

Objective C

enum { NSTypesetterZeroAdvancementAction = (1 << 0), NSTypesetterWhitespaceAction = (1 << 1), NSTypesetterHorizontalTabAction = (1 << 2), NSTypesetterLineBreakAction = (1 << 3), NSTypesetterParagraphBreakAction = (1 << 4), NSTypesetterContainerBreakAction = (1 << 5) }; typedef NSUInteger NSTypesetterControlCharacterAction;

Константы
- ZeroAdvancementAction
  
  NSTypesetterZeroAdvancementAction
  
  Глифы с этим действием отфильтрованы из расположения (notShownAttribute == YES).
  
  Доступный в OS X v10.4 и позже.
- WhitespaceAction
  
  NSTypesetterWhitespaceAction
  
  Ширина для глифов с этим действием определяется boundingBoxForControlGlyphAtIndex:forTextContainer:proposedLineFragment:glyphPosition:characterIndex:, если реализован метод; иначе, то же как NSTypesetterZeroAdvancementAction.
  
  Доступный в OS X v10.4 и позже.
- HorizontalTabAction
  
  NSTypesetterHorizontalTabAction
  
  Обработанный как символ табуляции.
  
  Доступный в OS X v10.4 и позже.
- LineBreakAction
  
  NSTypesetterLineBreakAction
  
  Разрыв строки причин.
  
  Доступный в OS X v10.4 и позже.
- ParagraphBreakAction
  
  NSTypesetterParagraphBreakAction
  
  Конец абзаца причин; значение, возвращенное firstLineHeadIndent продвижение, используемое для следующего глифа.
  
  Доступный в OS X v10.4 и позже.
- ContainerBreakAction
  
  NSTypesetterContainerBreakAction
  
  Повреждение контейнера причин.
  
  Доступный в OS X v10.4 и позже.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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