NSBezierPath

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

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

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

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

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

NSObject
NSBezierPath

NSObject
NSBezierPath

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

AnyObject
CVarArgType
Сопоставимый
Hashable
NSCoding
NSCopying
NSObjectProtocol
Печатаемый
NSCoding
NSCopying
NSObject

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Создание объекта NSBezierPath

bezierPath + bezierPath

Создает и возвращает новое NSBezierPath объект.

Объявление

Objective C

+ (NSBezierPath *)bezierPath

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

Новый пустой объект контуров.

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

Objective C

@import AppKit;

Доступность

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

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

Объявление

Swift

init(ovalInRect aRect: NSRect) -> NSBezierPath

Objective C

+ (NSBezierPath *)bezierPathWithOvalInRect:(NSRect)aRect

Параметры

aRect

Прямоугольник, в котором можно нанести овал.

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

NSBezierPath новый объект контуров с овальным путем.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ bezierPath
– appendBezierPathWithOvalInRect:
init (rect:) + bezierPathWithRect:

Создает и возвращает новое NSBezierPath объект инициализируется с прямоугольным контуром.

Объявление

Swift

init(rect aRect: NSRect) -> NSBezierPath

Objective C

+ (NSBezierPath *)bezierPathWithRect:(NSRect)aRect

Параметры

aRect

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

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

Новый объект контуров с прямоугольным контуром.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ bezierPath
– appendBezierPathWithRect:
+ fillRect:
+ strokeRect:


    
    init (roundedRect:xRadius:yRadius:)
    + bezierPathWithRoundedRect:xRadius:yRadius:

Создает и возвращает новое NSBezierPath объект инициализируется с округленным прямоугольным контуром.

Объявление

Swift

init(roundedRect rect: NSRect, xRadius xRadius: CGFloat, yRadius yRadius: CGFloat) -> NSBezierPath

Objective C

+ (NSBezierPath *)bezierPathWithRoundedRect:(NSRect)rect xRadius:(CGFloat)xRadius yRadius:(CGFloat)yRadius

Параметры

`rect`	Прямоугольник, определяющий основную форму пути.
`xRadius`	Радиус каждого угла, овального вдоль оси X. Значения, больше, чем половина ширины прямоугольника, фиксируются к половине ширины.
`yRadius`	Радиус каждого угла, овального вдоль оси y. Значения, больше, чем половина высоты прямоугольника, фиксируются к половине высоты.

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

Новый объект контуров с округленным прямоугольным контуром.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ bezierPath
– appendBezierPathWithRoundedRect:xRadius:yRadius:

bezierPathByFlatteningPath bezierPathByFlatteningPath Свойство

Сглаженная версия объекта контуров. (только для чтения)

Объявление

Swift

@NSCopying var bezierPathByFlatteningPath: NSBezierPath { get }

Objective C

@property(readonly, copy) NSBezierPath *bezierPathByFlatteningPath

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Путь, содержащий обратное содержание текущего объекта контуров. (только для чтения)

Объявление

Swift

@NSCopying var bezierPathByReversingPath: NSBezierPath { get }

Objective C

@property(readonly, copy) NSBezierPath *bezierPathByReversingPath

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Построение путей

moveToPoint (_:) - moveToPoint:

Перемещает текущую точку получателя к указанному расположению.

Объявление

Swift

func moveToPoint(_ aPoint: NSPoint)

Objective C

- (void)moveToPoint:(NSPoint)aPoint

Параметры

aPoint

Точка в текущей системе координат.

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– closePath
– curveToPoint:controlPoint1:controlPoint2:
– lineToPoint:


    
    lineToPoint (_:)
    - lineToPoint:

Добавляет прямую линию к пути получателя

Объявление

Swift

func lineToPoint(_ aPoint: NSPoint)

Objective C

- (void)lineToPoint:(NSPoint)aPoint

Параметры


      aPoint

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

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– closePath
– curveToPoint:controlPoint1:controlPoint2:


    
    curveToPoint (_: controlPoint1:controlPoint2:)
    - curveToPoint:controlPoint1:controlPoint2:

Добавляет Безье кубическую кривую к пути получателя.

Объявление

Swift

func curveToPoint(_ aPoint: NSPoint, controlPoint1 controlPoint1: NSPoint, controlPoint2 controlPoint2: NSPoint)

Objective C

- (void)curveToPoint:(NSPoint)aPoint controlPoint1:(NSPoint)controlPoint1 controlPoint2:(NSPoint)controlPoint2

Параметры

`aPoint`	Пункт назначения сегмента кривой, указанного в текущей системе координат
`controlPoint1`	Точка, определяющая форму кривой около текущей точки.
`controlPoint2`	Точка, определяющая форму кривой около пункта назначения.

Обсуждение

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– closePath
– lineToPoint:
– relativeCurveToPoint:controlPoint1:controlPoint2:
+ setDefaultFlatness:

closePath () - closePath

Закрывает последний раз добавленный подпуть.

Объявление

Swift

func closePath()

Objective C

- (void)closePath

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– заливка


    
    relativeMoveToPoint (_:)
    - relativeMoveToPoint:

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

Объявление

Swift

func relativeMoveToPoint(_ aPoint: NSPoint)

Objective C

- (void)relativeMoveToPoint:(NSPoint)aPoint

Параметры


      aPoint

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– closePath
– relativeCurveToPoint:controlPoint1:controlPoint2:
– relativeLineToPoint:


    
    relativeLineToPoint (_:)
    - relativeLineToPoint:

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

Объявление

Swift

func relativeLineToPoint(_ aPoint: NSPoint)

Objective C

- (void)relativeLineToPoint:(NSPoint)aPoint

Параметры


      aPoint

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

Обсуждение

Пункт назначения относительно текущей точки. Например, если текущая точка (1, 1) и aPoint содержит значение (1, 2), линейный сегмент создается между точками (1, 1) и (2, 3).

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– closePath
– lineToPoint:
– relativeLineToPoint:
– relativeMoveToPoint:


    
    relativeCurveToPoint (_: controlPoint1:controlPoint2:)
    - relativeCurveToPoint:controlPoint1:controlPoint2:

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

Объявление

Swift

func relativeCurveToPoint(_ aPoint: NSPoint, controlPoint1 controlPoint1: NSPoint, controlPoint2 controlPoint2: NSPoint)

Objective C

- (void)relativeCurveToPoint:(NSPoint)aPoint controlPoint1:(NSPoint)controlPoint1 controlPoint2:(NSPoint)controlPoint2

Параметры

`aPoint`	Пункт назначения сегмента кривой, интерпретируемого как относительное смещение от текущей точки.
`controlPoint1`	Точка, определяющая форму кривой около текущей точки, интерпретируемой как относительное смещение от текущей точки.
`controlPoint2`	Точка, определяющая форму кривой около пункта назначения, интерпретируемого как относительное смещение от текущей точки.

Обсуждение

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– closePath
– curveToPoint:controlPoint1:controlPoint2:
– relativeLineToPoint:
– relativeMoveToPoint:

Добавление общих форм к пути

appendBezierPath (_:) - appendBezierPath:

Добавляет содержание указанного объекта контуров к пути получателя.

Объявление

Swift

func appendBezierPath(_ aPath: NSBezierPath)

Objective C

- (void)appendBezierPath:(NSBezierPath *)aPath

Параметры

aPath

Путь для добавления к получателю.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    appendBezierPathWithPoints (_: количество:)
    - appendBezierPathWithPoints:count:

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

Объявление

Swift

func appendBezierPathWithPoints(_ points: NSPointArray, count count: Int)

Objective C

- (void)appendBezierPathWithPoints:(NSPointArray)points count:(NSInteger)count

Параметры

`points`	Массив C-стиля `NSPoint` типы данных, каждый из которых содержит конечную точку сегмента следующей строки.
`count`	Число очков в `points` параметр.

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

appendBezierPathWithOvalInRect (_:) - appendBezierPathWithOvalInRect:

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

Объявление

Swift

func appendBezierPathWithOvalInRect(_ aRect: NSRect)

Objective C

- (void)appendBezierPathWithOvalInRect:(NSRect)aRect

Параметры

aRect

Прямоугольник, в котором можно нанести овал.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    appendBezierPathWithArcFromPoint (_: toPoint:radius:)
    - appendBezierPathWithArcFromPoint:toPoint:radius:

Добавляет дугу к пути получателя.

Объявление

Swift

func appendBezierPathWithArcFromPoint(_ fromPoint: NSPoint, toPoint toPoint: NSPoint, radius radius: CGFloat)

Objective C

- (void)appendBezierPathWithArcFromPoint:(NSPoint)fromPoint toPoint:(NSPoint)toPoint radius:(CGFloat)radius

Параметры

`fromPoint`	Срединная точка угла.
`toPoint`	Конечная точка угла.
`radius`	Радиус круга наносится в углу.

Обсуждение

Создаваемая дуга определяется кругом, нанесенным в углу, указанном тремя точками: текущая точка, fromPoint параметр, и toPoint параметр (в том порядке). Сама дуга находится на периметре круга, радиус которого указан radius параметр. Дуга нарисована между двумя точками круга, которые являются касательной к двум участкам угла.

Дуга обычно не содержит точки в fromPoint и toPoint параметры. Если начальная точка дуги не совпадает с текущей точкой, линия проведена между двумя точками. Начальная точка дуги находится на строке, определенной текущей точкой и fromPoint параметр.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    appendBezierPathWithArcWithCenter (_: radius:startAngle:endAngle:)
    - appendBezierPathWithArcWithCenter:radius:startAngle:endAngle:

Добавляет дугу круга к пути получателя.

Объявление

Swift

func appendBezierPathWithArcWithCenter(_ center: NSPoint, radius radius: CGFloat, startAngle startAngle: CGFloat, endAngle endAngle: CGFloat)

Objective C

- (void)appendBezierPathWithArcWithCenter:(NSPoint)center radius:(CGFloat)radius startAngle:(CGFloat)startAngle endAngle:(CGFloat)endAngle

Параметры

`center`	Указывает, что центральная точка круга раньше определяла дугу.
`radius`	Указывает, что радиус круга раньше определял дугу.
`startAngle`	Указывает стартовый угол дуги, измеренной в градусах против часовой стрелки от оси X.
`endAngle`	Указывает угол конца дуги, измеренной в градусах против часовой стрелки от оси X.

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    appendBezierPathWithArcWithCenter (_: radius:startAngle:endAngle:clockwise:)
    - appendBezierPathWithArcWithCenter:radius:startAngle:endAngle:clockwise:

Добавляет дугу круга к пути получателя.

Объявление

Swift

func appendBezierPathWithArcWithCenter(_ center: NSPoint, radius radius: CGFloat, startAngle startAngle: CGFloat, endAngle endAngle: CGFloat, clockwise clockwise: Bool)

Objective C

- (void)appendBezierPathWithArcWithCenter:(NSPoint)center radius:(CGFloat)radius startAngle:(CGFloat)startAngle endAngle:(CGFloat)endAngle clockwise:(BOOL)clockwise

Параметры

`center`	Указывает, что центральная точка круга раньше определяла дугу.
`radius`	Указывает, что радиус круга раньше определял дугу.
`startAngle`	Указывает стартовый угол дуги, измеренной в градусах против часовой стрелки от оси X.
`endAngle`	Указывает угол конца дуги, измеренной в градусах против часовой стрелки от оси X.
`clockwise`	`YEStrue` если Вы хотите, чтобы дуга была нарисована в направлении по часовой стрелке; иначе `NOfalse` нарисовать дугу в направлении против часовой стрелки.

Обсуждение

Создаваемая дуга находится на периметре круга между углами, указанными startAngle и endAngle параметры. Дуга нарисована в направлении, обозначенном clockwise параметр. Если путь получателя пуст, этот метод устанавливает текущую точку в начало дуги прежде, чем добавить сегмент дуги. Если путь получателя не пуст, линия проведена от текущей точки до начальной точки дуги.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    appendBezierPathWithGlyph (_: inFont:)
    - appendBezierPathWithGlyph:inFont:

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

Объявление

Swift

func appendBezierPathWithGlyph(_ aGlyph: NSGlyph, inFont fontObj: NSFont)

Objective C

- (void)appendBezierPathWithGlyph:(NSGlyph)aGlyph inFont:(NSFont *)fontObj

Параметры

`aGlyph`	Глиф для добавления к пути.
`fontObj`	Шрифт, в котором кодируется глиф.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– appendBezierPathWithGlyphs:count:inFont:
– appendBezierPathWithPackedGlyphs:
+ drawPackedGlyphs:atPoint:


    
    appendBezierPathWithGlyphs (_: count:inFont:)
    - appendBezierPathWithGlyphs:count:inFont:

Добавляет основы указанных глифов к пути получателя.

Объявление

Swift

func appendBezierPathWithGlyphs(_ glyphs: UnsafeMutablePointer<NSGlyph>, count count: Int, inFont fontObj: NSFont)

Objective C

- (void)appendBezierPathWithGlyphs:(NSGlyph *)glyphs count:(NSInteger)count inFont:(NSFont *)fontObj

Параметры

`glyphs`	Массив C-стиля `NSGlyph` типы данных для добавления к пути.
`count`	Число глифов в `glyphs` параметр.
`fontObj`	Шрифт, в котором кодируются глифы.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– appendBezierPathWithGlyph:inFont:
– appendBezierPathWithPackedGlyphs:
+ drawPackedGlyphs:atPoint:


    
    appendBezierPathWithPackedGlyphs (_:)
    - appendBezierPathWithPackedGlyphs:

Добавляет массив упакованных глифов к пути получателя.

Объявление

Swift

func appendBezierPathWithPackedGlyphs(_ packedGlyphs: UnsafePointer<Int8>)

Objective C

- (void)appendBezierPathWithPackedGlyphs:(const char *)packedGlyphs

Параметры


      packedGlyphs

Массив C-стиля, содержащий один или больше CGGlyph типы данных, завершенные a NULL символ.

Обсуждение

Необходимо избегать использования этого метода непосредственно. Вместо этого используйте appendBezierPathWithGlyph:inFont: и appendBezierPathWithGlyphs:count:inFont: методы для добавления глифов к пути.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ drawPackedGlyphs:atPoint:

appendBezierPathWithRect (_:) - appendBezierPathWithRect:

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

Объявление

Swift

func appendBezierPathWithRect(_ aRect: NSRect)

Objective C

- (void)appendBezierPathWithRect:(NSRect)aRect

Параметры

aRect

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ bezierPathWithRect:
+ fillRect:
+ strokeRect:


    
    appendBezierPathWithRoundedRect (_: xRadius:yRadius:)
    - appendBezierPathWithRoundedRect:xRadius:yRadius:

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

Объявление

Swift

func appendBezierPathWithRoundedRect(_ rect: NSRect, xRadius xRadius: CGFloat, yRadius yRadius: CGFloat)

Objective C

- (void)appendBezierPathWithRoundedRect:(NSRect)rect xRadius:(CGFloat)xRadius yRadius:(CGFloat)yRadius

Параметры

`rect`	Прямоугольник, определяющий основную форму пути.
`xRadius`	Радиус каждого угла, овального вдоль оси X. Значения, больше, чем половина ширины прямоугольника, фиксируются к половине ширины.
`yRadius`	Радиус каждого угла, овального вдоль оси y. Значения, больше, чем половина высоты прямоугольника, фиксируются к половине высоты.

Обсуждение

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ bezierPathWithRoundedRect:xRadius:yRadius:

Доступ к атрибутам пути

windingRule windingRule Свойство

Вьющееся правило раньше заполняло путь.

Объявление

Swift

var windingRule: NSWindingRule

Objective C

@property NSWindingRule windingRule

Обсуждение

Это значение может быть также NSNonZeroWindingRule или NSEvenOddWindingRule. Это значение переопределяет значение по умолчанию, возвращенное defaultWindingRule метод.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– заливка
+ defaultWindingRule
lineCapStyle lineCapStyle Свойство

Стиль окончания линии для пути.

Объявление

Swift

var lineCapStyle: NSLineCapStyle

Objective C

@property NSLineCapStyle lineCapStyle

Обсуждение

Стиль окончания линии указывает форму конечных точек на открытом контуре, когда перечеркиваемый. Рисунок 1 показывает появление доступных стилей окончания линии. Значение по умолчанию этого свойства является значением, возвращенным defaultLineCapStyle метод. Для полного списка значений посмотрите NSLineCapStyle.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ defaultLineCapStyle
+ setDefaultLineCapStyle:
lineJoinStyle lineJoinStyle Свойство

Стиль соединения строки для пути.

Объявление

Swift

var lineJoinStyle: NSLineJoinStyle

Objective C

@property NSLineJoinStyle lineJoinStyle

Обсуждение

Параграф

Стиль соединения строки указывает форму соединений между связанными сегментами перечеркиваемого пути. Рисунок 2 показывает появление доступных стилей соединения строки. Значение по умолчанию этого свойства является значением, возвращенным defaultLineJoinStyle метод. Для полного списка значений посмотрите NSLineJoinStyle.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ defaultLineJoinStyle
+ setDefaultLineJoinStyle:
ширина линий ширина линий Свойство

Ширина перечеркиваемых строк пути.

Объявление

Swift

var lineWidth: CGFloat

Objective C

@property CGFloat lineWidth

Обсуждение

Ширина строки определяет толщину перечеркиваемого пути получателя. Ширина 0 интерпретируется как самая тонкая строка, которая может быть представлена на определенном устройстве. Фактическая представленная ширина строки может варьироваться от указанной ширины целых 2 пикселями устройства, в зависимости от позиции строки относительно пиксельной сетки и текущих настроек сглаживания. Ширина строки может также быть затронута масштабными коэффициентами, указанными в текущей матрице преобразования активного графического контекста.

Значение по умолчанию этого свойства является значением, возвращенным defaultLineWidth метод.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ defaultLineWidth
+ setDefaultLineWidth:
miterLimit miterLimit Свойство

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

Объявление

Swift

var miterLimit: CGFloat

Objective C

@property CGFloat miterLimit

Обсуждение

Предельный угол стыка помогает Вам избежать скачков в соединении двух линейных сегментов, соединенных соединением среза (NSMiterLineJoinStyle). Если отношение длины среза — диагональная длина соединения среза — к толщине строки превышает предельный угол стыка, соединение преобразовывается в косоугольное соединение.

Значение по умолчанию этого свойства является значением, возвращенным defaultMiterLimit метод.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ defaultMiterLimit
+ setDefaultMiterLimit:
плоскость плоскость Свойство

Точность, с которой представляются кривые.

Объявление

Swift

var flatness: CGFloat

Objective C

@property CGFloat flatness

Обсуждение

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

Значение по умолчанию этого свойства является значением, возвращенным defaultFlatness метод.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ defaultFlatness
+ setDefaultFlatness:


    
    getLineDash (_: count:phase:)
    - getLineDash:count:phase:

Возвращает перечеркивающий строку образец для получателя.

Объявление

Swift

func getLineDash(_ pattern: UnsafeMutablePointer<CGFloat>, count count: UnsafeMutablePointer<Int>, phase phase: UnsafeMutablePointer<CGFloat>)

Objective C

- (void)getLineDash:(CGFloat *)pattern count:(NSInteger *)count phase:(CGFloat *)phase

Параметры

`pattern`	На вводе, массиве C-стиля значений с плавающей точкой, или `nil` если Вы не хотите значения образца. На выводе этот массив содержит длины (измеренный в точках) линейных сегментов и разрывов в образце. Значения в альтернативе массива, начиная с первой продолжительности линейного сегмента, сопровождаемой первой длиной разрыва, сопровождаемой второй продолжительностью линейного сегмента, и т.д.
`count`	На вводе, указателе на целое число или `nil` если Вы не хотите число записей образца. На выводе, числе записей, записанных в `pattern`.
`phase`	На вводе, указателе на значение с плавающей точкой или `nil` если Вы не хотите фазу. На выводе это значение содержит смещение, при котором можно начать рисовать образец, измеренный в точках вдоль образца пунктирной линии. Например, фаза 6 в образце 5-2-3-2 заставила бы получение начинаться посреди первого разрыва.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setLineDash:count:phase:


    
    setLineDash (_: count:phase:)
    - setLineDash:count:phase:

Устанавливает перечеркивающий строку образец для получателя.

Объявление

Swift

func setLineDash(_ pattern: UnsafePointer<CGFloat>, count count: Int, phase phase: CGFloat)

Objective C

- (void)setLineDash:(const CGFloat *)pattern count:(NSInteger)count phase:(CGFloat)phase

Параметры

`pattern`	Массив C-стиля значений с плавающей точкой, содержащий длины (измеренный в точках) линейных сегментов и разрывов в образце. Значения в альтернативе массива, начиная с первой продолжительности линейного сегмента, сопровождаемой первой длиной разрыва, сопровождаемой второй продолжительностью линейного сегмента, и т.д.
`count`	Число значений в `pattern`.
`phase`	Смещение, при котором можно начать рисовать образец, измерилось в точках вдоль образца пунктирной линии. Например, фаза 6 в образце 5-2-3-2 заставила бы получение начинаться посреди первого разрыва

Обсуждение

Например, для создания купонного типа супермаркета пунктирной линии:

      array[0] = 5.0; //segment painted with stroke color
array[1] = 2.0; //segment not painted with a color
 
[path setLineDash: array count: 2 phase: 0.0];

В вышеупомянутом примере, если Вы устанавливаете phase к 6,0, тире строки начал бы точно шесть модулей в pattern, который запустил бы образец посреди первого разрыва.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– getLineDash:count:phase:

Конфигурирование атрибутов пути по умолчанию

defaultWindingRule () + defaultWindingRule

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

Объявление

Swift

class func defaultWindingRule() -> NSWindingRule

Objective C

+ (NSWindingRule)defaultWindingRule

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

Текущее проветривание значения по умолчанию управляет или NSNonZeroWindingRule если не было установлено никакое стандартное правило. Это значение может быть также NSNonZeroWindingRule или NSEvenOddWindingRule.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ setDefaultWindingRule:
windingRule


    
    setDefaultWindingRule (_:)
    + setDefaultWindingRule:

Устанавливает значение по умолчанию, вьющееся правило раньше заполняло все пути.

Объявление

Swift

class func setDefaultWindingRule(_ windingRule: NSWindingRule)

Objective C

+ (void)setDefaultWindingRule:(NSWindingRule)windingRule

Параметры


      windingRule

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

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ defaultWindingRule

defaultLineCapStyle () + defaultLineCapStyle

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

Объявление

Swift

class func defaultLineCapStyle() -> NSLineCapStyle

Objective C

+ (NSLineCapStyle)defaultLineCapStyle

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

Стиль окончания линии по умолчанию или NSButtLineCapStyle если не был установлен никакой другой стиль. Для списка значений посмотрите Константы.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ setDefaultLineCapStyle:
+ defaultLineJoinStyle
+ defaultLineWidth
lineCapStyle


    
    setDefaultLineCapStyle (_:)
    + setDefaultLineCapStyle:

Устанавливает стиль окончания линии по умолчанию для всех путей.

Объявление

Swift

class func setDefaultLineCapStyle(_ lineCap: NSLineCapStyle)

Objective C

+ (void)setDefaultLineCapStyle:(NSLineCapStyle)lineCap

Параметры


      lineCap

Стиль окончания линии по умолчанию. Для списка значений посмотрите Константы.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ defaultLineCapStyle
lineCapStyle

defaultLineJoinStyle () + defaultLineJoinStyle

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

Объявление

Swift

class func defaultLineJoinStyle() -> NSLineJoinStyle

Objective C

+ (NSLineJoinStyle)defaultLineJoinStyle

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

Стиль соединения строки по умолчанию или NSMiterLineJoinStyle если не было установлено никакое другое значение. Для списка значений посмотрите Константы.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ setDefaultLineJoinStyle:
lineJoinStyle


    
    setDefaultLineJoinStyle (_:)
    + setDefaultLineJoinStyle:

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

Объявление

Swift

class func setDefaultLineJoinStyle(_ lineJoinStyle: NSLineJoinStyle)

Objective C

+ (void)setDefaultLineJoinStyle:(NSLineJoinStyle)lineJoinStyle

Параметры


      lineJoinStyle

Стиль соединения строки по умолчанию. Для списка значений посмотрите Константы.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ defaultLineJoinStyle
lineJoinStyle

defaultLineWidth () + defaultLineWidth

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

Объявление

Swift

class func defaultLineWidth() -> CGFloat

Objective C

+ (CGFloat)defaultLineWidth

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ setDefaultLineWidth:
ширина линий


    
    setDefaultLineWidth (_:)
    + setDefaultLineWidth:

Устанавливает ширину строки по умолчанию для всех путей.

Объявление

Swift

class func setDefaultLineWidth(_ width: CGFloat)

Objective C

+ (void)setDefaultLineWidth:(CGFloat)width

Параметры


      width

Ширина строки по умолчанию, измеренная в точках в пользовательском координатном пространстве.

Обсуждение

Ширина строки определяет толщину перечеркиваемых путей. Ширина 0 интерпретируется как самая тонкая строка, которая может быть представлена на определенном устройстве. Фактическая представленная ширина строки может варьироваться от указанной ширины целых 2 пикселями устройства, в зависимости от позиции строки относительно пиксельной сетки и текущих настроек сглаживания. Ширина строки может также быть затронута масштабными коэффициентами, указанными в текущей матрице преобразования активного графического контекста.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ defaultLineWidth
ширина линий

defaultMiterLimit () + defaultMiterLimit

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

Объявление

Swift

class func defaultMiterLimit() -> CGFloat

Objective C

+ (CGFloat)defaultMiterLimit

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ setDefaultMiterLimit:
miterLimit


    
    setDefaultMiterLimit (_:)
    + setDefaultMiterLimit:

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

Объявление

Swift

class func setDefaultMiterLimit(_ limit: CGFloat)

Objective C

+ (void)setDefaultMiterLimit:(CGFloat)limit

Параметры


      limit

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

Обсуждение

Предельный угол стыка помогает Вам избежать скачков в соединении двух линейных сегментов, соединенных соединением среза (NSMiterLineJoinStyle). Если отношение длины среза — диагональная длина соединения среза — к толщине строки превышает предельный угол стыка, соединение преобразовывается в косоугольное соединение. Значение предельного угла стыка по умолчанию равняется 10, который преобразовывает срезы, угол которых в соединении составляет меньше чем 11 градусов.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ defaultMiterLimit
+ setDefaultLineJoinStyle:
miterLimit

defaultFlatness () + defaultFlatness

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

Объявление

Swift

class func defaultFlatness() -> CGFloat

Objective C

+ (CGFloat)defaultFlatness

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ setDefaultFlatness:
плоскость
setDefaultFlatness (_:) + setDefaultFlatness:

Устанавливает значение плоскости по умолчанию для всех путей.

Объявление

Swift

class func setDefaultFlatness(_ flatness: CGFloat)

Objective C

+ (void)setDefaultFlatness:(CGFloat)flatness

Параметры

flatness

Значение плоскости по умолчанию.

Обсуждение

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

Значение плоскости по умолчанию 0.6, который приводит к плавным кривым.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ defaultFlatness
плоскость

Рисование путей

штрих () - штрих

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

Объявление

Swift

func stroke()

Objective C

- (void)stroke

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– заливка
+ setDefaultLineCapStyle:
+ setDefaultLineJoinStyle:
– set (NSColor)
заливка () - заливка

Красит область включенной путем получателя.

Объявление

Swift

func fill()

Objective C

- (void)fill

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– штрих
windingRule
– set (NSColor)
fillRect (_:) + fillRect:

Заполняет указанный прямоугольный контур текущим цветом заливки.

Объявление

Swift

class func fillRect(_ aRect: NSRect)

Objective C

+ (void)fillRect:(NSRect)aRect

Параметры

aRect

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

Обсуждение

Этот метод сразу заполняет указанную область. Этот метод использует составляющую композит работу, возвращенную compositingOperation метод NSGraphicsContext.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– appendBezierPathWithRect:
+ bezierPathWithRect:
+ strokeRect:
– compositingOperation (NSGraphicsContext)
– set (NSColor)
strokeRect (_:) + strokeRect:

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

Объявление

Swift

class func strokeRect(_ aRect: NSRect)

Objective C

+ (void)strokeRect:(NSRect)aRect

Параметры

aRect

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– appendBezierPathWithRect:
+ bezierPathWithRect:
+ fillRect:
+ setDefaultLineJoinStyle:
+ setDefaultLineWidth:
– set (NSColor)


    
    strokeLineFromPoint (_: toPoint:)
    + strokeLineFromPoint:toPoint:

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

Объявление

Swift

class func strokeLineFromPoint(_ point1: NSPoint, toPoint point2: NSPoint)

Objective C

+ (void)strokeLineFromPoint:(NSPoint)point1 toPoint:(NSPoint)point2

Параметры

`point1`	Начальная точка строки.
`point2`	Конечная точка строки.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– lineToPoint:
– moveToPoint:
+ setDefaultLineCapStyle:
+ setDefaultLineWidth:
– штрих


    
    drawPackedGlyphs (_: atPoint:)
    + drawPackedGlyphs:atPoint:

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

Объявление

Swift

class func drawPackedGlyphs(_ packedGlyphs: UnsafePointer<Int8>, atPoint aPoint: NSPoint)

Objective C

+ (void)drawPackedGlyphs:(const char *)packedGlyphs atPoint:(NSPoint)aPoint

Параметры

`packedGlyphs`	Массив C-стиля, содержащий один или больше `CGGlyph` типы данных, завершенные a `NULL` символ.
`aPoint`	Начальная точка, в которой можно нарисовать глифы.

Обсуждение

Этот метод сразу рисует глифы.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– appendBezierPathWithPackedGlyphs:
– set (NSColor)

Траектории отсечения

addClip () - addClip

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

Объявление

Swift

func addClip()

Objective C

- (void)addClip

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ clipRect:
– setClip
setClip () - setClip

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

Объявление

Swift

func setClip()

Objective C

- (void)setClip

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– addClip
+ clipRect:
– saveGraphicsState (NSGraphicsContext)
– restoreGraphicsState (NSGraphicsContext)
clipRect (_:) + clipRect:

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

Объявление

Swift

class func clipRect(_ aRect: NSRect)

Objective C

+ (void)clipRect:(NSRect)aRect

Параметры

aRect

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– addClip
– setClip

Обнаружение хита


    
    containsPoint (_:)
    - containsPoint:

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

Объявление

Swift

func containsPoint(_ aPoint: NSPoint) -> Bool

Objective C

- (BOOL)containsPoint:(NSPoint)aPoint

Параметры


      aPoint

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

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

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Запросы путей

границы границы Свойство

Ограничительная рамка пути получателя (только для чтения)

Объявление

Swift

var bounds: NSRect { get }

Objective C

@property(readonly) NSRect bounds

Обсуждение

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

Если путь пуст, получая доступ к этому свойству повышения NSGenericException.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Ограничительная рамка пути получателя, включая любые контрольные точки (только для чтения)

Объявление

Swift

var controlPointBounds: NSRect { get }

Objective C

@property(readonly) NSRect controlPointBounds

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

границы
currentPoint currentPoint Свойство

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

Объявление

Swift

var currentPoint: NSPoint { get }

Objective C

@property(readonly) NSPoint currentPoint

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– closePath
– curveToPoint:controlPoint1:controlPoint2:
– lineToPoint:
– moveToPoint:
пустой пустой Свойство

Булево значение, указывающее, пуст ли путь. (только для чтения)

Объявление

Swift

var empty: Bool { get }

Objective C

@property(getter=isEmpty, readonly) BOOL empty

Обсуждение

Значение этого свойства YEStrue если путь не содержит элементов, или NOfalse если это содержит по крайней мере один элемент.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Применение трансформаций

transformUsingAffineTransform (_:) - transformUsingAffineTransform:
Преобразовывает все точки в получатель с помощью указанного преобразования.

Объявление

Swift

func transformUsingAffineTransform(_ aTransform: NSAffineTransform)

Objective C

- (void)transformUsingAffineTransform:(NSAffineTransform *)aTransform

Параметры

aTransform

Преобразование для применения к пути.
Обсуждение

Этот метод применяет преобразование к точкам пути сразу. Следующий код переводит строку от 0,0 до 100 100 к строке от 10,10 до 110 110.
NSBezierPath *bezierPath = [NSBezierPath bezierPath];

NSAffineTransform *transform = [NSAffineTransform transform];

[bezierPath moveToPoint: NSMakePoint(0.0, 0.0)];

[bezierPath lineToPoint: NSMakePoint(100.0, 100.0)];

[transform translateXBy: 10.0 yBy: 10.0];

[bezierPath transformUsingAffineTransform: transform];
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступ к элементам пути

elementCount elementCount Свойство

Общее количество элементов пути по пути получателя. (только для чтения)

Объявление

Swift

var elementCount: Int { get }

Objective C

@property(readonly) NSInteger elementCount

Обсуждение

Каждый тип элемента соответствует одной из операций, описанных в Элементах Пути.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– elementAtIndex:
– elementAtIndex:associatedPoints:
elementAtIndex (_:) - elementAtIndex:

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

Объявление

Swift

func elementAtIndex(_ index: Int) -> NSBezierPathElement

Objective C

- (NSBezierPathElement)elementAtIndex:(NSInteger)index

Параметры

index

Индекс желаемого элемента пути.

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

Тип элемента пути. Для списка констант посмотрите NSBezierPathElement.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

elementCount
– elementAtIndex:associatedPoints:
bezierPathByReversingPath


    
    elementAtIndex (_: associatedPoints:)
    - elementAtIndex:associatedPoints:

Получает тип элемента и (и дополнительно) связанные точки для элемента пути в указанном индексе.

Объявление

Swift

func elementAtIndex(_ index: Int, associatedPoints points: NSPointArray) -> NSBezierPathElement

Objective C

- (NSBezierPathElement)elementAtIndex:(NSInteger)index associatedPoints:(NSPointArray)points

Параметры

`index`	Индекс желаемого элемента пути.
`points`	На вводе, массив C-стиля, содержащий до трех `NSPoint` типы данных, или `NULL` если Вы не хотите точки. На выводе точки данных связались с указанным элементом пути.

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

Тип элемента пути. Для списка констант посмотрите NSBezierPathElement.

Обсуждение

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

Для операций кривой порядок точек является controlPoint1 (points[0]), controlPoint2 (points[1]), конечная точка (points[2]).

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

elementCount
– elementAtIndex:

removeAllPoints () - removeAllPoints

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

Объявление

Swift

func removeAllPoints()

Objective C

- (void)removeAllPoints

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    setAssociatedPoints (_: atIndex:)
    - setAssociatedPoints:atIndex:

Изменяет точки, связанные с указанным элементом пути.

Объявление

Swift

func setAssociatedPoints(_ points: NSPointArray, atIndex index: Int)

Objective C

- (void)setAssociatedPoints:(NSPointArray)points atIndex:(NSInteger)index

Параметры


      points

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


      index

Индекс элемента пути Вы хотите изменить.

Обсуждение

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

Следующий пример показывает Вам, как Вы изменили бы точку, связанную с элементом пути строки. Путь, создаваемый этим примером, приводит к пути с двумя элементами. Первый элемент пути указывает перемещение для указания (0, 0), в то время как второе создает строку для указания (100, 100). Это тогда изменяет строку для движения только в точку (50,50) использование этого метода:

      NSBezierPath *bezierPath = [NSBezierPath bezierPath];
NSPoint newPoint = NSMakePoint(50.0, 50.0);
 
[bezierPath moveToPoint: NSMakePoint(0.0, 0.0)];
[bezierPath lineToPoint: NSMakePoint(100.0, 100.0)];
 
// Modifies the point added by lineToPoint: method (100.0, 100.0)
// to the new point (50.0, 50.0)
[bezierPath setAssociatedPoints: &newPoint atIndex: 1];

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Кэширование путей

cachesBezierPath - cachesBezierPath (OS X v10.0)

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

Объявление

Objective C

- (BOOL)cachesBezierPath

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

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

Обсуждение

Кэширование путей в настоящее время не имеет никакого эффекта, таким образом, метод всегда возвращается НЕТ.

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

Objective C

@import AppKit;

Доступность

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

См. также

– setCachesBezierPath:


    
    setCachesBezierPath:
    - setCachesBezierPath:

(OS X v10.0)

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

Объявление

Objective C

- (void)setCachesBezierPath:(BOOL)flag

Параметры


      flag

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

Обсуждение

Кэширование путей в настоящее время не имеет никакого эффекта.

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

Objective C

@import AppKit;

Доступность

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

Осуждаемый в OS X v10.0.

См. также

– cachesBezierPath

Константы

NSBezierPathElement
Основные команды элемента пути.

Объявление

Swift

enum NSBezierPathElement : UInt { case MoveToBezierPathElement case LineToBezierPathElement case CurveToBezierPathElement case ClosePathBezierPathElement }

Objective C

typedef enum { NSMoveToBezierPathElement, NSLineToBezierPathElement, NSCurveToBezierPathElement, NSClosePathBezierPathElement } NSBezierPathElement;

Константы
- MoveToBezierPathElement
  
  NSMoveToBezierPathElement
  
  Перемещает текущую точку получения объекта контуров к указанной точке.
  
  Этот элемент пути не приводит ни к какому получению. Используя эту команду посреди пути приводит к разъединенному линейному сегменту.
  
  Содержит 1 точку.
  
  Доступный в OS X v10.0 и позже.
- LineToBezierPathElement
  
  NSLineToBezierPathElement
  
  Создает прямую линию от текущей точки получения до указанной точки.
  
  Строки и прямоугольники указаны с помощью этого элемента пути.
  
  Содержит 1 точку.
  
  Доступный в OS X v10.0 и позже.
- CurveToBezierPathElement
  
  NSCurveToBezierPathElement
  
  Создает изогнутый сегмент линии от текущей точки до указанной конечной точки с помощью двух контрольных точек для определения кривой.
  
  Точки сохранены в следующем порядке: controlPoint1, controlPoint2, конечная точка. Овалы, дуги и Кривые Безье все элементы кривой использования для указания их геометрии.
  
  Содержит 3 точки.
  
  Доступный в OS X v10.0 и позже.
- ClosePathBezierPathElement
  
  NSClosePathBezierPathElement
  
  Отмечает конец текущего подпути в указанной точке.
  
  Обратите внимание на то, что точка, указанная для элемента Замкнутого контура, является по существу тем же как текущей точкой.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
NSLineJoinStyle
Эти константы указывают форму соединений между связанными сегментами перечеркиваемого пути.

Объявление

Swift

enum NSLineJoinStyle : UInt { case MiterLineJoinStyle case RoundLineJoinStyle case BevelLineJoinStyle }

Objective C

typedef enum { NSMiterLineJoinStyle = 0, NSRoundLineJoinStyle = 1, NSBevelLineJoinStyle = 2 } NSLineJoinStyle;

Константы
- BevelLineJoinStyle
  
  NSBevelLineJoinStyle
  
  Указывает косоугольную форму строки соединений между связанными сегментами перечеркиваемого пути.
  
  Посмотрите setDefaultLineJoinStyle: метод для примера появления.
  
  Доступный в OS X v10.0 и позже.
- MiterLineJoinStyle
  
  NSMiterLineJoinStyle
  
  Указывает форму строки среза соединений между связанными сегментами перечеркиваемого пути.
  
  Посмотрите setDefaultLineJoinStyle: метод для примера появления.
  
  Доступный в OS X v10.0 и позже.
- RoundLineJoinStyle
  
  NSRoundLineJoinStyle
  
  Указывает круглую форму строки соединений между связанными сегментами перечеркиваемого пути.
  
  Посмотрите setDefaultLineJoinStyle: метод для примера появления.
  
  Доступный в OS X v10.0 и позже.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
NSLineCapStyle
Эти константы указывают форму конечных точек для открытого контура, когда перечеркиваемый.

Объявление

Swift

enum NSLineCapStyle : UInt { case ButtLineCapStyle case RoundLineCapStyle case SquareLineCapStyle }

Objective C

typedef enum { NSButtLineCapStyle = 0, NSRoundLineCapStyle = 1, NSSquareLineCapStyle = 2 } NSLineCapStyle;

Константы
- ButtLineCapStyle
  
  NSButtLineCapStyle
  
  Указывает стиль окончания линии торца для конечных точек для открытого контура, когда перечеркиваемый.
  
  Посмотрите setDefaultLineCapStyle: метод для примера появления.
  
  Доступный в OS X v10.0 и позже.
- SquareLineCapStyle
  
  NSSquareLineCapStyle
  
  Указывает квадратный стиль окончания линии для конечных точек для открытого контура, когда перечеркиваемый.
  
  Посмотрите setDefaultLineCapStyle: метод для примера появления.
  
  Доступный в OS X v10.0 и позже.
- RoundLineCapStyle
  
  NSRoundLineCapStyle
  
  Указывает круглый стиль окончания линии для конечных точек для открытого контура, когда перечеркиваемый.
  
  Посмотрите setDefaultLineCapStyle: метод для примера появления.
  
  Доступный в OS X v10.0 и позже.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
NSWindingRule
Эти константы используются для указания вьющегося правила, которое должен использовать путь Безье.

Объявление

Swift

enum NSWindingRule : UInt { case NonZeroWindingRule case EvenOddWindingRule }

Objective C

typedef enum { NSNonZeroWindingRule = 0, NSEvenOddWindingRule = 1 } NSWindingRule;

Константы
- NonZeroWindingRule
  
  NSNonZeroWindingRule
  
  Указывает ненулевое вьющееся правило.
  
  Рассчитайте каждый слева направо соединяет каналом как +1, и каждый справа налево соединяет каналом как-1. Если сумма всех пересечений 0, точка вне пути. Если сумма является ненулевой, точка в пути, и область, содержащая его, заполнена. Это - правило проветривания значения по умолчанию.
  
  Доступный в OS X v10.0 и позже.
- EvenOddWindingRule
  
  NSEvenOddWindingRule
  
  Указывает ровно-нечетное вьющееся правило.
  
  Считайте общее количество пересечений пути. Если число пересечений даже, точка вне пути. Если число пересечений нечетно, точка в пути, и область, содержащая его, должна быть заполнена.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Эти константы описаны более подробно по Путям.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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