Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка платформы AppKit ссылка класса NSTextBlock

Опции
Развертывание Target:

На этой странице
Язык:

NSTextBlock

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

Самый важный подкласс NSTextTableBlock, который представляет блок текста, появляющегося как ячейка в таблице. Сама таблица представлена отдельным классом, NSTextTable, на который ссылается весь NSTextTableBlock объекты и который управляет их калибровкой и расположением.

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

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Создание текстовых блоков
  • init () - init

    Инициализирует и возвращает пустой объект текстового блока.

    Объявление

    Swift

    init()

    Objective C

    - (instancetype)init

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

    Инициализированный объект текстового блока.

    Обсуждение

    Это - определяемый инициализатор для NSTextBlock.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Работа с размерностями содержания
  • setValue (_: type:forDimension:) - setValue:type:forDimension:

    Устанавливает размерность текстового блока.

    Объявление

    Swift

    func setValue(_ val: CGFloat, type type: NSTextBlockValueType, forDimension dimension: NSTextBlockDimension)

    Objective C

    - (void)setValue:(CGFloat)val type:(NSTextBlockValueType)type forDimension:(NSTextBlockDimension)dimension

    Параметры

    val

    Новое значение для размерности.

    type

    Тип предоставленного значения. Это управляет как val интерпретируется.

    dimension

    Размерность для установки.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – valueForDimension:
    – valueTypeForDimension:

  • valueForDimension (_:) - valueForDimension:

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

    Объявление

    Swift

    func valueForDimension(_ dimension: NSTextBlockDimension) -> CGFloat

    Objective C

    - (CGFloat)valueForDimension:(NSTextBlockDimension)dimension

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setValue:type:forDimension:
    valueTypeForDimension:

  • valueTypeForDimension (_:) - valueTypeForDimension:

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

    Объявление

    Swift

    func valueTypeForDimension(_ dimension: NSTextBlockDimension) -> NSTextBlockValueType

    Objective C

    - (NSTextBlockValueType)valueTypeForDimension:(NSTextBlockDimension)dimension

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setValue:type:forDimension:
    valueForDimension:

  • setContentWidth (_: введите:) - setContentWidth:type:

    Устанавливает ширину текстового блока.

    Объявление

    Swift

    func setContentWidth(_ val: CGFloat, type type: NSTextBlockValueType)

    Objective C

    - (void)setContentWidth:(CGFloat)val type:(NSTextBlockValueType)type

    Параметры

    val

    Новое значение для ширины.

    type

    Тип предоставленного значения. Это управляет как val интерпретируется.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – contentWidth
    – contentWidthValueType

  • contentWidth - contentWidth

    Возвращает ширину текстового блока.

    Объявление

    Swift

    var contentWidth: CGFloat { get }

    Objective C

    @property(readonly) CGFloat contentWidth

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

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

    Обсуждение

    Это - вызывающий удобный метод valueForDimension:NSTextBlockWidth.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setContentWidth:type:
    – contentWidthValueType

  • contentWidthValueType - contentWidthValueType

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

    Объявление

    Swift

    var contentWidthValueType: NSTextBlockValueType { get }

    Objective C

    @property(readonly) NSTextBlockValueType contentWidthValueType

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setContentWidth:type:
    – contentWidth

Получение и установка полей, границ и дополнения
  • setWidth (_: type:forLayer:edge:) - setWidth:type:forLayer:edge:

    Устанавливает ширину указанного края указанного уровня текстового блока.

    Объявление

    Swift

    func setWidth(_ val: CGFloat, type type: NSTextBlockValueType, forLayer layer: NSTextBlockLayer, edge edge: NSRectEdge)

    Objective C

    - (void)setWidth:(CGFloat)val type:(NSTextBlockValueType)type forLayer:(NSTextBlockLayer)layer edge:(NSRectEdge)edge

    Параметры

    val

    Новое значение для указанной граничной ширины.

    type

    Тип предоставленного значения. Это управляет как val интерпретируется.

    layer

    Уровень текстового блока для изменения.

    edge

    Край уровня для изменения.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setWidth:type:forLayer:
    – widthForLayer:edge:

  • setWidth (_: type:forLayer:) - setWidth:type:forLayer:

    Устанавливает ширину всех краев указанного уровня текстового блока.

    Объявление

    Swift

    func setWidth(_ val: CGFloat, type type: NSTextBlockValueType, forLayer layer: NSTextBlockLayer)

    Objective C

    - (void)setWidth:(CGFloat)val type:(NSTextBlockValueType)type forLayer:(NSTextBlockLayer)layer

    Параметры

    val

    Новое значение для указанной граничной ширины.

    type

    Тип предоставленного значения. Это управляет как val интерпретируется.

    layer

    Уровень текстового блока для изменения.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – widthForLayer:edge:
    – setWidth:type:forLayer:edge:

  • widthForLayer (_: край:) - widthForLayer:edge:

    Возвращает ширину края указанного уровня текстового блока.

    Объявление

    Swift

    func widthForLayer(_ layer: NSTextBlockLayer, edge edge: NSRectEdge) -> CGFloat

    Objective C

    - (CGFloat)widthForLayer:(NSTextBlockLayer)layer edge:(NSRectEdge)edge

    Параметры

    layer

    Уровень для исследования.

    edge

    Край уровня для исследования.

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

    Ширина edge из layer. Это значение должно быть интерпретировано согласно типу значения, возвращенному widthValueTypeForLayer:edge:.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    widthValueTypeForLayer:edge:
    – setWidth:type:forLayer:edge:
    – setWidth:type:forLayer:

  • widthValueTypeForLayer (_: край:) - widthValueTypeForLayer:edge:

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

    Объявление

    Swift

    func widthValueTypeForLayer(_ layer: NSTextBlockLayer, edge edge: NSRectEdge) -> NSTextBlockValueType

    Objective C

    - (NSTextBlockValueType)widthValueTypeForLayer:(NSTextBlockLayer)layer edge:(NSRectEdge)edge

    Параметры

    layer

    Уровень для исследования.

    edge

    Край уровня для исследования.

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

    Тип значения edge из layer. Это определяет как значение для этого edge из layer должен быть интерпретирован.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    widthForLayer:edge:
    – setWidth:type:forLayer:edge:

Получение и установка выравнивания
  • setVerticalAlignment: - setVerticalAlignment:

    Устанавливает выравнивание по вертикали текстового блока.

    Объявление

    Swift

    var verticalAlignment: NSTextBlockVerticalAlignment

    Objective C

    @property NSTextBlockVerticalAlignment verticalAlignment

    Параметры

    alignment

    Новое выравнивание по вертикали для текстового блока.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – verticalAlignment

  • verticalAlignment - verticalAlignment

    Возвращает выравнивание по вертикали текстового блока.

    Объявление

    Swift

    var verticalAlignment: NSTextBlockVerticalAlignment

    Objective C

    @property NSTextBlockVerticalAlignment verticalAlignment

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

    Выравнивание по вертикали текстового блока.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setVerticalAlignment:

Работа с цветом
  • setBackgroundColor: - setBackgroundColor:

    Выбирает цвет фона текстового блока.

    Объявление

    Swift

    @NSCopying var backgroundColor: NSColor?

    Objective C

    @property(copy) NSColor *backgroundColor

    Параметры

    color

    Новый цвет фона.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – backgroundColor

  • backgroundColor - backgroundColor

    Возвращает цвет фона текстового блока.

    Объявление

    Swift

    @NSCopying var backgroundColor: NSColor?

    Objective C

    @property(copy) NSColor *backgroundColor

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

    Цвет фона текстового блока.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setBackgroundColor:

  • setBorderColor (_: forEdge:) - setBorderColor:forEdge:

    Устанавливает цвет рамки указанного края текстового блока.

    Объявление

    Swift

    func setBorderColor(_ color: NSColor?, forEdge edge: NSRectEdge)

    Objective C

    - (void)setBorderColor:(NSColor *)color forEdge:(NSRectEdge)edge

    Параметры

    color

    Новый цвет.

    edge

    Край, цвет которого должен быть выбран.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – borderColorForEdge:
    – setWidth:type:forLayer:

  • setBorderColor (_:) - setBorderColor:

    Выбирает цвет всех границ текстового блока.

    Объявление

    Swift

    func setBorderColor(_ color: NSColor?)

    Objective C

    - (void)setBorderColor:(NSColor *)color

    Параметры

    color

    Новый цвет.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – borderColorForEdge:
    – setBorderColor:forEdge:
    – setWidth:type:forLayer:

  • borderColorForEdge (_:) - borderColorForEdge:

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

    Объявление

    Swift

    func borderColorForEdge(_ edge: NSRectEdge) -> NSColor?

    Objective C

    - (NSColor *)borderColorForEdge:(NSRectEdge)edge

    Параметры

    edge

    Край рассматриваемого текстового блока.

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

    Цвет рамки края текстового блока edge.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setBorderColor:forEdge:

Определение размера и позиции текстового блока
  • rectForLayoutAtPoint (_: inRect:textContainer:characterRange:) - rectForLayoutAtPoint:inRect:textContainer:characterRange:

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

    Объявление

    Swift

    func rectForLayoutAtPoint(_ startingPoint: NSPoint, inRect rect: NSRect, textContainer textContainer: NSTextContainer, characterRange charRange: NSRange) -> NSRect

    Objective C

    - (NSRect)rectForLayoutAtPoint:(NSPoint)startingPoint inRect:(NSRect)rect textContainer:(NSTextContainer *)textContainer characterRange:(NSRange)charRange

    Параметры

    startingPoint

    Расположение, в контейнерных координатах, где начинается расположение.

    rect

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

    textContainer

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

    charRange

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

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

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

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – boundsRectForContentRect:inRect:textContainer:characterRange:

  • boundsRectForContentRect (_: inRect:textContainer:characterRange:) - boundsRectForContentRect:inRect:textContainer:characterRange:

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

    Объявление

    Swift

    func boundsRectForContentRect(_ contentRect: NSRect, inRect rect: NSRect, textContainer textContainer: NSTextContainer, characterRange charRange: NSRange) -> NSRect

    Objective C

    - (NSRect)boundsRectForContentRect:(NSRect)contentRect inRect:(NSRect)rect textContainer:(NSTextContainer *)textContainer characterRange:(NSRange)charRange

    Параметры

    contentRect

    Фактический прямоугольник, в котором текст был размечен, как определено rectForLayoutAtPoint:inRect:textContainer:characterRange:.

    rect

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

    textContainer

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

    charRange

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

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

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

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – rectForLayoutAtPoint:inRect:textContainer:characterRange:

Рисование цветов и художественных оформлений
  • drawBackgroundWithFrame (_: inView:characterRange:layoutManager:) - drawBackgroundWithFrame:inView:characterRange:layoutManager:

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

    Объявление

    Swift

    func drawBackgroundWithFrame(_ frameRect: NSRect, inView controlView: NSView, characterRange charRange: NSRange, layoutManager layoutManager: NSLayoutManager)

    Objective C

    - (void)drawBackgroundWithFrame:(NSRect)frameRect inView:(NSView *)controlView characterRange:(NSRange)charRange layoutManager:(NSLayoutManager *)layoutManager

    Параметры

    frameRect

    Прямоугольник границ в поле зрения координирует.

    controlView

    Представление, в котором происходит получение.

    charRange

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

    layoutManager

    Менеджер по расположению, управляющий набором.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Константы
  • Константы типа значения текстового блока

    Следующие константы указывают значения, используемые методами setValue:type:forDimension: и valueTypeForDimension:

    Объявление

    Swift

    enum NSTextBlockValueType : UInt { case AbsoluteValueType case PercentageValueType }

    Objective C

    enum { NSTextBlockAbsoluteValueType = 0, NSTextBlockPercentageValueType = 1 }; typedef NSUInteger NSTextBlockValueType;

    Константы

    • AbsoluteValueType

      NSTextBlockAbsoluteValueType

      Абсолютное значение в точках.

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

    • PercentageValueType

      NSTextBlockPercentageValueType

      Значение процента (из 100).

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

    • NSTextBlockValueType

      NSTextBlockValueType

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Константы размерности текстового блока

    Следующие константы указывают значения, используемые методами setValue:type:forDimension:, valueForDimension:, и valueTypeForDimension:.

    Объявление

    Swift

    enum NSTextBlockDimension : UInt { case Width case MinimumWidth case MaximumWidth case Height case MinimumHeight case MaximumHeight }

    Objective C

    enum { NSTextBlockWidth = 0, NSTextBlockMinimumWidth = 1, NSTextBlockMaximumWidth = 2, NSTextBlockHeight = 4, NSTextBlockMinimumHeight = 5, NSTextBlockMaximumHeight = 6 }; typedef NSUInteger NSTextBlockDimension;

    Константы

    • Width

      NSTextBlockWidth

      Ширина текстового блока.

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

    • MinimumWidth

      NSTextBlockMinimumWidth

      Минимальная ширина текстового блока.

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

    • MaximumWidth

      NSTextBlockMaximumWidth

      Максимальная ширина текстового блока.

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

    • Height

      NSTextBlockHeight

      Высота текстового блока.

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

    • MinimumHeight

      NSTextBlockMinimumHeight

      Минимальная высота текстового блока.

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

    • MaximumHeight

      NSTextBlockMaximumHeight

      Максимальная высота текстового блока.

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

    • NSTextBlockDimension

      NSTextBlockDimension

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Константы уровня текстового блока

    Следующие константы указывают значения, используемые методами setContentWidth:type:, contentWidthValueType, setWidth:type:forLayer:edge:, setWidth:type:forLayer:, widthForLayer:edge:, и widthValueTypeForLayer:edge:.

    Объявление

    Swift

    enum NSTextBlockLayer : Int { case Padding case Border case Margin }

    Objective C

    enum { NSTextBlockPadding = -1, NSTextBlockBorder = 0, NSTextBlockMargin = 1 }; typedef NSInteger NSTextBlockLayer;

    Константы

    • Padding

      NSTextBlockPadding

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

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

    • Border

      NSTextBlockBorder

      Граница текстового блока: пространство между дополнением и полем, обычно окрашенным для представления видимой границы.

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

    • Margin

      NSTextBlockMargin

      Поле текстового блока: пространство, окружающее границу.

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

    • NSTextBlockLayer

      NSTextBlockLayer

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Константы выравнивания по вертикали текстового блока

    Следующие константы указывают значения, используемые методами setVerticalAlignment: и verticalAlignment.

    Объявление

    Swift

    enum NSTextBlockVerticalAlignment : UInt { case TopAlignment case MiddleAlignment case BottomAlignment case BaselineAlignment }

    Objective C

    enum { NSTextBlockTopAlignment = 0, NSTextBlockMiddleAlignment = 1, NSTextBlockBottomAlignment = 2, NSTextBlockBaselineAlignment = 3 }; typedef NSUInteger NSTextBlockVerticalAlignment;

    Константы

    • TopAlignment

      NSTextBlockTopAlignment

      Выравнивает смежные блоки в их вершине.

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

    • MiddleAlignment

      NSTextBlockMiddleAlignment

      Выравнивает смежные блоки в их середину.

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

    • BottomAlignment

      NSTextBlockBottomAlignment

      Выравнивает смежные блоки в их нижней части.

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

    • BaselineAlignment

      NSTextBlockBaselineAlignment

      Выравнивает смежные блоки в базовой линии первой строки текста в блоке.

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

    • NSTextBlockVerticalAlignment

      NSTextBlockVerticalAlignment

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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