Ссылка класса NSLayoutManager

Инициализация

init () - init Определяемый инициализатор

Инициализирует получатель, недавно создаваемый NSLayoutManager объект.

Объявление

Swift

init()

Objective C

- (instancetype)init

Обсуждение

Этот метод является определяемым инициализатором для NSLayoutManager класс. Возвращает инициализированный объект.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

addLayoutManager: (NSTextStorage)
– addTextContainer:

Установка текстового хранения

setTextStorage: - setTextStorage:

Устанавливает получатель NSTextStorage объект.

Объявление

Swift

unowned(unsafe) var textStorage: NSTextStorage?

Objective C

@property(assign) NSTextStorage *textStorage

Параметры

textStorage

Текстовый объект хранения для установки.

Обсуждение

Когда Вы добавляете, этот метод вызывается автоматически NSLayoutManager к NSTextStorage объект; Вы никогда не должны должны быть вызывать его непосредственно, но Вы могли бы хотеть переопределить его. Если Вы хотите заменить NSTextStorage объект для установленной группы текстовых системных объектов, содержащих получатель, использовать replaceTextStorage:.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

addLayoutManager: (NSTextStorage)
textStorage - textStorage

Возвращает текстовый объект хранения получателя.

Объявление

Swift

unowned(unsafe) var textStorage: NSTextStorage?

Objective C

@property(assign) NSTextStorage *textStorage

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

Текстовое хранение получателя.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setTextStorage:
– replaceTextStorage:
attributedString - attributedString

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

Объявление

Swift

var attributedString: NSAttributedString? { get }

Objective C

@property(readonly, strong) NSAttributedString *attributedString

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

Текстовый объект хранения получателя.

Обсуждение

Этот метод является частью NSGlyphStorage протокол, для использования генератором глифа. Для NSLayoutManager приписанная строка эквивалентна текстовому хранению.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.
replaceTextStorage (_:) - replaceTextStorage:

Замены NSTextStorage объект для группы текстовых системных объектов, содержащих получатель с данным текстовым объектом хранения.

Объявление

Swift

func replaceTextStorage(_ newTextStorage: NSTextStorage)

Objective C

- (void)replaceTextStorage:(NSTextStorage *)newTextStorage

Параметры

newTextStorage

Текстовый объект хранения для установки.

Обсуждение

Все NSLayoutManager объекты, совместно использующие оригинал NSTextStorage возразите тогда совместно используют новый. Этот метод вносит все корректировки, необходимые для сохранения этих отношений в целости в отличие от этого setTextStorage:.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Установка текстовых контейнеров

textContainers - textContainers

Возвращает текстовые контейнеры получателя.

Объявление

Swift

var textContainers: [AnyObject] { get }

Objective C

@property(readonly, copy) NSArray *textContainers

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

Текстовые контейнеры получателя.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– addTextContainer:
– insertTextContainer:atIndex:
– removeTextContainerAtIndex:
addTextContainer (_:) - addTextContainer:

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

Объявление

Swift

func addTextContainer(_ aTextContainer: NSTextContainer)

Objective C

- (void)addTextContainer:(NSTextContainer *)aTextContainer

Параметры

aTextContainer

Текстовый контейнер для добавления.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– insertTextContainer:atIndex:
– removeTextContainerAtIndex:
– textContainers
– invalidateGlyphsForCharacterRange:changeInLength:actualCharacterRange:
– invalidateLayoutForCharacterRange:isSoft:actualCharacterRange:


    
    insertTextContainer (_: atIndex:)
    - insertTextContainer:atIndex:

Вставляет данный текстовый контейнер в серию текстовых контейнеров в данном индексе.

Объявление

Swift

func insertTextContainer(_ aTextContainer: NSTextContainer, atIndex index: Int)

Objective C

- (void)insertTextContainer:(NSTextContainer *)aTextContainer atIndex:(NSUInteger)index

Параметры

`aTextContainer`	Текстовый контейнер для вставки.
`index`	Индекс в серии текстовых контейнеров, в которых можно вставить `aTextContainer`.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– addTextContainer:
– removeTextContainerAtIndex:
– textContainers

removeTextContainerAtIndex (_:) - removeTextContainerAtIndex:

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

Объявление

Swift

func removeTextContainerAtIndex(_ index: Int)

Objective C

- (void)removeTextContainerAtIndex:(NSUInteger)index

Параметры

index

Индекс текстового контейнера для удаления.

Обсуждение

Этот метод лишает законной силы информацию о глифе по мере необходимости.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– addTextContainer:
– insertTextContainer:atIndex:
– textContainers
– invalidateGlyphsForCharacterRange:changeInLength:actualCharacterRange:
– invalidateLayoutForCharacterRange:isSoft:actualCharacterRange:

Установка генератора глифа

setGlyphGenerator: - setGlyphGenerator:

Устанавливает генератор глифа, используемый этим менеджером по расположению.

Объявление

Swift

var glyphGenerator: NSGlyphGenerator!

Objective C

@property(strong) NSGlyphGenerator *glyphGenerator

Параметры

glyphGenerator

Новый генератор глифа для установки.

Обсуждение

Установка генератора глифа лишает законной силы все глифы и расположение в менеджере по расположению.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– glyphGenerator
glyphGenerator - glyphGenerator

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

Объявление

Swift

var glyphGenerator: NSGlyphGenerator!

Objective C

@property(strong) NSGlyphGenerator *glyphGenerator

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

Генератор глифа.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setGlyphGenerator:

Лишение законной силы глифов и расположения


    
    invalidateGlyphsForCharacterRange (_: changeInLength:actualCharacterRange:)
    - invalidateGlyphsForCharacterRange:changeInLength:actualCharacterRange:

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

Объявление

Swift

func invalidateGlyphsForCharacterRange(_ charRange: NSRange, changeInLength lengthChange: Int, actualCharacterRange actualCharRange: NSRangePointer)

Objective C

- (void)invalidateGlyphsForCharacterRange:(NSRange)charRange changeInLength:(NSInteger)lengthChange actualCharacterRange:(NSRangePointer)actualCharRange

Параметры

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

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

invalidateGlyphsOnLayoutInvalidationForGlyphRange (_:) - invalidateGlyphsOnLayoutInvalidationForGlyphRange:

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

Объявление

Swift

func invalidateGlyphsOnLayoutInvalidationForGlyphRange(_ glyphRange: NSRange)

Objective C

- (void)invalidateGlyphsOnLayoutInvalidationForGlyphRange:(NSRange)glyphRange

Параметры

glyphRange

Диапазон глифов для лишения законной силы.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    invalidateLayoutForCharacterRange (_: isSoft:actualCharacterRange:)
    - invalidateLayoutForCharacterRange:isSoft:actualCharacterRange:

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

Объявление

Swift

func invalidateLayoutForCharacterRange(_ charRange: NSRange, isSoft flag: Bool, actualCharacterRange actualCharRange: NSRangePointer)

Objective C

- (void)invalidateLayoutForCharacterRange:(NSRange)charRange isSoft:(BOOL)flag actualCharacterRange:(NSRangePointer)actualCharRange

Параметры

`charRange`	Диапазон символов, для которого лишены законной силы глифы.
`flag`	Если `YEStrue`, лишает законной силы внутренние кэши в менеджере по расположению; если `NOfalse`, лишает законной силы расположение. Посмотрите раздел обсуждения.
`actualCharRange`	Если нет `NULL`, на выводе диапазон символов отобразился на глифы, информация макета которых лишена законной силы. Этот диапазон может быть больше, чем диапазон символов, данных вследствие эффекта контекста на глифах и расположении.

Обсуждение

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

Для кода, который должен работать и над OS X v10.5 и над предыдущими выпусками, должны использоваться следующие процедуры. Для OS X v10.4 и прежде, аннулирование должно состоять из

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

С OS X v10.5, семантика flag параметр немного отличается. Мягкие дыры расположения являются устаревшими в OS X v10.5 и позже, таким образом, флаг больше не необходим. Если с методом вызывают flag набор к NOfalse, тогда это имеет эффект лишения законной силы расположения. Если это вызывают с flag набор к YEStrue, тогда это фактически не лишает законной силы расположение; это лишает законной силы много внутренних кэшей, но иначе не имеет никакого эффекта, и в целом является ненужным.

Этот метод заменяется invalidateLayoutForCharacterRange:actualCharacterRange: и будет осуждаться в будущем выпуске.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– invalidateGlyphsForCharacterRange:changeInLength:actualCharacterRange:


    
    invalidateLayoutForCharacterRange (_: actualCharacterRange:)
    - invalidateLayoutForCharacterRange:actualCharacterRange:

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

Объявление

Swift

func invalidateLayoutForCharacterRange(_ charRange: NSRange, actualCharacterRange actualCharRange: NSRangePointer)

Objective C

- (void)invalidateLayoutForCharacterRange:(NSRange)charRange actualCharacterRange:(NSRangePointer)actualCharRange

Параметры

`charRange`	Диапазон символов для лишения законной силы.
`actualCharRange`	Если нет `NULL`, на выводе, фактический диапазон, лишенный законной силы после любого необходимого расширения.

Обсуждение

Этот метод имеет тот же эффект как invalidateLayoutForCharacterRange:isSoft:actualCharacterRange: с flag набор к NOfalse.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– invalidateGlyphsForCharacterRange:changeInLength:actualCharacterRange:

invalidateDisplayForCharacterRange (_:) - invalidateDisplayForCharacterRange:

Лишает законной силы дисплей для данного диапазона символов.

Объявление

Swift

func invalidateDisplayForCharacterRange(_ charRange: NSRange)

Objective C

- (void)invalidateDisplayForCharacterRange:(NSRange)charRange

Параметры

charRange

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Отмечает глифы в данном диапазоне глифа как нуждающийся в дисплее, а также надлежащих областях NSTextView объекты, выводящие на экран те глифы (использующий NSView метод setNeedsDisplayInRect:).

Объявление

Swift

func invalidateDisplayForGlyphRange(_ glyphRange: NSRange)

Objective C

- (void)invalidateDisplayForGlyphRange:(NSRange)glyphRange

Параметры

glyphRange

Диапазон глифов для лишения законной силы.

Обсуждение

Необходимо редко должны быть вызвать этот метод.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    textContainerChangedGeometry (_:)
    - textContainerChangedGeometry:

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

Объявление

Swift

func textContainerChangedGeometry(_ aTextContainer: NSTextContainer)

Objective C

- (void)textContainerChangedGeometry:(NSTextContainer *)aTextContainer

Параметры


      aTextContainer

Текстовый контейнер, расположение которого лишено законной силы.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    textContainerChangedTextView (_:)
    - textContainerChangedTextView:

Информация об обновлениях должна была управлять NSTextView объекты в данном текстовом контейнере.

Объявление

Swift

func textContainerChangedTextView(_ aTextContainer: NSTextContainer)

Objective C

- (void)textContainerChangedTextView:(NSTextContainer *)aTextContainer

Параметры


      aTextContainer

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    textStorage (_: edited:range:changeInLength:invalidatedRange:)
    - textStorage:edited:range:changeInLength:invalidatedRange:

Лишает законной силы глиф и информацию макета для части текста в данном текстовом объекте хранения.

Объявление

Swift

func textStorage(_ aTextStorage: NSTextStorage, edited mask: NSTextStorageEditedOptions, range newCharRange: NSRange, changeInLength delta: Int, invalidatedRange invalidatedCharRange: NSRange)

Objective C

- (void)textStorage:(NSTextStorage *)aTextStorage edited:(NSTextStorageEditedOptions)mask range:(NSRange)newCharRange changeInLength:(NSInteger)delta invalidatedRange:(NSRange)invalidatedCharRange

Параметры

`aTextStorage`	Текстовое хранение, информация которого лишена законной силы.
`mask`	Указывает природу изменений. Его значение сделано путем объединения с оператором битового «ИЛИ» C констант, описанных в “Уведомлениях изменения” в `NSTextStorage` (`NSTextStorageEditedAttributes` и `NSTextStorageEditedCharacters`).
`newCharRange`	Указывает степень символов, следующих из редактирований.
`delta`	Если `NSTextStorageEditedCharacters` бит `mask` установлен, дает число символов, добавленных к или удаленный из исходного диапазона (иначе, его значение не важно).
`invalidatedCharRange`	Представляет диапазон символов, затронутых после того, как были фиксированы атрибуты. Любой равно `newCharRange` или больше. Например, удаление символа разделителя абзацев лишает законной силы информацию макета для всех символов в абзацах, предшествующих и следующих за разделителем.

Обсуждение

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

Например, после замены с «Несколькими» для создания строки “Несколько файлов не могли быть сохранены”, newCharRange {0, 7} и delta 4. Получатель использует эту информацию, чтобы обновить ее отображение символа к глифу и обновить диапазон выбора на основе изменения.

textStorage:edited:range:changeInLength:invalidatedRange: сообщения отправляются в ряду каждому NSLayoutManager объект связался с текстовым объектом хранения, таким образом, менеджеры по расположению, получающие их, не должны редактировать aTextStorage в то время как выполняется этот метод. Если один из них делает, newCharRange, delta, и invalidatedCharRange параметры являются неправильными для всего после менеджеров по расположению, получающих сообщение.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– invalidateLayoutForCharacterRange:isSoft:actualCharacterRange:

Включение фонового расположения


    
    setBackgroundLayoutEnabled:
    - setBackgroundLayoutEnabled:

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

Объявление

Swift

var backgroundLayoutEnabled: Bool

Objective C

@property BOOL backgroundLayoutEnabled

Параметры


      flag

Если YEStrue, фоновое расположение включено; если NOfalse, получатель выполняет генерацию глифа и расположение только при необходимости.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– backgroundLayoutEnabled

backgroundLayoutEnabled - backgroundLayoutEnabled

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

Объявление

Swift

var backgroundLayoutEnabled: Bool

Objective C

@property BOOL backgroundLayoutEnabled

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setBackgroundLayoutEnabled:

Доступ к глифам


    
    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`	Индекс, в котором можно вставить глиф.
`charIndex`	Индекс символа, на котором отображается глиф.

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– deleteGlyphsInRange:
– replaceGlyphAtIndex:withGlyph:


    
    insertGlyphs (_: length:forStartingGlyphAtIndex:characterIndex:)
    - insertGlyphs:length:forStartingGlyphAtIndex:characterIndex:

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

Объявление

Swift

func insertGlyphs(_ glyphs: UnsafePointer<NSGlyph>, length glyphIndex: Int, forStartingGlyphAtIndex length: Int, characterIndex charIndex: Int)

Objective C

- (void)insertGlyphs:(const NSGlyph *)glyphs length:(NSUInteger)glyphIndex forStartingGlyphAtIndex:(NSUInteger)length characterIndex:(NSUInteger)charIndex

Параметры

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

isValidGlyphIndex (_:) - isValidGlyphIndex:

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

Объявление

Swift

func isValidGlyphIndex(_ glyphIndex: Int) -> Bool

Objective C

- (BOOL)isValidGlyphIndex:(NSUInteger)glyphIndex

Параметры

glyphIndex

Индекс глифа в получателе.

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

YEStrue если указанное glyphIndex относится к допустимому глифу, иначе NOfalse.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    glyphAtIndex (_:)
    - glyphAtIndex:

Возвращает глиф в glyphIndex.

Объявление

Swift

func glyphAtIndex(_ glyphIndex: Int) -> NSGlyph

Objective C

- (NSGlyph)glyphAtIndex:(NSUInteger)glyphIndex

Параметры


      glyphIndex

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

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

Глиф в glyphIndex.

Обсуждение

Повышения NSRangeException если glyphIndex выходит за пределы.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– getGlyphs:range:


    
    glyphAtIndex (_: isValidIndex:)
    - glyphAtIndex:isValidIndex:

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

Объявление

Swift

func glyphAtIndex(_ glyphIndex: Int, isValidIndex isValidIndex: UnsafeMutablePointer<ObjCBool>) -> NSGlyph

Objective C

- (NSGlyph)glyphAtIndex:(NSUInteger)glyphIndex isValidIndex:(BOOL *)isValidIndex

Параметры

`glyphIndex`	Индекс глифа, который будет возвращен.
`isValidIndex`	Если нет `NULL`, на выводе, `YEStrue` если требуемый индекс находится в диапазоне; иначе `NOfalse`.

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

Глиф в требуемом индексе, или NSNullGlyph если требуемый индекс вне диапазона {0, numberOfGlyphs}.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– getGlyphs:range:
– glyphAtIndex:

replaceGlyphAtIndex (_: withGlyph:) - replaceGlyphAtIndex:withGlyph:

Заменяет глиф в данном индексе с новым глифом.

Объявление

Swift

func replaceGlyphAtIndex(_ glyphIndex: Int, withGlyph newGlyph: NSGlyph)

Objective C

- (void)replaceGlyphAtIndex:(NSUInteger)glyphIndex withGlyph:(NSGlyph)newGlyph

Параметры

glyphIndex

Индекс глифа для замены.

newGlyph

Новый глиф.

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setCharacterIndex:forGlyphAtIndex:
– invalidateGlyphsForCharacterRange:changeInLength:actualCharacterRange:
– invalidateLayoutForCharacterRange:isSoft:actualCharacterRange:


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

Заполняет переданный - в буфере с последовательностью глифов

Объявление

Swift

func getGlyphs(_ glyphArray: UnsafeMutablePointer<NSGlyph>, range glyphRange: NSRange) -> Int

Objective C

- (NSUInteger)getGlyphs:(NSGlyph *)glyphArray range:(NSRange)glyphRange

Параметры


      glyphArray

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


      glyphRange

Диапазон глифов, из которых можно возвратить визуализуемые глифы.

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

Фактическое число глифов, заполненных в массив, возвращается (не подсчет нулевого завершения).

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– glyphAtIndex:
– glyphAtIndex:isValidIndex:
– notShownAttributeForGlyphAtIndex:

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

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

Объявление

Swift

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

Objective C

- (NSUInteger)getGlyphsInRange:(NSRange)glyphRange glyphs:(NSGlyph *)glyphBuffer characterIndexes:(NSUInteger *)charIndexBuffer glyphInscriptions:(NSGlyphInscription *)inscribeBuffer elasticBits:(BOOL *)elasticBuffer

Обсуждение

Это - удобный метод для getGlyphsInRange:glyphs:characterIndexes:glyphInscriptions:elasticBits:bidiLevels: это не возвращает a bidiLevelBuffer.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


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

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

Объявление

Swift

func getGlyphsInRange(_ glyphRange: 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)glyphRange glyphs:(NSGlyph *)glyphBuffer characterIndexes:(NSUInteger *)charIndexBuffer glyphInscriptions:(NSGlyphInscription *)inscribeBuffer elasticBits:(BOOL *)elasticBuffer bidiLevels:(unsigned char *)bidiLevelBuffer

Параметры

`glyphRange`	Диапазон глифов для разметки.
`glyphBuffer`	На выводе последовательность глифов должна была разметить данный диапазон глифа.
`charIndexBuffer`	На выводе, индексах исходных символов, соответствующих данному диапазону глифа. Обратите внимание на то, что глиф в индексе 1 не обязательно отображается на символе в индексе 1, так как глиф может быть для лигатуры или диакритического знака.
`inscribeBuffer`	На выводе надпись приписывает для каждого глифа, которые используются для разметки символов, объединенных вместе. Возможные значения описаны в Константах.
`elasticBuffer`	На выводе, значения, указывающие, эластичен ли глиф для каждого глифа. Эластичный глиф может быть сделан более длинным в конце строки или, когда необходимый для выравнивания.
`bidiLevelBuffer`	На выводе, направлении каждого глифа для двунаправленного текста. Значения колеблются от 0 до 61, как определено Приложением № 9 Стандарта Unicode. Даже значение означает, что глиф идет слева направо, и нечетное значение означает, что глиф идет справа налево.

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

Число глифов возвратилось в glyphBuffer.

Обсуждение

Этот метод и getGlyphsInRange:glyphs:characterIndexes:glyphInscriptions:elasticBits: предназначаются прежде всего, чтобы позволить наборному устройству получить оптом глифы и другую информацию, что это должно выполнить расположение. Эти методы возвращают все глифы в диапазоне, включая NSNullGlyph и не - показанный глифы. Они не делают нулевой оконечный результаты. Каждый указатель передал в, должен или быть NULL, или иначе укажите на достаточную память для содержания glyphRange.length элементы.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

deleteGlyphsInRange (_:) - deleteGlyphsInRange:

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

Объявление

Swift

func deleteGlyphsInRange(_ glyphRange: NSRange)

Objective C

- (void)deleteGlyphsInRange:(NSRange)glyphRange

Параметры

glyphRange

Диапазон глифов для удаления.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– insertGlyph:atGlyphIndex:characterIndex:
numberOfGlyphs - numberOfGlyphs

Возвращает число глифов в получателе.

Объявление

Swift

var numberOfGlyphs: Int { get }

Objective C

@property(readonly) NSUInteger numberOfGlyphs

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

Число глифов.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Отображение символов к глифам


    
    setCharacterIndex (_: forGlyphAtIndex:)
    - setCharacterIndex:forGlyphAtIndex:

Устанавливает индекс символа, соответствующего глифу в данном индексе глифа.

Объявление

Swift

func setCharacterIndex(_ charIndex: Int, forGlyphAtIndex glyphIndex: Int)

Objective C

- (void)setCharacterIndex:(NSUInteger)charIndex forGlyphAtIndex:(NSUInteger)glyphIndex

Параметры

`charIndex`	Индекс для установки.
`glyphIndex`	Глиф, соответствующий символу, индекс которого установлен. Глиф должен уже присутствовать.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– characterIndexForGlyphAtIndex:
– characterRangeForGlyphRange:actualGlyphRange:
– glyphRangeForCharacterRange:actualCharacterRange:

characterIndexForGlyphAtIndex (_:) - characterIndexForGlyphAtIndex:

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

Объявление

Swift

func characterIndexForGlyphAtIndex(_ glyphIndex: Int) -> Int

Objective C

- (NSUInteger)characterIndexForGlyphAtIndex:(NSUInteger)glyphIndex

Параметры

glyphIndex

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

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

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

Обсуждение

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

Во многих случаях лучше использовать отображающие диапазон методы, characterRangeForGlyphRange:actualGlyphRange: и glyphRangeForCharacterRange:actualCharacterRange:, которые предоставляют более исчерпывающую информацию.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– glyphIndexForCharacterAtIndex:
glyphIndexForCharacterAtIndex (_:) - glyphIndexForCharacterAtIndex:

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

Объявление

Swift

func glyphIndexForCharacterAtIndex(_ charIndex: Int) -> Int

Objective C

- (NSUInteger)glyphIndexForCharacterAtIndex:(NSUInteger)charIndex

Параметры

charIndex

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

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

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

Обсуждение

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

Во многих случаях лучше использовать отображающие диапазон методы, characterRangeForGlyphRange:actualGlyphRange: и glyphRangeForCharacterRange:actualCharacterRange:, которые предоставляют более исчерпывающую информацию.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– characterIndexForGlyphAtIndex:


    
    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, на выводе, точках к полному спектру глифов, сгенерированных возвращенным диапазоном символов. Этот диапазон может быть идентичным или немного больше, чем требуемый диапазон глифа. Например, если текстовое хранение содержит символ “Ö” и кэш глифа содержит два атомарных глифа “O” и “¨”, и если glyphRange включает только первый или второй глиф, тогда actualGlyphRange установлен включить оба глифа.

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

Диапазон символов, генерировавших глифы в glyphRange.

Обсуждение

Если длина glyphRange 0, получающийся диапазон символов является диапазоном нулевой длины сразу после символа (ов), соответствующего предыдущему глифу, и actualGlyphRange также нулевая длина. Если glyphRange расширяется вне текстовой длины, метод усекает результат к числу символов в тексте.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– characterIndexForGlyphAtIndex:
– glyphRangeForCharacterRange:actualCharacterRange:


    
    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, на выводе, точках к фактическому диапазону символов, полностью определяющих возвращенный диапазон глифа. Этот диапазон может быть идентичным или немного больше, чем требуемый диапазон символов. Например, если текстовое хранение содержит символы»O«и»¨“, и хранилище глифа содержит единственный предсоставленный глиф» ¨Ö”, и если charRange включает только первый или второй символ, тогда actualCharRange установлен включить оба символа.

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

Диапазон глифов, сгенерированных charRange.

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– characterIndexForGlyphAtIndex:

Установка атрибутов глифа


    
    intAttribute (_: forGlyphAtIndex:)
    - intAttribute:forGlyphAtIndex:

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

Объявление

Swift

func intAttribute(_ attributeTag: Int, forGlyphAtIndex glyphIndex: Int) -> Int

Objective C

- (NSInteger)intAttribute:(NSInteger)attributeTag forGlyphAtIndex:(NSUInteger)glyphIndex

Параметры

`attributeTag`	Атрибут, значение которого возвращается.
`glyphIndex`	Индекс глифа, значение атрибута которого возвращается.

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

Значение атрибута, идентифицированного attributeTag и glyphIndex.

Обсуждение

Подклассы, определяющие их собственные атрибуты, должны переопределить этот метод для доступа к их собственному хранению для значений атрибута. Неотрицательные теги резервируются Apple; можно определить собственные атрибуты с помощью отрицательных тегов и установить использование значений setIntAttribute:value:forGlyphAtIndex:.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setIntAttribute:value:forGlyphAtIndex:


    
    setIntAttribute (_: value:forGlyphAtIndex:)
    - setIntAttribute:value:forGlyphAtIndex:

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

Объявление

Swift

func setIntAttribute(_ attributeTag: Int, value val: Int, forGlyphAtIndex glyphIndex: Int)

Objective C

- (void)setIntAttribute:(NSInteger)attributeTag value:(NSInteger)val forGlyphAtIndex:(NSUInteger)glyphIndex

Параметры

`attributeTag`	Пользовательский атрибут.
`val`	Новое значение атрибута.
`glyphIndex`	Индекс глифа, атрибут которого установлен.

Обсуждение

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

Этот метод является частью NSGlyphStorage протокол, для использования генератором глифа для установки атрибутов. Не обычно необходимо ни для кого, но генератора глифа (и возможно наборное устройство) вызвать его. Это предоставлено как открытый метод, таким образом, подклассы могут расширить его для принятия других атрибутов глифа. Добавить новый глиф приписывает текстовой системе, необходимо сделать две вещи. Во-первых, необходимо принять меры, чтобы генератор глифа или наборное устройство генерировали и интерпретировали его. Во-вторых, необходимо разделить на подклассы NSLayoutManager обеспечить где-нибудь для хранения нового атрибута, переопределяя этот метод и intAttribute:forGlyphAtIndex: распознать новые теги атрибута и реагировать на них, при передаче любых других атрибутов реализации суперкласса. NSLayoutManager реализация понимает атрибуты глифа, которые она подготовлена сохранить, как перечислено в Атрибутах Глифа.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– intAttribute:forGlyphAtIndex:


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

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

Объявление

Swift

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

Objective C

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

Параметры

`attachmentSize`	Размер глифа для установки.
`glyphRange`	Присоединяемая позиция глифа в потоке глифа.

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– attachmentSizeForGlyphAtIndex:
– setDefaultAttachmentScaling:

attachmentSizeForGlyphAtIndex (_:) - attachmentSizeForGlyphAtIndex:

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

Объявление

Swift

func attachmentSizeForGlyphAtIndex(_ glyphIndex: Int) -> NSSize

Objective C

- (NSSize)attachmentSizeForGlyphAtIndex:(NSUInteger)glyphIndex

Параметры

glyphIndex

Индекс присоединяемого глифа.

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

Размер для присоединяемой ячейки для занятия. Возвраты {-1.0, -1.0} если нет никакого присоединения, положенного для указанного глифа.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setAttachmentSize:forGlyphRange:
– defaultAttachmentScaling


    
    setDefaultAttachmentScaling:
    - setDefaultAttachmentScaling:

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

Объявление

Swift

var defaultAttachmentScaling: NSImageScaling

Objective C

@property NSImageScaling defaultAttachmentScaling

Параметры


      scaling

Масштабирующееся поведение установить. Посмотрите NSImageScaling для возможных значений. Значение по умолчанию NSScaleNone, подразумевать, что изображения отсекают вместо масштабирования.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– defaultAttachmentScaling

defaultAttachmentScaling - defaultAttachmentScaling

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

Объявление

Swift

var defaultAttachmentScaling: NSImageScaling

Objective C

@property NSImageScaling defaultAttachmentScaling

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setDefaultAttachmentScaling:


    
    showAttachmentCell (_: inRect:characterIndex:)
    - showAttachmentCell:inRect:characterIndex:

Рисует присоединяемую ячейку.

Объявление

Swift

func showAttachmentCell(_ cell: NSCell, inRect rect: NSRect, characterIndex attachmentIndex: Int)

Objective C

- (void)showAttachmentCell:(NSCell *)cell inRect:(NSRect)rect characterIndex:(NSUInteger)attachmentIndex

Параметры

`cell`	Присоединяемая ячейка для рисования.
`rect`	Прямоугольник, в котором можно нарисовать `cell`.
`attachmentIndex`	Расположение присоединяемой ячейки.

Обсуждение

attachmentIndex параметр предоставлен для ячеек, изменяющих их появление на основе их расположения.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Обработка расположения для текстовых контейнеров


    
    setTextContainer (_: forGlyphRange:)
    - setTextContainer:forGlyphRange:

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

Объявление

Swift

func setTextContainer(_ aTextContainer: NSTextContainer, forGlyphRange glyphRange: NSRange)

Objective C

- (void)setTextContainer:(NSTextContainer *)aTextContainer forGlyphRange:(NSRange)glyphRange

Параметры

`aTextContainer`	Текстовый контейнер для установки.
`glyphRange`	Диапазон глифов для разметки.

Обсуждение

Расположение в контейнере указано с setLineFragmentRect:forGlyphRange:usedRect: и setLocation:forStartOfGlyphRange: методы.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– textContainerForGlyphAtIndex:effectiveRange:

glyphRangeForTextContainer (_:) - glyphRangeForTextContainer:

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

Объявление

Swift

func glyphRangeForTextContainer(_ container: NSTextContainer) -> NSRange

Objective C

- (NSRange)glyphRangeForTextContainer:(NSTextContainer *)container

Обсуждение

Это - менее эффективный метод, чем подобное textContainerForGlyphAtIndex:effectiveRange:.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– textContainerForGlyphAtIndex:effectiveRange:


    
    textContainerForGlyphAtIndex (_: effectiveRange:)
    - textContainerForGlyphAtIndex:effectiveRange:

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

Объявление

Swift

func textContainerForGlyphAtIndex(_ glyphIndex: Int, effectiveRange effectiveGlyphRange: NSRangePointer) -> NSTextContainer?

Objective C

- (NSTextContainer *)textContainerForGlyphAtIndex:(NSUInteger)glyphIndex effectiveRange:(NSRangePointer)effectiveGlyphRange

Параметры

`glyphIndex`	Индекс глифа в возвращенном контейнере.
`effectiveGlyphRange`	Если нет `NULL`, на выводе, точках к целому диапазону глифов, которые находятся в возвращенном контейнере.

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

Текстовый контейнер тот, в который глиф в glyphIndex размечается.

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setTextContainer:forGlyphRange:


    
    textContainerForGlyphAtIndex (_: effectiveRange:withoutAdditionalLayout:)
    - textContainerForGlyphAtIndex:effectiveRange:withoutAdditionalLayout:

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

Объявление

Swift

func textContainerForGlyphAtIndex(_ glyphIndex: Int, effectiveRange effectiveGlyphRange: NSRangePointer, withoutAdditionalLayout flag: Bool) -> NSTextContainer?

Objective C

- (NSTextContainer *)textContainerForGlyphAtIndex:(NSUInteger)glyphIndex effectiveRange:(NSRangePointer)effectiveGlyphRange withoutAdditionalLayout:(BOOL)flag

Параметры

`glyphIndex`	Индекс глифа в возвращенном контейнере.
`effectiveGlyphRange`	Если нет `NULL`, на выводе, точках к целому диапазону глифов, которые находятся в возвращенном контейнере.
`flag`	Если `YEStrue`, генерация глифа и расположение не выполняются, таким образом, эта опция не должна использоваться, если расположение, как не известно, завершено для рассматриваемого диапазона, или если не включено расположение состоящее из нескольких несмежных участков; если `NOfalse`, оба выполняются по мере необходимости.

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

Текстовый контейнер тот, в который глиф в glyphIndex размечается.

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setTextContainer:forGlyphRange:

usedRectForTextContainer (_:) - usedRectForTextContainer:

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

Объявление

Swift

func usedRectForTextContainer(_ container: NSTextContainer) -> NSRect

Objective C

- (NSRect)usedRectForTextContainer:(NSTextContainer *)container

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

containerSize (NSTextContainer)


    
    characterIndexForPoint (_: inTextContainer:fractionOfDistanceBetweenInsertionPoints:)
    - characterIndexForPoint:inTextContainer:fractionOfDistanceBetweenInsertionPoints:

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

Объявление

Swift

func characterIndexForPoint(_ point: NSPoint, inTextContainer container: NSTextContainer, fractionOfDistanceBetweenInsertionPoints partialFraction: UnsafeMutablePointer<CGFloat>) -> Int

Objective C

- (NSUInteger)characterIndexForPoint:(NSPoint)point inTextContainer:(NSTextContainer *)container fractionOfDistanceBetweenInsertionPoints:(CGFloat *)partialFraction

Параметры

`point`	Точка для тестирования.
`container`	Текстовый контейнер, в котором тестируется точка.
`partialFraction`	Часть расстояния от точки вставки, логически перед данным символом к следующему.

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

Индекс символьного подпадания под point.

Обсуждение

Аналогичный glyphIndexForPoint:inTextContainer:fractionOfDistanceThroughGlyph:, но выраженный в условиях индекса символа. Метод возвращает индекс символьного подпадания под point, выраженный в системе координат container; если никакой символ не находится под точкой, самый близкий символ возвращается, где самый близкий определяется согласно требованиям выбора мышью. Однако это не просто эквивалентно взятию результата соответствующего индексного метода глифа и преобразования его к индексу символа, потому что в некоторых случаях единственный глиф представляет больше чем один выбираемый символ, например fi глиф лигатуры. В этом случае в глифе существует точка вставки, и этот метод возвращает один символ или другой, в зависимости от того, находится ли указанная точка налево или право на ту точку вставки.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Обработка прямоугольников фрагмента строки


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

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

Объявление

Swift

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

Objective C

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

Параметры

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

Обсуждение

Наборное устройство должно указать текстовый контейнер сначала с setTextContainer:forGlyphRange:, и это устанавливает точные позиции глифов впоследствии с setLocation:forStartOfGlyphRange:.

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

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– lineFragmentRectForGlyphAtIndex:effectiveRange:withoutAdditionalLayout:
– lineFragmentRectForGlyphAtIndex:effectiveRange:
– lineFragmentUsedRectForGlyphAtIndex:effectiveRange:withoutAdditionalLayout:
– lineFragmentUsedRectForGlyphAtIndex:effectiveRange:


    
    lineFragmentRectForGlyphAtIndex (_: effectiveRange:)
    - lineFragmentRectForGlyphAtIndex:effectiveRange:

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

Объявление

Swift

func lineFragmentRectForGlyphAtIndex(_ glyphIndex: Int, effectiveRange effectiveGlyphRange: NSRangePointer) -> NSRect

Objective C

- (NSRect)lineFragmentRectForGlyphAtIndex:(NSUInteger)glyphIndex effectiveRange:(NSRangePointer)effectiveGlyphRange

Параметры

`glyphIndex`	Глиф, для которого можно возвратить прямоугольник фрагмента строки.
`effectiveGlyphRange`	Если нет `NULL`, на выводе, диапазоне для всех глифов во фрагменте строки.

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

Фрагмент строки, в котором размечается данный глиф.

Обсуждение

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

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– lineFragmentUsedRectForGlyphAtIndex:effectiveRange:
– setLineFragmentRect:forGlyphRange:usedRect:


    
    lineFragmentRectForGlyphAtIndex (_: effectiveRange:withoutAdditionalLayout:)
    - lineFragmentRectForGlyphAtIndex:effectiveRange:withoutAdditionalLayout:

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

Объявление

Swift

func lineFragmentRectForGlyphAtIndex(_ glyphIndex: Int, effectiveRange effectiveGlyphRange: NSRangePointer, withoutAdditionalLayout flag: Bool) -> NSRect

Objective C

- (NSRect)lineFragmentRectForGlyphAtIndex:(NSUInteger)glyphIndex effectiveRange:(NSRangePointer)effectiveGlyphRange withoutAdditionalLayout:(BOOL)flag

Параметры

`glyphIndex`	Глиф, для которого можно возвратить прямоугольник фрагмента строки.
`effectiveGlyphRange`	Если нет `NULL`, на выводе, диапазоне для всех глифов во фрагменте строки.
`flag`	Если `YEStrue`, генерация глифа и расположение не выполняются, таким образом, эта опция не должна использоваться, если расположение, как не известно, завершено для рассматриваемого диапазона, или если не включено расположение состоящее из нескольких несмежных участков; если `NOfalse`, оба выполняются по мере необходимости.

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

Фрагмент строки, в котором размечается данный глиф.

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setLineFragmentRect:forGlyphRange:usedRect:
– lineFragmentUsedRectForGlyphAtIndex:effectiveRange:withoutAdditionalLayout:


    
    lineFragmentUsedRectForGlyphAtIndex (_: effectiveRange:)
    - lineFragmentUsedRectForGlyphAtIndex:effectiveRange:

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

Объявление

Swift

func lineFragmentUsedRectForGlyphAtIndex(_ glyphIndex: Int, effectiveRange effectiveGlyphRange: NSRangePointer) -> NSRect

Objective C

- (NSRect)lineFragmentUsedRectForGlyphAtIndex:(NSUInteger)glyphIndex effectiveRange:(NSRangePointer)effectiveGlyphRange

Параметры

`glyphIndex`	Глиф, для которого можно возвратить фрагмент строки, использовал прямоугольник.
`effectiveGlyphRange`	Если нет `NULL`, на выводе, диапазоне для всех глифов во фрагменте строки.

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

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

Обсуждение

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

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– lineFragmentRectForGlyphAtIndex:effectiveRange:
– setLineFragmentRect:forGlyphRange:usedRect:


    
    lineFragmentUsedRectForGlyphAtIndex (_: effectiveRange:withoutAdditionalLayout:)
    - lineFragmentUsedRectForGlyphAtIndex:effectiveRange:withoutAdditionalLayout:

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

Объявление

Swift

func lineFragmentUsedRectForGlyphAtIndex(_ glyphIndex: Int, effectiveRange effectiveGlyphRange: NSRangePointer, withoutAdditionalLayout flag: Bool) -> NSRect

Objective C

- (NSRect)lineFragmentUsedRectForGlyphAtIndex:(NSUInteger)glyphIndex effectiveRange:(NSRangePointer)effectiveGlyphRange withoutAdditionalLayout:(BOOL)flag

Параметры

`glyphIndex`	Глиф, для которого можно возвратить фрагмент строки, использовал прямоугольник.
`effectiveGlyphRange`	Если нет `NULL`, на выводе, диапазоне для всех глифов во фрагменте строки.
`flag`	Если `YEStrue`, генерация глифа и расположение не выполняются, таким образом, эта опция не должна использоваться, если расположение, как не известно, завершено для рассматриваемого диапазона, или если не включено расположение состоящее из нескольких несмежных участков; если `NOfalse`, оба выполняются по мере необходимости.

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

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

Обсуждение

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

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setLineFragmentRect:forGlyphRange:usedRect:
– lineFragmentRectForGlyphAtIndex:effectiveRange:withoutAdditionalLayout:


    
    setExtraLineFragmentRect (_: usedRect:textContainer:)
    - setExtraLineFragmentRect:usedRect:textContainer:

Устанавливает границы и контейнер для дополнительного фрагмента строки.

Объявление

Swift

func setExtraLineFragmentRect(_ aRect: NSRect, usedRect usedRect: NSRect, textContainer aTextContainer: NSTextContainer?)

Objective C

- (void)setExtraLineFragmentRect:(NSRect)aRect usedRect:(NSRect)usedRect textContainer:(NSTextContainer *)aTextContainer

Параметры

`aRect`	Прямоугольник для установки.
`usedRect`	Указывает, где нарисована точка вставки.
`aTextContainer`	Текстовый контейнер, где должен быть размечен прямоугольник.

Обсуждение

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

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– extraLineFragmentRect
– extraLineFragmentUsedRect
– textContainers

extraLineFragmentRect - extraLineFragmentRect

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

Объявление

Swift

var extraLineFragmentRect: NSRect { get }

Objective C

@property(readonly) NSRect extraLineFragmentRect

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

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

Обсуждение

Прямоугольник определяется в системе координат NSTextContainer. Возвраты NSZeroRect если нет такого прямоугольника.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– extraLineFragmentUsedRect
– extraLineFragmentTextContainer
– setExtraLineFragmentRect:usedRect:textContainer:
extraLineFragmentUsedRect - extraLineFragmentUsedRect

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

Объявление

Swift

var extraLineFragmentUsedRect: NSRect { get }

Objective C

@property(readonly) NSRect extraLineFragmentUsedRect

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

Прямоугольник, включающий точку вставки.

Обсуждение

Прямоугольник определяется в системе координат NSTextContainer. Возвраты NSZeroRect если нет никакого дополнительного прямоугольника фрагмента строки.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– extraLineFragmentRect
– extraLineFragmentTextContainer
– setExtraLineFragmentRect:usedRect:textContainer:
extraLineFragmentTextContainer - extraLineFragmentTextContainer

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

Объявление

Swift

var extraLineFragmentTextContainer: NSTextContainer? { get }

Objective C

@property(readonly, strong) NSTextContainer *extraLineFragmentTextContainer

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

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

Обсуждение

Этот прямоугольник используется для отображения точки вставки в конце текста (или в пустом тексте или после заключительного разделителя абзацев).

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– extraLineFragmentRect
– extraLineFragmentUsedRect
– setExtraLineFragmentRect:usedRect:textContainer:


    
    setDrawsOutsideLineFragment (_: forGlyphAtIndex:)
    - setDrawsOutsideLineFragment:forGlyphAtIndex:

Указывает, превышает ли данный глиф границы фрагмента строки, где это размечается.

Объявление

Swift

func setDrawsOutsideLineFragment(_ flag: Bool, forGlyphAtIndex glyphIndex: Int)

Objective C

- (void)setDrawsOutsideLineFragment:(BOOL)flag forGlyphAtIndex:(NSUInteger)glyphIndex

Параметры

`flag`	Если `YEStrue`, устанавливает данный глиф для рисования вне его фрагмента строки; если `NOfalse`, глиф не рисует снаружи.
`glyphIndex`	Индекс глифа для установки.

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– drawsOutsideLineFragmentForGlyphAtIndex:

drawsOutsideLineFragmentForGlyphAtIndex (_:) - drawsOutsideLineFragmentForGlyphAtIndex:

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

Объявление

Swift

func drawsOutsideLineFragmentForGlyphAtIndex(_ glyphIndex: Int) -> Bool

Objective C

- (BOOL)drawsOutsideLineFragmentForGlyphAtIndex:(NSUInteger)glyphIndex

Параметры

glyphIndex

Индекс глифа.

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

YEStrue если глиф в glyphIndex превышает границы фрагмента строки, где он размечается, NOfalse иначе.

Обсуждение

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

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

Глифы, рисующие вне их прямоугольников фрагмента строки, не рассматривают при вычислении включения прямоугольников с rectArrayForCharacterRange:withinSelectedCharacterRange:inTextContainer:rectCount: и rectArrayForGlyphRange:withinSelectedGlyphRange:inTextContainer:rectCount: методы. Ими, однако, рассматривают boundingRectForGlyphRange:inTextContainer:.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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


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

Устанавливает расположение для первого глифа данного диапазона.

Объявление

Swift

func setLocation(_ aPoint: NSPoint, forStartOfGlyphRange glyphRange: NSRange)

Objective C

- (void)setLocation:(NSPoint)aPoint forStartOfGlyphRange:(NSRange)glyphRange

Параметры

`aPoint`	Расположение, в которое первый глиф установлен относительно источника источника фрагмента строки глифа.
`glyphRange`	Глифы, расположение которых установлено.

Обсуждение

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

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– rangeOfNominallySpacedGlyphsContainingIndex:


    
    setLocations (_: startingGlyphIndexes:count:forGlyphRange:)
    - setLocations:startingGlyphIndexes:count:forGlyphRange:

Расположения наборов для многих диапазонов глифа сразу.

Объявление

Swift

func setLocations(_ locations: NSPointArray, startingGlyphIndexes glyphIndexes: UnsafeMutablePointer<Int>, count count: Int, forGlyphRange glyphRange: NSRange)

Objective C

- (void)setLocations:(NSPointArray)locations startingGlyphIndexes:(NSUInteger *)glyphIndexes count:(NSUInteger)count forGlyphRange:(NSRange)glyphRange

Параметры

`locations`	Расположения, в которые первый глиф в каждом диапазоне установлен относительно источника источника фрагмента строки глифа.
`glyphIndexes`	Индексы в `glyphRange` из глифов, расположения которых установлены.
`count`	Число глифов, расположения которых установлены.
`glyphRange`	Весь диапазон глифа, содержащий все глифы, расположения которых установлены.

Обсуждение

Этот метод позволяет наборному устройству установить расположения для диапазонов глифа оптом. Все указанные индексы глифа должны лечь в указанном диапазоне глифа. Первый из них должен быть равен glyphRange.location, и остаток должен увеличиться монотонно. Каждое расположение установлено как расположение для диапазона, начинающегося в соответствующем индексе глифа и продолжающегося до последующего индекса глифа, или до конца диапазона глифа для последнего расположения. Таким образом этот метод эквивалентен вызову setLocation:forStartOfGlyphRange: для ряда диапазонов, покрывающих все глифы в glyphRange.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

locationForGlyphAtIndex (_:) - locationForGlyphAtIndex:

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

Объявление

Swift

func locationForGlyphAtIndex(_ glyphIndex: Int) -> NSPoint

Objective C

- (NSPoint)locationForGlyphAtIndex:(NSUInteger)glyphIndex

Параметры

glyphIndex

Глиф, расположение которого возвращается.

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

Расположение данного глифа.

Обсуждение

Если данному глифу не устанавливали явное расположение для него (например, если это - часть (но не сначала в) последовательность номинально расположенных с интервалами символов), расположение вычисляется продвижениями глифа от расположения нового предыдущего глифа с набором расположения.

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– lineFragmentRectForGlyphAtIndex:effectiveRange:
– lineFragmentUsedRectForGlyphAtIndex:effectiveRange:
rangeOfNominallySpacedGlyphsContainingIndex (_:) - rangeOfNominallySpacedGlyphsContainingIndex:

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

Объявление

Swift

func rangeOfNominallySpacedGlyphsContainingIndex(_ glyphIndex: Int) -> NSRange

Objective C

- (NSRange)rangeOfNominallySpacedGlyphsContainingIndex:(NSUInteger)glyphIndex

Параметры

glyphIndex

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

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

Диапазон номинально расположенных с интервалами глифов.

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    getLineFragmentInsertionPointsForCharacterAtIndex (_: alternatePositions:inDisplayOrder:positions:characterIndexes:)
    - getLineFragmentInsertionPointsForCharacterAtIndex:alternatePositions:inDisplayOrder:positions:characterIndexes:

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

Объявление

Swift

func getLineFragmentInsertionPointsForCharacterAtIndex(_ charIndex: Int, alternatePositions aFlag: Bool, inDisplayOrder dFlag: Bool, positions positions: UnsafeMutablePointer<CGFloat>, characterIndexes charIndexes: UnsafeMutablePointer<Int>) -> Int

Objective C

- (NSUInteger)getLineFragmentInsertionPointsForCharacterAtIndex:(NSUInteger)charIndex alternatePositions:(BOOL)aFlag inDisplayOrder:(BOOL)dFlag positions:(CGFloat *)positions characterIndexes:(NSUInteger *)charIndexes

Параметры

`charIndex`	Индекс символа одного символа во фрагменте строки.
`aFlag`	Если `YEStrue`, альтернатива возвратов, а не основные, точки вставки.
`dFlag`	Если `YEStrue`, точки вставки возвратов в дисплее, а не логичный, порядок.
`positions`	На выводе указаны позиции точек вставки, в порядке.
`charIndexes`	На выводе, индексах символов, соответствующих возвращенным точкам вставки.

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

Число точек вставки возвратилось.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– rectArrayForCharacterRange:withinSelectedCharacterRange:inTextContainer:rectCount:
– rectArrayForGlyphRange:withinSelectedGlyphRange:inTextContainer:rectCount:


    
    rectArrayForCharacterRange (_: withinSelectedCharacterRange:inTextContainer:rectCount:)
    - rectArrayForCharacterRange:withinSelectedCharacterRange:inTextContainer:rectCount:

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

Объявление

Swift

func rectArrayForCharacterRange(_ charRange: NSRange, withinSelectedCharacterRange selCharRange: NSRange, inTextContainer container: NSTextContainer, rectCount rectCount: UnsafeMutablePointer<Int>) -> NSRectArray

Objective C

- (NSRectArray)rectArrayForCharacterRange:(NSRange)charRange withinSelectedCharacterRange:(NSRange)selCharRange inTextContainer:(NSTextContainer *)container rectCount:(NSUInteger *)rectCount

Параметры

`charRange`	Диапазон символов, для которого можно возвратить прямоугольники.
`selCharRange`	Выделенные символы в `charRange`, который может влиять на размер прямоугольников; это должно быть равно или содержать `charRange`. Если вызывающая сторона интересуется этим больше с точки зрения включения, а не точки зрения выбора, передачи `{NSNotFound, 0}` как выбранный диапазон.
`container`	Текстовый контейнер, в котором размечается текст.
`rectCount`	Число прямоугольников возвратилось.

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

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

Обсуждение

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

Этот метод сделает минимальную сумму работы, требуемой отвечать на вопрос. Полученный массив принадлежит менеджеру по расположению и будет снова использован когда этот метод, rectArrayForGlyphRange:withinSelectedGlyphRange:inTextContainer:rectCount:, или boundingRectForGlyphRange:inTextContainer: вызывается. Один из этих методов можно вызвать косвенно. Если Вы не собираетесь использовать прямоугольники сразу же, необходимо скопировать их в другое расположение. Эти прямоугольники всегда находятся в контейнерных координатах.

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

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– glyphRangeForTextContainer:
– characterRangeForGlyphRange:actualGlyphRange:
– drawsOutsideLineFragmentForGlyphAtIndex:


    
    rectArrayForGlyphRange (_: withinSelectedGlyphRange:inTextContainer:rectCount:)
    - rectArrayForGlyphRange:withinSelectedGlyphRange:inTextContainer:rectCount:

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

Объявление

Swift

func rectArrayForGlyphRange(_ glyphRange: NSRange, withinSelectedGlyphRange selGlyphRange: NSRange, inTextContainer container: NSTextContainer, rectCount rectCount: UnsafeMutablePointer<Int>) -> NSRectArray

Objective C

- (NSRectArray)rectArrayForGlyphRange:(NSRange)glyphRange withinSelectedGlyphRange:(NSRange)selGlyphRange inTextContainer:(NSTextContainer *)container rectCount:(NSUInteger *)rectCount

Параметры

`glyphRange`	Диапазон глифа, для которого можно возвратить прямоугольники.
`selGlyphRange`	Выбранные глифы в `glyphRange`, который может влиять на размер прямоугольников; это должно быть равно или содержать `glyphRange`. Если вызывающая сторона интересуется этим больше с точки зрения включения, а не точки зрения выбора, передачи `{NSNotFound, 0}` как выбранный диапазон.
`container`	Текстовый контейнер, в котором размечается текст.
`rectCount`	Число прямоугольников возвратилось.

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

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

Обсуждение

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

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

Этот метод сделает минимальную сумму работы, требуемой отвечать на вопрос. Полученный массив принадлежит менеджеру по расположению и будет снова использован когда этот метод, rectArrayForCharacterRange:withinSelectedCharacterRange:inTextContainer:rectCount:, или boundingRectForGlyphRange:inTextContainer: вызывается. Один из этих методов можно вызвать косвенно. Если Вы не собираетесь использовать прямоугольники сразу же, необходимо скопировать их в другое расположение. Эти прямоугольники всегда находятся в контейнерных координатах.

Цель этого метода состоит в том, чтобы вычислить прямоугольники строки для рисования фона текста и выделения. Эти прямоугольники не обязательно включают глифы, рисующие вне их прямоугольников фрагмента строки; использовать boundingRectForGlyphRange:inTextContainer: определить область, содержащую все получение, выполняемое для диапазона глифов.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– glyphRangeForTextContainer:
– glyphRangeForCharacterRange:actualCharacterRange:
– drawsOutsideLineFragmentForGlyphAtIndex:


    
    boundingRectForGlyphRange (_: inTextContainer:)
    - boundingRectForGlyphRange:inTextContainer:

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

Объявление

Swift

func boundingRectForGlyphRange(_ glyphRange: NSRange, inTextContainer container: NSTextContainer) -> NSRect

Objective C

- (NSRect)boundingRectForGlyphRange:(NSRange)glyphRange inTextContainer:(NSTextContainer *)container

Параметры

`glyphRange`	Диапазон глифов, для которых можно возвратить ограничительный прямоугольник.
`container`	Текстовый контейнер, в котором размечаются глифы.

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

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

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– glyphRangeForBoundingRect:inTextContainer:
– glyphRangeForTextContainer:
– drawsOutsideLineFragmentForGlyphAtIndex:


    
    glyphRangeForBoundingRect (_: inTextContainer:)
    - glyphRangeForBoundingRect:inTextContainer:

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

Объявление

Swift

func glyphRangeForBoundingRect(_ bounds: NSRect, inTextContainer container: NSTextContainer) -> NSRange

Objective C

- (NSRange)glyphRangeForBoundingRect:(NSRect)bounds inTextContainer:(NSTextContainer *)container

Параметры

`bounds`	Ограничительный прямоугольник, для которого можно возвратить глифы.
`container`	Текстовый контейнер, в котором размечаются глифы.

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

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

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– glyphRangeForBoundingRectWithoutAdditionalLayout:inTextContainer:


    
    glyphRangeForBoundingRectWithoutAdditionalLayout (_: inTextContainer:)
    - glyphRangeForBoundingRectWithoutAdditionalLayout:inTextContainer:

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

Объявление

Swift

func glyphRangeForBoundingRectWithoutAdditionalLayout(_ bounds: NSRect, inTextContainer container: NSTextContainer) -> NSRange

Objective C

- (NSRange)glyphRangeForBoundingRectWithoutAdditionalLayout:(NSRect)bounds inTextContainer:(NSTextContainer *)container

Параметры

`bounds`	Ограничительный прямоугольник, для которого можно возвратить глифы.
`container`	Текстовый контейнер, в котором размечаются глифы.

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

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

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– glyphRangeForBoundingRect:inTextContainer:


    
    glyphIndexForPoint (_: inTextContainer:fractionOfDistanceThroughGlyph:)
    - glyphIndexForPoint:inTextContainer:fractionOfDistanceThroughGlyph:

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

Объявление

Swift

func glyphIndexForPoint(_ point: NSPoint, inTextContainer container: NSTextContainer, fractionOfDistanceThroughGlyph partialFraction: UnsafeMutablePointer<CGFloat>) -> Int

Objective C

- (NSUInteger)glyphIndexForPoint:(NSPoint)point inTextContainer:(NSTextContainer *)container fractionOfDistanceThroughGlyph:(CGFloat *)partialFraction

Параметры

`point`	Точка, для которой можно возвратить глиф в координатах `container`.
`container`	Контейнер, в котором размечается возвращенный глиф.
`partialFraction`	Если нет `NULL`, на выводе часть расстояния между расположением глифа возвратилась и расположение следующего глифа.

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

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

Обсуждение

Если никакой глиф не находится под point, самый близкий глиф возвращается, где самый близкий определяется согласно требованиям выбора мышью. Клиенты, хотящие определить, находится ли точка фактически в границах глифа, возвратились, должен следовать за этим с вызовом к boundingRectForGlyphRange:inTextContainer: и тест, падает ли точка в прямоугольнике, возвращенном тем методом. Если partialFraction не-NULL, это возвращается ссылкой, которую часть расстояния между расположением глифа возвратила и расположение следующего глифа.

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

Если поток глифа содержит глифы и «b» с шириной существа 13 точек и пользовательские щелчки по расположению 8 точек в, partialFraction 8/13, или 0.615. В этом случае данный вопрос должен быть рассмотрен как падающий между и «b» в целях, таких как вытаскивание выбора или размещение точки вставки.

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

Как часть его реализации, это вызовы метода fractionOfDistanceThroughGlyphForPoint:inTextContainer: и glyphIndexForPoint:inTextContainer:. Для изменения поведения этого метода переопределите те два метода вместо этого.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

fractionOfDistanceThroughGlyphForPoint (_: inTextContainer:) - fractionOfDistanceThroughGlyphForPoint:inTextContainer:

Этот метод является примитивом для glyphIndexForPoint:inTextContainer:fractionOfDistanceThroughGlyph:. Необходимо всегда вызывать основной метод, не примитивы.

Объявление

Swift

func fractionOfDistanceThroughGlyphForPoint(_ point: NSPoint, inTextContainer container: NSTextContainer) -> CGFloat

Objective C

- (CGFloat)fractionOfDistanceThroughGlyphForPoint:(NSPoint)point inTextContainer:(NSTextContainer *)container

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– glyphIndexForPoint:inTextContainer:
glyphIndexForPoint (_: inTextContainer:) - glyphIndexForPoint:inTextContainer:

Этот метод является примитивом для glyphIndexForPoint:inTextContainer:fractionOfDistanceThroughGlyph:. Необходимо всегда вызывать основной метод, не примитивы.

Объявление

Swift

func glyphIndexForPoint(_ point: NSPoint, inTextContainer container: NSTextContainer) -> Int

Objective C

- (NSUInteger)glyphIndexForPoint:(NSPoint)point inTextContainer:(NSTextContainer *)container

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– fractionOfDistanceThroughGlyphForPoint:inTextContainer:

Обработка расположения для текстовых блоков


    
    setLayoutRect (_: forTextBlock:glyphRange:)
    - setLayoutRect:forTextBlock:glyphRange:

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

Объявление

Swift

func setLayoutRect(_ rect: NSRect, forTextBlock block: NSTextBlock, glyphRange glyphRange: NSRange)

Objective C

- (void)setLayoutRect:(NSRect)rect forTextBlock:(NSTextBlock *)block glyphRange:(NSRange)glyphRange

Параметры

`rect`	Прямоугольник расположения для установки.
`block`	Текстовый блок, прямоугольник расположения которого установлен.
`glyphRange`	Диапазон глифов в текстовом блоке.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– layoutRectForTextBlock:atIndex:effectiveRange:
– layoutRectForTextBlock:glyphRange:

layoutRectForTextBlock (_: glyphRange:) - layoutRectForTextBlock:glyphRange:

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

Объявление

Swift

func layoutRectForTextBlock(_ block: NSTextBlock, glyphRange glyphRange: NSRange) -> NSRect

Objective C

- (NSRect)layoutRectForTextBlock:(NSTextBlock *)block glyphRange:(NSRange)glyphRange

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

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setLayoutRect:forTextBlock:glyphRange:


    
    setBoundsRect (_: forTextBlock:glyphRange:)
    - setBoundsRect:forTextBlock:glyphRange:

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

Объявление

Swift

func setBoundsRect(_ rect: NSRect, forTextBlock block: NSTextBlock, glyphRange glyphRange: NSRange)

Objective C

- (void)setBoundsRect:(NSRect)rect forTextBlock:(NSTextBlock *)block glyphRange:(NSRange)glyphRange

Параметры

`rect`	Ограничительный прямоугольник для установки.
`block`	Текстовый блок, ограничительный прямоугольник которого установлен.
`glyphRange`	Диапазон глифов в текстовом блоке.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– boundingRectForGlyphRange:inTextContainer:
– boundsRectForTextBlock:atIndex:effectiveRange:
– boundsRectForTextBlock:glyphRange:


    
    boundsRectForTextBlock (_: glyphRange:)
    - boundsRectForTextBlock:glyphRange:

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

Объявление

Swift

func boundsRectForTextBlock(_ block: NSTextBlock, glyphRange glyphRange: NSRange) -> NSRect

Objective C

- (NSRect)boundsRectForTextBlock:(NSTextBlock *)block glyphRange:(NSRange)glyphRange

Параметры

`block`	Текстовый блок, прямоугольник границ которого возвращается.
`glyphRange`	Диапазон глифов в текстовом блоке.

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

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setBoundsRect:forTextBlock:glyphRange:


    
    layoutRectForTextBlock (_: atIndex:effectiveRange:)
    - layoutRectForTextBlock:atIndex:effectiveRange:

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

Объявление

Swift

func layoutRectForTextBlock(_ block: NSTextBlock, atIndex glyphIndex: Int, effectiveRange effectiveGlyphRange: NSRangePointer) -> NSRect

Objective C

- (NSRect)layoutRectForTextBlock:(NSTextBlock *)block atIndex:(NSUInteger)glyphIndex effectiveRange:(NSRangePointer)effectiveGlyphRange

Параметры

`block`	Текстовый блок, прямоугольник расположения которого возвращается.
`glyphIndex`	Индекс глифа.
`effectiveGlyphRange`	Если нет `NULL`, на выводе, диапазоне для всех глифов в текстовом блоке.

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

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setLayoutRect:forTextBlock:glyphRange:


    
    boundsRectForTextBlock (_: atIndex:effectiveRange:)
    - boundsRectForTextBlock:atIndex:effectiveRange:

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

Объявление

Swift

func boundsRectForTextBlock(_ block: NSTextBlock, atIndex glyphIndex: Int, effectiveRange effectiveGlyphRange: NSRangePointer) -> NSRect

Objective C

- (NSRect)boundsRectForTextBlock:(NSTextBlock *)block atIndex:(NSUInteger)glyphIndex effectiveRange:(NSRangePointer)effectiveGlyphRange

Параметры

`block`	Текстовый блок, ограничительный прямоугольник которого возвращается.
`glyphIndex`	Индекс глифа.
`effectiveGlyphRange`	Если нет `NULL`, на выводе, диапазоне для всех глифов в текстовом блоке.

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

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setBoundsRect:forTextBlock:glyphRange:

Отображение специальных глифов


    
    setNotShownAttribute (_: forGlyphAtIndex:)
    - setNotShownAttribute:forGlyphAtIndex:

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

Объявление

Swift

func setNotShownAttribute(_ flag: Bool, forGlyphAtIndex glyphIndex: Int)

Objective C

- (void)setNotShownAttribute:(BOOL)flag forGlyphAtIndex:(NSUInteger)glyphIndex

Параметры

`flag`	Если `YEStrue`, глиф не показан; если `NOfalse`, это показано.
`glyphIndex`	Индекс глифа, атрибут которого установлен.

Обсуждение

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

Повышения NSRangeException если glyphIndex выходит за пределы.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– notShownAttributeForGlyphAtIndex:

notShownAttributeForGlyphAtIndex (_:) - notShownAttributeForGlyphAtIndex:

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

Объявление

Swift

func notShownAttributeForGlyphAtIndex(_ glyphIndex: Int) -> Bool

Objective C

- (BOOL)notShownAttributeForGlyphAtIndex:(NSUInteger)glyphIndex

Параметры

glyphIndex

Индекс глифа.

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

YEStrue если глиф в glyphIndex не показан; иначе NOfalse.

Обсуждение

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

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

Повышения NSRangeException если glyphIndex выходит за пределы.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setNotShownAttribute:forGlyphAtIndex:


    
    setShowsInvisibleCharacters:
    - setShowsInvisibleCharacters:

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

Объявление

Swift

var showsInvisibleCharacters: Bool

Objective C

@property BOOL showsInvisibleCharacters

Параметры


      flag

Если YEStrue, получатель заменяет видимыми глифами невидимые символы, если шрифт и сценарий поддерживают его; если NOfalse, это не делает. Значение по умолчанию NOfalse.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setShowsControlCharacters:
– showsInvisibleCharacters

showsInvisibleCharacters - showsInvisibleCharacters

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

Объявление

Swift

var showsInvisibleCharacters: Bool

Objective C

@property BOOL showsInvisibleCharacters

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

YEStrue если получатель заменяет видимыми глифами невидимые символы, если шрифт и сценарий поддерживают его; иначе NOfalse. Значение по умолчанию NOfalse.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– showsControlCharacters
– setShowsInvisibleCharacters:


    
    setShowsControlCharacters:
    - setShowsControlCharacters:

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

Объявление

Swift

var showsControlCharacters: Bool

Objective C

@property BOOL showsControlCharacters

Параметры


      flag

Если YEStrue, получатель заменяет видимыми глифами управляющие символы, если шрифт и сценарий поддерживают его; если NOfalse, это не делает. Значение по умолчанию NOfalse.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setShowsInvisibleCharacters:
– showsControlCharacters

showsControlCharacters - showsControlCharacters

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

Объявление

Swift

var showsControlCharacters: Bool

Objective C

@property BOOL showsControlCharacters

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– showsInvisibleCharacters
– setShowsControlCharacters:
layoutOptions - layoutOptions

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

Объявление

Swift

var layoutOptions: Int { get }

Objective C

@property(readonly) NSUInteger layoutOptions

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

Немного маски, представляющей опции текущего макета, как определено в Layout Options в ссылке на протокол NSGlyphStorage.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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


    
    setHyphenationFactor:
    - setHyphenationFactor:

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

Объявление

Swift

var hyphenationFactor: Float

Objective C

@property float hyphenationFactor

Параметры


      factor

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

Обсуждение

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

Может быть переопределен на основе на абзац NSParagraphStyle метод hyphenationFactor.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– hyphenationFactor

hyphenationFactor - hyphenationFactor

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

Объявление

Swift

var hyphenationFactor: Float

Objective C

@property float hyphenationFactor

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

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setHyphenationFactor:

Нахождение символов и глифов, не размеченных


    
    getFirstUnlaidCharacterIndex (_: glyphIndex:)
    - getFirstUnlaidCharacterIndex:glyphIndex:

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

Объявление

Swift

func getFirstUnlaidCharacterIndex(_ charIndex: UnsafeMutablePointer<Int>, glyphIndex glyphIndex: UnsafeMutablePointer<Int>)

Objective C

- (void)getFirstUnlaidCharacterIndex:(NSUInteger *)charIndex glyphIndex:(NSUInteger *)glyphIndex

Параметры

`charIndex`	По возврату, если нет `NULL`, индекс первого символа, имеющего недопустимую информацию макета
`glyphIndex`	По возврату, если нет `NULL`, индекс первого глифа, имеющего недопустимую информацию макета.

Обсуждение

Любой параметр может быть NULL, когда получатель просто игнорирует его.

Как часть его реализации, это вызовы метода firstUnlaidCharacterIndex и firstUnlaidGlyphIndex. Для изменения поведения этого метода переопределите те два метода вместо этого.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

firstUnlaidCharacterIndex - firstUnlaidCharacterIndex

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

Объявление

Swift

var firstUnlaidCharacterIndex: Int { get }

Objective C

@property(readonly) NSUInteger firstUnlaidCharacterIndex

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

Индекс символа.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

var firstUnlaidGlyphIndex: Int { get }

Objective C

@property(readonly) NSUInteger firstUnlaidGlyphIndex

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

Индекс глифа.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Используя экранные шрифты


    
    setUsesScreenFonts:
    - setUsesScreenFonts:

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

Объявление

Swift

var usesScreenFonts: Bool

Objective C

@property BOOL usesScreenFonts

Параметры


      flag

Если YEStrue, получатель использует экранные шрифты; если NOfalse, это не делает.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– usesScreenFonts
– substituteFontForFont:

usesScreenFonts - usesScreenFonts

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

Объявление

Swift

var usesScreenFonts: Bool

Objective C

@property BOOL usesScreenFonts

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setUsesScreenFonts:
– substituteFontForFont:
substituteFontForFont (_:) - substituteFontForFont:

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

Объявление

Swift

func substituteFontForFont(_ originalFont: NSFont) -> NSFont

Objective C

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

Параметры

originalFont

Шрифт для замены.

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

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– usesScreenFonts

Обработка линеек


    
    rulerAccessoryViewForTextView (_: paragraphStyle:ruler:enabled:)
    - rulerAccessoryViewForTextView:paragraphStyle:ruler:enabled:

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

Объявление

Swift

func rulerAccessoryViewForTextView(_ view: NSTextView?, paragraphStyle style: NSParagraphStyle, ruler ruler: NSRulerView, enabled isEnabled: Bool) -> NSView?

Objective C

- (NSView *)rulerAccessoryViewForTextView:(NSTextView *)view paragraphStyle:(NSParagraphStyle *)style ruler:(NSRulerView *)ruler enabled:(BOOL)isEnabled

Параметры

`view`	Текстовое представление с помощью менеджера по расположению.
`style`	Устанавливает состояние средств управления во вспомогательном представление; не должен быть `nil`.
`ruler`	Представление линейки, представление аксессуара которого возвращается.
`isEnabled`	Если `YEStrue`, вспомогательные просматривают, включен и принимает события от нажатия мыши и события клавиатуры; если `NOfalse` это отключено.

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

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

Обсуждение

Если Вы выключили автоматическое обновление линейки с помощью setUsesRuler: так, чтобы можно было сделать более сложные вещи, но Вы все еще хотите вывести на экран надлежащее вспомогательное представление, можно использовать этот метод.

Этот метод вызывается автоматически NSTextView объект с помощью менеджера по расположению. Необходимо редко должны быть вызвать его, но можно переопределить его для настройки поддержки линейки. При использовании этого метода непосредственно обратите внимание на то, что он не устанавливает представление аксессуара линейки и не устанавливает маркеры для NSRulerView объект. Необходимо установить вспомогательное представление на линейку с помощью NSRulerView метод setAccessoryView:. Для установки маркеров использовать rulerMarkersForTextView:paragraphStyle:ruler: нуждаться в маркерах, и затем отправить setMarkers: к линейке.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

horizontalRulerView (NSScrollView)


    
    rulerMarkersForTextView (_: paragraphStyle:ruler:)
    - rulerMarkersForTextView:paragraphStyle:ruler:

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

Объявление

Swift

func rulerMarkersForTextView(_ view: NSTextView?, paragraphStyle style: NSParagraphStyle, ruler ruler: NSRulerView) -> [AnyObject]

Objective C

- (NSArray *)rulerMarkersForTextView:(NSTextView *)view paragraphStyle:(NSParagraphStyle *)style ruler:(NSRulerView *)ruler

Параметры

`view`	Текстовое представление с помощью менеджера по расположению.
`style`	Устанавливает состояние средств управления во вспомогательном представление; не должен быть `nil`.
`ruler`	Представление линейки, маркеры линейки которого возвращаются.

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

Массив NSRulerMarker объекты, представляющие такие вещи как левые и правые поля, отступ первой строки и позиции табуляции.

Обсуждение

Если Вы выключили автоматическое обновление линейки с помощью setUsesRuler: так, чтобы можно было сделать более сложные вещи, но Вы все еще хотите вывести на экран надлежащее вспомогательное представление, можно использовать этот метод.

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

Можно установить возвращенные маркеры линейки с NSRulerView метод setMarkers:.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– rulerAccessoryViewForTextView:paragraphStyle:ruler:enabled:

Управление цепочкой респондента

layoutManagerOwnsFirstResponderInWindow (_:) - layoutManagerOwnsFirstResponderInWindow:

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

Объявление

Swift

func layoutManagerOwnsFirstResponderInWindow(_ window: NSWindow) -> Bool

Objective C

- (BOOL)layoutManagerOwnsFirstResponderInWindow:(NSWindow *)window

Параметры

window

Окно, первый респондент которого тестируется.

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

YEStrue если первый респондент в window текстовое представление, связанное с получателем; иначе, NOfalse.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

unowned(unsafe) var firstTextView: NSTextView? { get }

Objective C

@property(readonly, assign) NSTextView *firstTextView

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

Первое текстовое представление получателя.

Обсуждение

Это NSTextView объект является получателем различных NSText и NSTextView уведомления.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

unowned(unsafe) var textViewForBeginningOfSelection: NSTextView? { get }

Objective C

@property(readonly, assign) NSTextView *textViewForBeginningOfSelection

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

Текстовое представление, содержащее первый глиф в выборе, или nil если нет никакого выбора или нет достаточного количества информации макета для определения текстового представления.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Рисование


    
    drawBackgroundForGlyphRange (_: atPoint:)
    - drawBackgroundForGlyphRange:atPoint:

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

Объявление

Swift

func drawBackgroundForGlyphRange(_ glyphsToShow: NSRange, atPoint origin: NSPoint)

Objective C

- (void)drawBackgroundForGlyphRange:(NSRange)glyphsToShow atPoint:(NSPoint)origin

Параметры

`glyphsToShow`	Диапазон глифов, для которых нарисован фон.
`origin`	Позиция текстового контейнера в системе координат в настоящее время фокусируемого представления.

Обсуждение

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

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– drawGlyphsForGlyphRange:atPoint:
– glyphRangeForTextContainer:
– fillBackgroundRectArray:count:forCharacterRange:color:
textContainerOrigin (NSTextView)


    
    drawGlyphsForGlyphRange (_: atPoint:)
    - drawGlyphsForGlyphRange:atPoint:

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

Объявление

Swift

func drawGlyphsForGlyphRange(_ glyphsToShow: NSRange, atPoint origin: NSPoint)

Objective C

- (void)drawGlyphsForGlyphRange:(NSRange)glyphsToShow atPoint:(NSPoint)origin

Параметры

`glyphsToShow`	Диапазон нарисованных глифов.
`origin`	Позиция текстового контейнера в системе координат в настоящее время фокусируемого представления.

Обсуждение

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

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– drawBackgroundForGlyphRange:atPoint:
– glyphRangeForTextContainer:
textContainerOrigin (NSTextView)


    
    drawUnderlineForGlyphRange (_: underlineType:baselineOffset:lineFragmentRect:lineFragmentGlyphRange:containerOrigin:)
    - drawUnderlineForGlyphRange:underlineType:baselineOffset:lineFragmentRect:lineFragmentGlyphRange:containerOrigin:

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

Объявление

Swift

func drawUnderlineForGlyphRange(_ glyphRange: NSRange, underlineType underlineVal: Int, baselineOffset baselineOffset: CGFloat, lineFragmentRect lineRect: NSRect, lineFragmentGlyphRange lineGlyphRange: NSRange, containerOrigin containerOrigin: NSPoint)

Objective C

- (void)drawUnderlineForGlyphRange:(NSRange)glyphRange underlineType:(NSInteger)underlineVal baselineOffset:(CGFloat)baselineOffset lineFragmentRect:(NSRect)lineRect lineFragmentGlyphRange:(NSRange)lineGlyphRange containerOrigin:(NSPoint)containerOrigin

Параметры

`glyphRange`	Диапазон глифов, которые должны принадлежать однострочному прямоугольнику фрагмента (как возвращено `lineFragmentRectForGlyphAtIndex:effectiveRange:`).
`underlineVal`	Стиль подчеркивания для рисования. Это значение является маской, полученной из значения для `NSUnderlineStyleAttributeName`— например, `(NSUnderlinePatternDash \| NSUnderlineStyleThick)`. Подклассы могут определить пользовательские стили подчеркивания.
`baselineOffset`	Указывает расстояние от нижней части ограничительной рамки указанных глифов в указанном диапазоне к их базовой линии.
`lineRect`	Прямоугольник фрагмента строки, содержащий глифы для рисования подчеркивание для.
`lineGlyphRange`	Диапазон всех глифов в `lineRect`.
`containerOrigin`	Источник `lineRectNSTextContainer` в `NSTextView`.

Обсуждение

Этот метод вызывается автоматически underlineGlyphRange:underlineType:lineFragmentRect:lineFragmentGlyphRange:containerOrigin:; необходимо редко должны быть вызвать его непосредственно. Этот метод underlineVal параметр не принимает во внимание установку дляNSUnderlineByWordMask потому что это заботилось о underlineGlyphRange:underlineType:lineFragmentRect:lineFragmentGlyphRange:containerOrigin:.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– textContainerForGlyphAtIndex:effectiveRange:
textContainerOrigin (NSTextView)


    
    underlineGlyphRange (_: underlineType:lineFragmentRect:lineFragmentGlyphRange:containerOrigin:)
    - underlineGlyphRange:underlineType:lineFragmentRect:lineFragmentGlyphRange:containerOrigin:

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

Объявление

Swift

func underlineGlyphRange(_ glyphRange: NSRange, underlineType underlineVal: Int, lineFragmentRect lineRect: NSRect, lineFragmentGlyphRange lineGlyphRange: NSRange, containerOrigin containerOrigin: NSPoint)

Objective C

- (void)underlineGlyphRange:(NSRange)glyphRange underlineType:(NSInteger)underlineVal lineFragmentRect:(NSRect)lineRect lineFragmentGlyphRange:(NSRange)lineGlyphRange containerOrigin:(NSPoint)containerOrigin

Параметры

`glyphRange`	Диапазон глифов, которые должны принадлежать однострочному прямоугольнику фрагмента (как возвращено `lineFragmentRectForGlyphAtIndex:effectiveRange:`).
`underlineVal`	Стиль подчеркивания для рисования. Это значение является маской, полученной из значения для `NSUnderlineStyleAttributeName`— например, `(NSUnderlinePatternDash \| NSUnderlineStyleThick \| NSUnderlineByWordMask)`. Подклассы могут определить пользовательские стили подчеркивания.
`lineRect`	Прямоугольник фрагмента строки, содержащий глифы для рисования подчеркивание для.
`lineGlyphRange`	Диапазон всех глифов в том прямоугольнике фрагмента строки.
`containerOrigin`	Источник прямоугольника фрагмента строки `NSTextContainer` в `NSTextView`.

Обсуждение

Этот метод определяет, на основе которого фактически должны быть подчеркнуты глифы underlineVal. С NSUnderlineStyleSingle, например, ведя и запаздывая пробел не подчеркивается, но пробел между видимыми глифами. Потенциальный стиль подчеркивания слова опустил бы подчеркивать на любом пробеле. После определения, какие глифы натянуть подчеркивание, этот метод вызывает drawUnderlineForGlyphRange:underlineType:baselineOffset:lineFragmentRect:lineFragmentGlyphRange:containerOrigin: для каждого непрерывного диапазона глифов, требующего его.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– textContainerForGlyphAtIndex:effectiveRange:
textContainerOrigin (NSTextView)


    
    showCGGlyphs (_: positions:count:font:matrix:attributes:inContext:)
    - showCGGlyphs:positions:count:font:matrix:attributes:inContext:

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

Объявление

Swift

func showCGGlyphs(_ glyphs: UnsafePointer<CGGlyph>, positions positions: UnsafePointer<NSPoint>, count glyphCount: Int, font font: NSFont, matrix textMatrix: NSAffineTransform?, attributes attributes: [NSObject : AnyObject]?, inContext graphicsContext: NSGraphicsContext?)

Objective C

- (void)showCGGlyphs:(const CGGlyph *)glyphs positions:(const NSPoint *)positions count:(NSUInteger)glyphCount font:(NSFont *)font matrix:(NSAffineTransform *)textMatrix attributes:(NSDictionary *)attributes inContext:(NSGraphicsContext *)graphicsContext

Параметры

`glyphs`	Глифы для рисования; может содержать встроенный `NULL` байты.
`positions`	Позиции, в которых можно нарисовать глифы. В системе координат пространства пользователя.
`glyphCount`	Число глифов.
`font`	Шрифт применился к состоянию графики. Это значение может отличаться от `NSFontAttributeName` значение в `attributes` параметр из-за различных замен шрифтов, что автоматически выполняется система.
`textMatrix`	Аффинное преобразование, отображающее систему координат текстового пространства на систему координат пространства пользователя. `tx` и `ty` компоненты `textMatrix` проигнорированы, так как Кварц переопределяет их с позициями глифа.
`attributes`	Словарь атрибутов глифа. Посмотрите Атрибуты Глифа для поддерживаемых ключей и значений.
`graphicsContext`	Если не -`nil`, `graphicsContext` уже сконфигурирован согласно текстовым параметрам атрибутов: `font`, `textMatrix`, и `attributes`.

Обсуждение

NSLayoutManager вызывает этот примитивный метод если реализация переопределения осуждаемого showPackedGlyphs:length:glyphRange:atPoint:font:color:printingAdjustment: метод существует, и этот метод не переопределяется.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    showPackedGlyphs:length:glyphRange:atPoint:font:color:printingAdjustment:
    - showPackedGlyphs:length:glyphRange:atPoint:font:color:printingAdjustment:

(OS X v10.7)

Рисует диапазон глифов.

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

Необходимо вместо этого использовать showCGGlyphs:positions:count:font:matrix:attributes:inContext:.

Объявление

Objective C

- (void)showPackedGlyphs:(char *)glyphs length:(NSUInteger)glyphLen glyphRange:(NSRange)glyphRange atPoint:(NSPoint)point font:(NSFont *)font color:(NSColor *)color printingAdjustment:(NSSize)printingAdjustment

Параметры

`glyphs`	Глифы для рисования; может содержать встроенный `NULL` байты.
`glyphLen`	Число байтов, которыми указывают `glyphs`; это - дважды число содержавших глифов.
`glyphRange`	Диапазон глифов для рисования.
`point`	Точка, в которой можно нарисовать глифы.
`font`	Шрифт глифов для рисования.
`color`	Цвет глифов для рисования.
`printingAdjustment`	`NSZeroSize` при рисовании на экран, но когда печать может содержать значения, которыми должен быть скорректирован номинальный интервал между символами.

Обсуждение

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

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

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

Objective C

@import AppKit;

Доступность

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

Осуждаемый в OS X v10.7.

См. также

– showCGGlyphs:positions:count:font:matrix:attributes:inContext:


    
    drawStrikethroughForGlyphRange (_: strikethroughType:baselineOffset:lineFragmentRect:lineFragmentGlyphRange:containerOrigin:)
    - drawStrikethroughForGlyphRange:strikethroughType:baselineOffset:lineFragmentRect:lineFragmentGlyphRange:containerOrigin:

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

Объявление

Swift

func drawStrikethroughForGlyphRange(_ glyphRange: NSRange, strikethroughType strikethroughVal: Int, baselineOffset baselineOffset: CGFloat, lineFragmentRect lineRect: NSRect, lineFragmentGlyphRange lineGlyphRange: NSRange, containerOrigin containerOrigin: NSPoint)

Objective C

- (void)drawStrikethroughForGlyphRange:(NSRange)glyphRange strikethroughType:(NSInteger)strikethroughVal baselineOffset:(CGFloat)baselineOffset lineFragmentRect:(NSRect)lineRect lineFragmentGlyphRange:(NSRange)lineGlyphRange containerOrigin:(NSPoint)containerOrigin

Параметры

`glyphRange`	Диапазон глифов, для которых можно нарисовать перечеркивание. Диапазон должен принадлежать однострочному прямоугольнику фрагмента (как возвращено `lineFragmentRectForGlyphAtIndex:effectiveRange:`).
`strikethroughVal`	Стиль перечеркивания для рисования. Это значение является маской, полученной из значения для `NSUnderlineStyleAttributeName`— например, `(NSUnderlinePatternDash \| NSUnderlineStyleThick)`. Подклассы могут определить пользовательские перечеркнутые стили.
`baselineOffset`	Указывает, как далеко выше текстовой базовой линии должно быть нарисовано подчеркивание.
`lineRect`	Прямоугольник фрагмента строки, содержащий глифы для рисования перечеркивание для.
`lineGlyphRange`	Диапазон всех глифов в `lineRect`.
`containerOrigin`	Источник прямоугольника фрагмента строки `NSTextContainer` в `NSTextView`.

Обсуждение

Этот метод вызывается автоматически strikethroughGlyphRange:strikethroughType:lineFragmentRect:lineFragmentGlyphRange:containerOrigin:; необходимо редко должны быть вызвать его непосредственно. Этот метод strikethroughVal параметр не принимает во внимание установку дляNSUnderlineByWordMask потому что это заботилось о underlineGlyphRange:underlineType:lineFragmentRect:lineFragmentGlyphRange:containerOrigin:.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    strikethroughGlyphRange (_: strikethroughType:lineFragmentRect:lineFragmentGlyphRange:containerOrigin:)
    - strikethroughGlyphRange:strikethroughType:lineFragmentRect:lineFragmentGlyphRange:containerOrigin:

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

Объявление

Swift

func strikethroughGlyphRange(_ glyphRange: NSRange, strikethroughType strikethroughVal: Int, lineFragmentRect lineRect: NSRect, lineFragmentGlyphRange lineGlyphRange: NSRange, containerOrigin containerOrigin: NSPoint)

Objective C

- (void)strikethroughGlyphRange:(NSRange)glyphRange strikethroughType:(NSInteger)strikethroughVal lineFragmentRect:(NSRect)lineRect lineFragmentGlyphRange:(NSRange)lineGlyphRange containerOrigin:(NSPoint)containerOrigin

Параметры

`glyphRange`	Диапазон глифов, для которых можно нарисовать перечеркивание. Диапазон должен принадлежать однострочному прямоугольнику фрагмента (как возвращено `lineFragmentRectForGlyphAtIndex:effectiveRange:`).
`strikethroughVal`	Стиль подчеркивания для рисования. Это значение является маской, полученной из значения для `NSUnderlineStyleAttributeName`— например, `(NSUnderlinePatternDash \| NSUnderlineStyleThick \| NSUnderlineByWordMask)`. Подклассы могут определить пользовательские стили подчеркивания.
`lineRect`	Прямоугольник фрагмента строки, содержащий глифы для рисования перечеркивание для.
`lineGlyphRange`	Диапазон всех глифов в `lineRect`.
`containerOrigin`	Источник прямоугольника фрагмента строки `NSTextContainer` в `NSTextView`.

Обсуждение

Этот метод определяет, на основе которого глифам фактически нужно было нарисовать перечеркивание strikethroughVal. После определения, какие глифы натянуть перечеркивание, этот метод вызывает drawStrikethroughForGlyphRange:strikethroughType:baselineOffset:lineFragmentRect:lineFragmentGlyphRange:containerOrigin: для каждого непрерывного диапазона глифов, требующего его.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    fillBackgroundRectArray (_: count:forCharacterRange:color:)
    - fillBackgroundRectArray:count:forCharacterRange:color:

Фоновые прямоугольники заливок с цветом.

Объявление

Swift

func fillBackgroundRectArray(_ rectArray: NSRectArray, count rectCount: Int, forCharacterRange charRange: NSRange, color color: NSColor)

Objective C

- (void)fillBackgroundRectArray:(NSRectArray)rectArray count:(NSUInteger)rectCount forCharacterRange:(NSRange)charRange color:(NSColor *)color

Параметры

`rectArray`	Массив прямоугольников для заполнения.
`rectCount`	Число прямоугольников в `rectArray`.
`charRange`	Диапазон символов, фоновые прямоугольники которых заполнены.
`color`	Цвет заливки.

Обсуждение

Это - примитивный метод, используемый drawBackgroundForGlyphRange:atPoint:, обеспечение переопределения с более прекрасными зернами указывает для того, чтобы фактически заполнить прямоугольники определенным цветом фона для атрибута цвета фона, выбранного или отмеченного выделения диапазона, блочного художественного оформления или любой другой прямоугольной заливки, необходимой тому методу. Как с showPackedGlyphs:length:glyphRange:atPoint:font:color:printingAdjustment:, charRange и color параметры передаются в просто для информационных целей; цвет уже выбран в состоянии графики. По какой-либо причине при изменении его необходимо восстановить его прежде, чем возвратиться из этого метода.

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

Вы никогда не должны вызывать этот метод, но Вы могли бы переопределить его. Реализация по умолчанию просто заполняет прямоугольники в указанном массиве. Графической работой, используемой для этой заливки, управляет проверка ссылки; по причинам совместимости это NSCompositeCopy для приложений, соединенных до OS X v10.6 и NSCompositeSourceOver для приложений, соединенных на OS X v10.6 или позже. Приложения могут управлять работой, используемой, или изменить получение путем переопределения этого метода в NSLayoutManager подкласс.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– drawBackgroundForGlyphRange:atPoint:

Доступ к делегату


    
    setDelegate:
    - setDelegate:

Устанавливает делегата получателя.

Объявление

Swift

unowned(unsafe) var delegate: NSLayoutManagerDelegate?

Objective C

@property(assign) id<NSLayoutManagerDelegate> delegate

Параметры


      anObject

Делегат к получателю. Это должно соответствовать NSLayoutManagerDelegate Protocol протокол.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– делегат

делегат - делегат

Возвращает делегата получателя.

Объявление

Swift

unowned(unsafe) var delegate: NSLayoutManagerDelegate?

Objective C

@property(assign) id<NSLayoutManagerDelegate> delegate

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

Делегат получателя. Это должно соответствовать NSLayoutManagerDelegate Protocol протокол.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setDelegate:

Доступ к наборному устройству

setTypesetter: - setTypesetter:

Устанавливает текущее наборное устройство.

Объявление

Swift

var typesetter: NSTypesetter!

Objective C

@property(strong) NSTypesetter *typesetter

Параметры

typesetter

Наборное устройство для получателя.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– наборное устройство
наборное устройство - наборное устройство

Возвращает наборное устройство получателя.

Объявление

Swift

var typesetter: NSTypesetter!

Objective C

@property(strong) NSTypesetter *typesetter

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

Наборное устройство получателя.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setTypesetter:

Управление совместимостью наборного устройства


    
    setTypesetterBehavior:
    - setTypesetterBehavior:

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

Объявление

Swift

var typesetterBehavior: NSTypesetterBehavior

Objective C

@property NSTypesetterBehavior typesetterBehavior

Параметры


      theBehavior

NSTypesetterBehavior постоянный, который указывает поведение для получателя.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– typesetterBehavior

typesetterBehavior - typesetterBehavior

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

Объявление

Swift

var typesetterBehavior: NSTypesetterBehavior

Objective C

@property NSTypesetterBehavior typesetterBehavior

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setTypesetterBehavior:
defaultLineHeightForFont (_:) - defaultLineHeightForFont:

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

Объявление

Swift

func defaultLineHeightForFont(_ theFont: NSFont) -> CGFloat

Objective C

- (CGFloat)defaultLineHeightForFont:(NSFont *)theFont

Параметры

theFont

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

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

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setTypesetterBehavior:
– defaultBaselineOffsetForFont:
defaultBaselineOffsetForFont (_:) - defaultBaselineOffsetForFont:

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

Объявление

Swift

func defaultBaselineOffsetForFont(_ theFont: NSFont) -> CGFloat

Objective C

- (CGFloat)defaultBaselineOffsetForFont:(NSFont *)theFont

Параметры

theFont

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

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

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setTypesetterBehavior:
– defaultLineHeightForFont:

Управление временной поддержкой атрибута


    
    addTemporaryAttributes (_: forCharacterRange:)
    - addTemporaryAttributes:forCharacterRange:

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

Объявление

Swift

func addTemporaryAttributes(_ attrs: [NSObject : AnyObject], forCharacterRange charRange: NSRange)

Objective C

- (void)addTemporaryAttributes:(NSDictionary *)attrs forCharacterRange:(NSRange)charRange

Параметры

`attrs`	Словарь атрибутов, содержащий временные атрибуты для добавления.
`charRange`	Диапазон символов, к которым применяются указанные атрибуты.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setTemporaryAttributes:forCharacterRange:
– removeTemporaryAttribute:forCharacterRange:
– temporaryAttributesAtCharacterIndex:effectiveRange:


    
    addTemporaryAttribute (_: value:forCharacterRange:)
    - addTemporaryAttribute:value:forCharacterRange:

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

Объявление

Swift

func addTemporaryAttribute(_ attrName: String, value value: AnyObject, forCharacterRange charRange: NSRange)

Objective C

- (void)addTemporaryAttribute:(NSString *)attrName value:(id)value forCharacterRange:(NSRange)charRange

Параметры

`attrName`	Имя временного атрибута.
`value`	Временное значение атрибута связалось с `attrName`.
`charRange`	Диапазон символов, к которым применяется указанная пара значения атрибута.

Обсуждение

Повышения NSInvalidArgumentException если attrName или value nil.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– addTemporaryAttributes:forCharacterRange:
– setTemporaryAttributes:forCharacterRange:
– removeTemporaryAttribute:forCharacterRange:
– temporaryAttributesAtCharacterIndex:effectiveRange:


    
    setTemporaryAttributes (_: forCharacterRange:)
    - setTemporaryAttributes:forCharacterRange:

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

Объявление

Swift

func setTemporaryAttributes(_ attrs: [NSObject : AnyObject]?, forCharacterRange charRange: NSRange)

Objective C

- (void)setTemporaryAttributes:(NSDictionary *)attrs forCharacterRange:(NSRange)charRange

Параметры

`attrs`	Словарь атрибутов, содержащий временные атрибуты для установки.
`charRange`	Диапазон символов, к которым применяются указанные атрибуты.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– addTemporaryAttributes:forCharacterRange:
– removeTemporaryAttribute:forCharacterRange:
– temporaryAttributesAtCharacterIndex:effectiveRange:


    
    removeTemporaryAttribute (_: forCharacterRange:)
    - removeTemporaryAttribute:forCharacterRange:

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

Объявление

Swift

func removeTemporaryAttribute(_ attrName: String, forCharacterRange charRange: NSRange)

Objective C

- (void)removeTemporaryAttribute:(NSString *)attrName forCharacterRange:(NSRange)charRange

Параметры

`attrName`	Имя временного атрибута.
`charRange`	Диапазон символов, из которых можно удалить указанный временный атрибут.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setTemporaryAttributes:forCharacterRange:
– addTemporaryAttributes:forCharacterRange:
– temporaryAttributesAtCharacterIndex:effectiveRange:


    
    temporaryAttribute (_: atCharacterIndex:effectiveRange:)
    - temporaryAttribute:atCharacterIndex:effectiveRange:

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

Объявление

Swift

func temporaryAttribute(_ attrName: String, atCharacterIndex location: Int, effectiveRange range: NSRangePointer) -> AnyObject?

Objective C

- (id)temporaryAttribute:(NSString *)attrName atCharacterIndex:(NSUInteger)location effectiveRange:(NSRangePointer)range

Параметры

`attrName`	Имя временного атрибута.
`location`	Индекс, для которого можно возвратить атрибуты. Это значение не должно превышать границы получателя.
`range`	Если не -`NULL`: Если именованный атрибут существует в `location`, на выводе, содержит диапазон, по которому применяется значение именованного атрибута. Если именованный атрибут не существует в `location`, на выводе, содержит диапазон, по которому не существует атрибут. Диапазон является не обязательно максимальным диапазоном, покрытым `attrName`, и его степень является зависящей от реализации. При необходимости в максимальном диапазоне использовать `temporaryAttribute:atCharacterIndex:longestEffectiveRange:inRange:`. Если Вам не нужно это значение, передача `NULL`.

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

Значение для временного атрибута называют attrName из символа в индексе location, или nil если нет такого атрибута.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– temporaryAttributesAtCharacterIndex:effectiveRange:
– temporaryAttribute:atCharacterIndex:longestEffectiveRange:inRange:


    
    temporaryAttribute (_: atCharacterIndex:longestEffectiveRange:inRange:)
    - temporaryAttribute:atCharacterIndex:longestEffectiveRange:inRange:

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

Объявление

Swift

func temporaryAttribute(_ attrName: String, atCharacterIndex location: Int, longestEffectiveRange range: NSRangePointer, inRange rangeLimit: NSRange) -> AnyObject?

Objective C

- (id)temporaryAttribute:(NSString *)attrName atCharacterIndex:(NSUInteger)location longestEffectiveRange:(NSRangePointer)range inRange:(NSRange)rangeLimit

Параметры

`attrName`	Имя временного атрибута.
`location`	Индекс, для которого можно возвратить атрибуты. Это значение не должно превышать границы получателя.
`range`	Если не -`NULL`: Если именованный атрибут существует в `location`, на выводе, содержит максимум, передвигаются, по которому значение именованного атрибута применяется, отсеченный к `rangeLimit`. Если именованный атрибут не существует в `location`, на выводе, содержит максимум, передвигаются, по которому не существует атрибут. Если Вам не нужно это значение, передача `NULL`.
`rangeLimit`	Диапазон, по которому можно искать непрерывное присутствие `attrName`. Это значение не должно превышать границы получателя.

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

Значение для атрибута называют attrName из символа в location, или nil если нет такого атрибута.

Обсуждение

Если Вам не нужен самый длинный диапазон измерений, намного более эффективно использовать temporaryAttribute:atCharacterIndex:effectiveRange: метод для получения значения атрибута.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– temporaryAttributesAtCharacterIndex:effectiveRange:
– temporaryAttribute:atCharacterIndex:effectiveRange:

temporaryAttributesAtCharacterIndex (_: effectiveRange:) - temporaryAttributesAtCharacterIndex:effectiveRange:

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

Объявление

Swift

func temporaryAttributesAtCharacterIndex(_ charIndex: Int, effectiveRange effectiveCharRange: NSRangePointer) -> [NSObject : AnyObject]

Objective C

- (NSDictionary *)temporaryAttributesAtCharacterIndex:(NSUInteger)charIndex effectiveRange:(NSRangePointer)effectiveCharRange

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

Словарь временных атрибутов для диапазона символов, указанного в effectiveCharRange в индексе символа charIndex.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– addTemporaryAttributes:forCharacterRange:
– removeTemporaryAttribute:forCharacterRange:
– setTemporaryAttributes:forCharacterRange:


    
    temporaryAttributesAtCharacterIndex (_: longestEffectiveRange:inRange:)
    - temporaryAttributesAtCharacterIndex:longestEffectiveRange:inRange:

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

Объявление

Swift

func temporaryAttributesAtCharacterIndex(_ location: Int, longestEffectiveRange range: NSRangePointer, inRange rangeLimit: NSRange) -> [NSObject : AnyObject]

Objective C

- (NSDictionary *)temporaryAttributesAtCharacterIndex:(NSUInteger)location longestEffectiveRange:(NSRangePointer)range inRange:(NSRange)rangeLimit

Параметры

`location`	Индекс, для которого можно возвратить атрибуты. Это значение не должно превышать границы получателя.
`range`	Если нет `NULL`, на выводе, содержит максимум, передвигаются, по которому атрибуты и значения совпадают с теми в `location`, отсеченный к `rangeLimit`.
`rangeLimit`	Диапазон, по которому можно искать непрерывное присутствие атрибутов в `location`. Это значение не должно превышать границы получателя.

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

Атрибуты для символа в location.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– temporaryAttributesAtCharacterIndex:effectiveRange:
– temporaryAttribute:atCharacterIndex:longestEffectiveRange:inRange:

Управление расположением состоящим из нескольких несмежных участков


    
    setAllowsNonContiguousLayout:
    - setAllowsNonContiguousLayout:

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

Объявление

Swift

var allowsNonContiguousLayout: Bool

Objective C

@property BOOL allowsNonContiguousLayout

Параметры


      flag

Если YEStrue, расположение состоящее из нескольких несмежных участков включено; если NOfalse, расположение состоящее из нескольких несмежных участков отключено.

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– allowsNonContiguousLayout
– hasNonContiguousLayout

allowsNonContiguousLayout - allowsNonContiguousLayout

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

Объявление

Swift

var allowsNonContiguousLayout: Bool

Objective C

@property BOOL allowsNonContiguousLayout

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

YEStrue если включено расположение состоящее из нескольких несмежных участков; иначе, NOfalse.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setAllowsNonContiguousLayout:
– hasNonContiguousLayout
hasNonContiguousLayout - hasNonContiguousLayout

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

Объявление

Swift

var hasNonContiguousLayout: Bool { get }

Objective C

@property(readonly) BOOL hasNonContiguousLayout

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

YEStrue если существует расположение состоящее из нескольких несмежных участков; иначе, NOfalse.

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– allowsNonContiguousLayout
– setAllowsNonContiguousLayout:
ensureGlyphsForCharacterRange (_:) - ensureGlyphsForCharacterRange:

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

Объявление

Swift

func ensureGlyphsForCharacterRange(_ charRange: NSRange)

Objective C

- (void)ensureGlyphsForCharacterRange:(NSRange)charRange

Параметры

charRange

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.
ensureGlyphsForGlyphRange (_:) - ensureGlyphsForGlyphRange:

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

Объявление

Swift

func ensureGlyphsForGlyphRange(_ glyphRange: NSRange)

Objective C

- (void)ensureGlyphsForGlyphRange:(NSRange)glyphRange

Параметры

glyphRange

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.
ensureLayoutForCharacterRange (_:) - ensureLayoutForCharacterRange:

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

Объявление

Swift

func ensureLayoutForCharacterRange(_ charRange: NSRange)

Objective C

- (void)ensureLayoutForCharacterRange:(NSRange)charRange

Параметры

charRange

Диапазон символов, для которого выполняется расположение.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.
ensureLayoutForGlyphRange (_:) - ensureLayoutForGlyphRange:

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

Объявление

Swift

func ensureLayoutForGlyphRange(_ glyphRange: NSRange)

Objective C

- (void)ensureLayoutForGlyphRange:(NSRange)glyphRange

Параметры

glyphRange

Диапазон глифа, для которого выполняется расположение.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.
ensureLayoutForTextContainer (_:) - ensureLayoutForTextContainer:

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

Объявление

Swift

func ensureLayoutForTextContainer(_ container: NSTextContainer)

Objective C

- (void)ensureLayoutForTextContainer:(NSTextContainer *)container

Параметры

container

Текстовый контейнер, для которого выполняется расположение.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    ensureLayoutForBoundingRect (_: inTextContainer:)
    - ensureLayoutForBoundingRect:inTextContainer:

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

Объявление

Swift

func ensureLayoutForBoundingRect(_ bounds: NSRect, inTextContainer container: NSTextContainer)

Objective C

- (void)ensureLayoutForBoundingRect:(NSRect)bounds inTextContainer:(NSTextContainer *)container

Параметры

`bounds`	Область, для которой выполняется расположение.
`container`	Текстовый контейнер, содержащий область, для которой выполняется расположение.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступ к продвижению шрифта

usesFontLeading - usesFontLeading

Указывает, использует ли получатель продвижение, предоставленное в шрифте.

Объявление

Swift

var usesFontLeading: Bool

Objective C

@property BOOL usesFontLeading

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

YEStrue если получатель использует ведущий шрифт; иначе, NOfalse.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setUsesFontLeading:


    
    setUsesFontLeading:
    - setUsesFontLeading:

Указывает, использует ли получатель продвижение, предоставленное в шрифте.

Объявление

Swift

var usesFontLeading: Bool

Objective C

@property BOOL usesFontLeading

Параметры


      flag

Если YEStrue, получатель использует ведущий шрифт; если NOfalse, это не делает.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– usesFontLeading
setLineSpacing: (NSMutableParagraphStyle)

`glyphIndex`	Индекс глифа для замены.
`newGlyph`	Новый глиф.

NSLayoutManager

Текстовое сглаживание

Потокобезопасность NSLayoutManager

Расположение состоящее из нескольких несмежных участков

Инициализация

Объявление

Обсуждение

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

Доступность

См. также

Установка текстового хранения

Объявление

Параметры

Обсуждение

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

Доступность

См. также

Объявление

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

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

Доступность

См. также

Объявление

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

Обсуждение

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

Доступность

Объявление

Параметры

Обсуждение

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

Доступность

Установка текстовых контейнеров

Объявление

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

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

Доступность

См. также

Объявление

Параметры

Обсуждение

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

Доступность

См. также

Объявление

Параметры

Обсуждение

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

Доступность

См. также

Объявление

Параметры

Обсуждение

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

Доступность

См. также

Установка генератора глифа

Объявление

Параметры

Обсуждение

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

Доступность

См. также

Объявление

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

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

Доступность

См. также

Лишение законной силы глифов и расположения

Объявление

Параметры

Обсуждение

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

Доступность

Объявление

Параметры

Обсуждение

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

Доступность

Объявление