Ссылка CGGeometry

Ссылка CGGeometry определяет структуры для геометрических примитивов и функций, воздействующих на них. Структура данных CGPoint представляет точку в двумерной системе координат. Структура данных CGRect представляет расположение и размерности прямоугольника. Структура данных CGSize представляет размерности ширины и высоты.

Высота и ширина сохранены в a CGRect структура данных может быть отрицательной. Например, прямоугольник с источником [0.0, 0.0] и размер [10.0,10.0] точно эквивалентно прямоугольнику с источником [10.0, 10.0] и размер [-10.0,-10.0]. Ваше приложение может стандартизировать прямоугольник — т.е. гарантировать, что высота и ширина сохранены как положительные значения — путем вызова CGRectStandardize функция. Все функции описали в этой ссылке, которые берут CGRect структуры данных как вводы неявно стандартизируют те прямоугольники прежде, чем вычислить их результаты. Поэтому Ваши приложения должны избежать непосредственно читать и писать данные, хранившие в CGRect структура данных. Вместо этого используйте функции, описанные здесь, чтобы управлять прямоугольниками и получить их характеристики.

Функции

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

CGPointCreateDictionaryRepresentation (_:) CGPointCreateDictionaryRepresentation

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

Объявление

Swift

func CGPointCreateDictionaryRepresentation(_ point: CGPoint) -> CFDictionary!

Objective C

CFDictionaryRef CGPointCreateDictionaryRepresentation ( CGPoint point );

Параметры

point

Точка.

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

Представление словаря точки.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

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

Объявление

Swift

func CGSizeCreateDictionaryRepresentation(_ size: CGSize) -> CFDictionary!

Objective C

CFDictionaryRef CGSizeCreateDictionaryRepresentation ( CGSize size );

Параметры

size

Размер.

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

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

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

Объявление

Swift

func CGRectCreateDictionaryRepresentation(_ rect: CGRect) -> CFDictionary!

Objective C

CFDictionaryRef CGRectCreateDictionaryRepresentation ( CGRect );

Параметры

rect

Прямоугольник.

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

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

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


    
    CGPointMakeWithDictionaryRepresentation (_: _:)
    CGPointMakeWithDictionaryRepresentation

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

Объявление

Swift

func CGPointMakeWithDictionaryRepresentation(_ dict: CFDictionary!, _ point: UnsafeMutablePointer<CGPoint>) -> Bool

Objective C

bool CGPointMakeWithDictionaryRepresentation ( CFDictionaryRef dict, CGPoint *point );

Параметры

`dict`	Словарь, ранее возвращенный из функции `CGPointCreateDictionaryRepresentation`.
`point`	По возврату точка создается из предоставленного словаря.

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

true если успешный; иначе false.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGSizeMakeWithDictionaryRepresentation (_: _:)
    CGSizeMakeWithDictionaryRepresentation

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

Объявление

Swift

func CGSizeMakeWithDictionaryRepresentation(_ dict: CFDictionary!, _ size: UnsafeMutablePointer<CGSize>) -> Bool

Objective C

bool CGSizeMakeWithDictionaryRepresentation ( CFDictionaryRef dict, CGSize *size );

Параметры

`dict`	Словарь, ранее возвращенный из функции `CGSizeCreateDictionaryRepresentation`.
`size`	По возврату размер создается из указанного словаря.

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

true если успешный; иначе, false.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGRectMakeWithDictionaryRepresentation (_: _:)
    CGRectMakeWithDictionaryRepresentation

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

Объявление

Swift

func CGRectMakeWithDictionaryRepresentation(_ dict: CFDictionary!, _ rect: UnsafeMutablePointer<CGRect>) -> Bool

Objective C

bool CGRectMakeWithDictionaryRepresentation ( CFDictionaryRef dict, CGRect *rect );

Параметры

`dict`	Словарь, ранее возвращенный из функции `CGRectCreateDictionaryRepresentation`.
`rect`	По возврату прямоугольник создается из указанного словаря.

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

true если успешный; иначе, false.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Создание геометрического примитива от значений


    
    CGPointMake (_: _:)
    CGPointMake

Возвращает точку с указанными координатами.

Объявление

Swift

func CGPointMake(_ x: CGFloat, _ y: CGFloat) -> CGPoint

Objective C

CGPoint CGPointMake ( CGFloat x, CGFloat y );

Параметры

`x`	X-координата точки для построения.
`y`	Y-координата точки для построения.

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

Точка.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGRectMake (_: _: _: _:)
    CGRectMake

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

Объявление

Swift

func CGRectMake(_ x: CGFloat, _ y: CGFloat, _ width: CGFloat, _ height: CGFloat) -> CGRect

Objective C

CGRect CGRectMake ( CGFloat x, CGFloat y, CGFloat width, CGFloat height );

Параметры

`x`	X-координата точки источника прямоугольника.
`y`	Y-координата точки источника прямоугольника.
`width`	Ширина прямоугольника.
`height`	Высота прямоугольника.

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

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

CGSizeMake (_: _:) CGSizeMake

Возвращает размер с указанными значениями размерности.

Объявление

Swift

func CGSizeMake(_ width: CGFloat, _ height: CGFloat) -> CGSize

Objective C

CGSize CGSizeMake ( CGFloat width, CGFloat height );

Параметры

width

Значение ширины.

height

Значение высоты.

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

Возвраты a CGSize структура с указанной шириной и высотой.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGVectorMake (_: _:)
    CGVectorMake

Возвращает вектор с указанными значениями размерности.

Объявление

Swift

func CGVectorMake(_ dx: CGFloat, _ dy: CGFloat) -> CGVector

Objective C

CGVector CGVectorMake ( CGFloat dx, CGFloat dy );

Параметры

`dx`	X-координата вектора для построения.
`dy`	Y-координата вектора для построения.

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

Возвраты a CGVector структура с указанными координатами.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Изменение прямоугольников


    
    CGRectDivide (_: _: _: _: _:)
    CGRectDivide

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

Объявление

Swift

func CGRectDivide(_ rect: CGRect, _ slice: UnsafeMutablePointer<CGRect>, _ remainder: UnsafeMutablePointer<CGRect>, _ amount: CGFloat, _ edge: CGRectEdge)

Objective C

void CGRectDivide ( CGRect rect, CGRect *slice, CGRect *remainder, CGFloat amount, CGRectEdge edge );

Параметры

`rect`	Исходный прямоугольник.
`slice`	На вводе, указателе на неинициализированный прямоугольник. По возврату прямоугольник заполнен в указанным краем и значениями, который расширяет расстояние вне края, указанного `amount` параметр. Не должен быть `NULL`.
`remainder`	На вводе, указателе на неинициализированный прямоугольник. По возврату прямоугольник содержит часть исходного прямоугольника, остающегося после `CGRectEdge` производит прямоугольник «части». Не должен быть `NULL`.
`amount`	Расстояние от прямоугольной стороны, указанной в `edge` параметр. Это расстояние определяет строку, параллельную указанной стороне, что Кварцевое использование для деления исходного прямоугольника.
`edge`	Граничное значение, указывающее сторону прямоугольника, от которого расстояние передало в `amount` параметр измеряется. `CGRectDivide` производит прямоугольник «части», содержащий указанный край и расширяющийся `amount` расстояние вне его.

Обсуждение

Если rect нулевой прямоугольник, этот функциональные выводы CGRectNull для обоих slice и remainder прямоугольники.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGRectInset (_: _: _:)
    CGRectInset

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

Объявление

Swift

func CGRectInset(_ rect: CGRect, _ dx: CGFloat, _ dy: CGFloat) -> CGRect

Objective C

CGRect CGRectInset ( CGRect rect, CGFloat dx, CGFloat dy );

Параметры

`rect`	Источник `CGRect` структура.
`dx`	Значение x-координаты для использования для корректировки исходного прямоугольника. Для создания прямоугольника вставки укажите положительное значение. Для создания большего, охватывающего прямоугольника укажите отрицательную величину.
`dy`	Значение y-координаты для использования для корректировки исходного прямоугольника. Для создания прямоугольника вставки укажите положительное значение. Для создания большего, охватывающего прямоугольника укажите отрицательную величину.

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

Прямоугольник. Значение источника смещается в оси X расстоянием, указанным dx параметр и в оси y расстоянием, указанным dy параметр и его размер, скорректированный (2*dx,2*dy), относительно исходного прямоугольника. Если dx и dy положительные значения, тогда размер прямоугольника уменьшен. Если dx и dy отрицательные величины, размер прямоугольника увеличен.

Обсуждение

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

CGRectIntegral (_:) CGRectIntegral

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

Объявление

Swift

func CGRectIntegral(_ rect: CGRect) -> CGRect

Objective C

CGRect CGRectIntegral ( CGRect rect );

Параметры

rect

Исходный прямоугольник.

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

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGRectIntersection (_: _:)
    CGRectIntersection

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

Объявление

Swift

func CGRectIntersection(_ rect1: CGRect, _ rect2: CGRect) -> CGRect

Objective C

CGRect CGRectIntersection ( CGRect r1, CGRect r2 );

Параметры

`rect1`	Первый исходный прямоугольник.
`rect2`	Второй исходный прямоугольник.

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

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

Обсуждение

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGRectOffset (_: _: _:)
    CGRectOffset

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

Объявление

Swift

func CGRectOffset(_ rect: CGRect, _ dx: CGFloat, _ dy: CGFloat) -> CGRect

Objective C

CGRect CGRectOffset ( CGRect rect, CGFloat dx, CGFloat dy );

Параметры

`rect`	Исходный прямоугольник.
`dx`	Значение смещения для x-координаты.
`dy`	Значение смещения для y-координаты.

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

Прямоугольник, который является тем же размером как источник, но с его источником, смещенным dx модули вдоль оси X и dy модули вдоль оси y относительно источника. Возвращает нулевой прямоугольник если rect нулевой прямоугольник.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

CGRectStandardize (_:) CGRectStandardize

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

Объявление

Swift

func CGRectStandardize(_ rect: CGRect) -> CGRect

Objective C

CGRect CGRectStandardize ( CGRect rect );

Параметры

rect

Исходный прямоугольник.

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

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGRectUnion (_: _:)
    CGRectUnion

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

Объявление

Swift

func CGRectUnion(_ r1: CGRect, _ r2: CGRect) -> CGRect

Objective C

CGRect CGRectUnion ( CGRect r1, CGRect r2 );

Параметры

`r1`	Первый исходный прямоугольник.
`r2`	Второй исходный прямоугольник.

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

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

Обсуждение

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Сравнение значений


    
    CGPointEqualToPoint
    CGPointEqualToPoint

Возвраты, равны ли две точки.

Объявление

Objective C

bool CGPointEqualToPoint ( CGPoint point1, CGPoint point2 );

Параметры

`point1`	Первая точка, которая исследует.
`point2`	Вторая точка для исследования.

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

true если две указанных точки являются тем же; иначе, false.

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

Objective C

@import CoreGraphics;

Доступность

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


    
    CGSizeEqualToSize
    CGSizeEqualToSize

Возвраты, равны ли два размера.

Объявление

Objective C

bool CGSizeEqualToSize ( CGSize size1, CGSize size2 );

Параметры

`size1`	Первый размер, который исследует.
`size2`	Второй размер для исследования.

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

true если два указанных размера равны; иначе, false.

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

Objective C

@import CoreGraphics;

Доступность

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


    
    CGRectEqualToRect (_: _:)
    CGRectEqualToRect

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

Объявление

Swift

func CGRectEqualToRect(_ rect1: CGRect, _ rect2: CGRect) -> Bool

Objective C

bool CGRectEqualToRect ( CGRect rect1, CGRect rect2 );

Параметры

`rect1`	Первый прямоугольник, который исследует.
`rect2`	Второй прямоугольник для исследования.

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

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGRectIntersectsRect (_: _:)
    CGRectIntersectsRect

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

Объявление

Swift

func CGRectIntersectsRect(_ rect1: CGRect, _ rect2: CGRect) -> Bool

Objective C

bool CGRectIntersectsRect ( CGRect rect1, CGRect rect2 );

Параметры

`rect1`	Первый прямоугольник, который исследует.
`rect2`	Второй прямоугольник для исследования.

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

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Проверка членство


    
    CGRectContainsPoint (_: _:)
    CGRectContainsPoint

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

Объявление

Swift

func CGRectContainsPoint(_ rect: CGRect, _ point: CGPoint) -> Bool

Objective C

bool CGRectContainsPoint ( CGRect rect, CGPoint point );

Параметры

`rect`	Прямоугольник для исследования.
`point`	Точка для исследования.

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

true если прямоугольник не является нулем или пустой, и точка расположена в прямоугольнике; иначе, false.

Обсуждение

Если его координаты лежат в прямоугольнике или на минимуме X или минимуме Y край, вопрос рассматривается в прямоугольнике.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGRectContainsRect (_: _:)
    CGRectContainsRect

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

Объявление

Swift

func CGRectContainsRect(_ rect1: CGRect, _ rect2: CGRect) -> Bool

Objective C

bool CGRectContainsRect ( CGRect rect1, CGRect rect2 );

Параметры

`rect1`	Прямоугольник для исследования на включение прямоугольника передал в `rect2`.
`rect2`	Прямоугольник для исследования на то, что содержался в прямоугольнике передал в `rect1`.

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

true если прямоугольник, указанный rect2 содержится в прямоугольнике, переданном в rect1; иначе, false. Если объединение этих двух прямоугольников равно первому прямоугольнику, первый прямоугольник содержит второе.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Получая минуту, середину и Макс. значения

CGRectGetMinX (_:) CGRectGetMinX

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

Объявление

Swift

func CGRectGetMinX(_ rect: CGRect) -> CGFloat

Objective C

CGFloat CGRectGetMinX ( CGRect rect );

Параметры

rect

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

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

Самое маленькое значение для x-координаты прямоугольника.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

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

Объявление

Swift

func CGRectGetMinY(_ rect: CGRect) -> CGFloat

Objective C

CGFloat CGRectGetMinY ( CGRect rect );

Параметры

rect

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

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

Самое маленькое значение для y-координаты прямоугольника.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

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

Объявление

Swift

func CGRectGetMidX(_ rect: CGRect) -> CGFloat

Objective C

CGFloat CGRectGetMidX ( CGRect rect );

Параметры

rect

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

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

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

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

Объявление

Swift

func CGRectGetMidY(_ rect: CGRect) -> CGFloat

Objective C

CGFloat CGRectGetMidY ( CGRect rect );

Параметры

rect

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

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

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

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

Объявление

Swift

func CGRectGetMaxX(_ rect: CGRect) -> CGFloat

Objective C

CGFloat CGRectGetMaxX ( CGRect rect );

Параметры

rect

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

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

Самое большое значение x-координаты для прямоугольника.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

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

Объявление

Swift

func CGRectGetMaxY(_ rect: CGRect) -> CGFloat

Objective C

CGFloat CGRectGetMaxY ( CGRect rect );

Параметры

rect

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

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

Самое большое значение для y-координаты прямоугольника.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Получение высоты и ширины

CGRectGetHeight (_:) CGRectGetHeight

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

Объявление

Swift

func CGRectGetHeight(_ rect: CGRect) -> CGFloat

Objective C

CGFloat CGRectGetHeight ( CGRect rect );

Параметры

rect

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

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

Высота указанного прямоугольника.

Обсуждение

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Возвращает ширину прямоугольника.

Объявление

Swift

func CGRectGetWidth(_ rect: CGRect) -> CGFloat

Objective C

CGFloat CGRectGetWidth ( CGRect rect );

Параметры

rect

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

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

Ширина указанного прямоугольника.

Обсуждение

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

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

CGRectIsEmpty (_:) CGRectIsEmpty

Возвраты, имеет ли прямоугольник нулевую ширину или высоту, или является нулевым прямоугольником.

Объявление

Swift

func CGRectIsEmpty(_ rect: CGRect) -> Bool

Objective C

bool CGRectIsEmpty ( CGRect rect );

Параметры

rect

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

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

true если указанный прямоугольник пуст; иначе, false.

Обсуждение

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

См. также

CGRectIsNull
CGRectIsNull (_:) CGRectIsNull

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

Объявление

Swift

func CGRectIsNull(_ rect: CGRect) -> Bool

Objective C

bool CGRectIsNull ( CGRect rect );

Параметры

rect

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

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

true если указанный прямоугольник является нулем; иначе, false.

Обсуждение

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

См. также

CGRectIsEmpty
CGRectIsInfinite (_:) CGRectIsInfinite

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

Объявление

Swift

func CGRectIsInfinite(_ rect: CGRect) -> Bool

Objective C

bool CGRectIsInfinite ( CGRect rect );

Параметры

rect

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

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

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

Обсуждение

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Типы данных

CGFloat CGFloat

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

Объявление

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

Objective C

@import CoreGraphics;

Доступность

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

Структура, содержащая точку в двумерной системе координат.

Объявление

Swift

struct CGPoint { var x: CGFloat var y: CGFloat }

Objective C

struct CGPoint { CGFloat x; CGFloat y; }; typedef struct CGPoint CGPoint;

Поля

x

X-координата точки.

y

Y-координата точки.

Доступность

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


      
      CGRect

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

Объявление

Swift

struct CGRect { var origin: CGPoint var size: CGSize }

Objective C

struct CGRect { CGPoint origin; CGSize size; }; typedef struct CGRect CGRect;

Поля

`origin`	Точка, указывающая координаты источника прямоугольника.
`size`	Размер, указывающий высоту и ширину прямоугольника.

Обсуждение

В Кварцевом координатном пространстве по умолчанию источник расположен в нижнем левом углу прямоугольника, и прямоугольник расширяется к верхнему правому углу. Если контекст имеет зеркально отраженное координатное пространство — часто случай на iOS — источник находится в верхнем левом углу, и прямоугольник расширяется к нижнему правому углу.

Доступность

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

CGSize

Структура, содержащая значения ширины и высоты.

Объявление

Swift

struct CGSize { var width: CGFloat var height: CGFloat }

Objective C

struct CGSize { CGFloat width; CGFloat height; }; typedef struct CGSize CGSize;

Поля

width

Значение ширины.

height

Значение высоты.

Обсуждение

A CGSize структура иногда используется для представления вектора расстояния, а не физического размера. Как вектор, его значения могут быть отрицательными. Нормализовать a CGRect структура так, чтобы ее размер был представлен положительными значениями, вызывает CGRectStandardize функция.

Доступность

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

Структура, содержащая двумерный вектор.

Объявление

Swift

struct CGVector { var dx: CGFloat var dy: CGFloat }

Objective C

struct CGVector { CGFloat dx; CGFloat dy; }; typedef struct CGVector CGVector;

Поля

dx

X-координата вектора.

dy

Y-координата вектора.

Доступность

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

Константы

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

Объявление

Swift

let CGRectInfinite: CGRect

Objective C

const CGRect CGRectInfinite;

Константы
- CGRectInfinite
  
  CGRectInfinite
  
  Прямоугольник, имеющий бесконечную степень.
  
  Доступный в OS X v10.4 и позже.
Геометрические нули
Нулевая точка, обнулите прямоугольник или нулевой размер.

Объявление

Swift

let CGPointZero: CGPoint let CGRectZero: CGRect let CGSizeZero: CGSize

Objective C

const CGPoint CGPointZero; const CGRect CGRectZero; const CGSize CGSizeZero;

Константы
- CGPointZero
  
  CGPointZero
  
  Точка, постоянная с расположением (0,0). Нулевая точка эквивалентна CGPointMake(0,0).
  
  Доступный в OS X v10.0 и позже.
- CGRectZero
  
  CGRectZero
  
  Прямоугольник, постоянный с расположением (0,0), и ширина и высота 0. Нулевой прямоугольник эквивалентен CGRectMake(0,0,0,0).
  
  Доступный в OS X v10.0 и позже.
- CGSizeZero
  
  CGSizeZero
  
  Размер, постоянный с шириной и высотой 0. Нулевой размер эквивалентен CGSizeMake(0,0).
  
  Доступный в OS X v10.0 и позже.
Геометрический нуль
Нулевой или пустой прямоугольник.

Объявление

Swift

let CGRectNull: CGRect

Objective C

const CGRect CGRectNull;

Константы
- CGRectNull
  
  CGRectNull
  
  Нулевой прямоугольник. Это - прямоугольник, возвращенный, например, при пересечении двух непересекающихся прямоугольников. Обратите внимание на то, что нулевой прямоугольник не является тем же как нулевым прямоугольником. Например, объединение прямоугольника с нулевым прямоугольником является исходным прямоугольником (т.е. нулевой прямоугольник ничего не вносит).
  
  Доступный в OS X v10.0 и позже.
CGRectEdge
Координаты, устанавливающие края прямоугольника.

Объявление

Swift

enum CGRectEdge : UInt32 { case MinXEdge case MinYEdge case MaxXEdge case MaxYEdge }

Objective C

enum CGRectEdge { CGRectMinXEdge, CGRectMinYEdge, CGRectMaxXEdge, CGRectMaxYEdge }; typedef enum CGRectEdge CGRectEdge;

Константы
- MinXEdge
  
  CGRectMinXEdge
  
  Минимальное значение для x-координаты прямоугольника. В OS X и iOS с системой координат по умолчанию это - левый край прямоугольника.
  
  Доступный в OS X v10.0 и позже.
- MinYEdge
  
  CGRectMinYEdge
  
  Минимальное значение для y-координаты прямоугольника. В OS X с системой координат по умолчанию это - базовый край прямоугольника. В iOS с системой координат по умолчанию это - главный край прямоугольника.
  
  Доступный в OS X v10.0 и позже.
- MaxXEdge
  
  CGRectMaxXEdge
  
  Максимальное значение для x-координаты прямоугольника. В OS X и iOS с системой координат по умолчанию это - правый край прямоугольника.
  
  Доступный в OS X v10.0 и позже.
- MaxYEdge
  
  CGRectMaxYEdge
  
  Максимальное значение для y-координаты прямоугольника. В OS X с системой координат по умолчанию это - главный край прямоугольника. В iOS с системой координат по умолчанию это - базовый край прямоугольника.
  
  Доступный в OS X v10.0 и позже.
Оператор импорта

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

Доступный в OS X v10.0 и позже.
CGFloat информационные макросы
Информационные макросы для CGFloat ввести.

Объявление

Swift

var CGFLOAT_MIN: Double { get } var CGFLOAT_MAX: Double { get } var CGFLOAT_IS_DOUBLE: Int32 { get }

Константы
- CGFLOAT_MIN
  
  CGFLOAT_MIN
  
  Минимальное неотрицательное несубнормальное значение оценивает за a CGFloat ввести. Для 32-разрядного кода это значение 1.17549435e-38F. Для 64-разрядного кода это 2.2250738585072014e-308.
  
  Доступный в OS X v10.5 и позже.
- CGFLOAT_MAX
  
  CGFLOAT_MAX
  
  Максимальное небесконечное значение для a CGFloat ввести. Для 32-разрядного кода это значение 3.40282347e+38F. Для 64-разрядного кода это 1.7976931348623157e+308.
  
  Доступный в OS X v10.5 и позже.
- CGFLOAT_IS_DOUBLE
  
  CGFLOAT_IS_DOUBLE
  
  Указывает ли CGFloat определяется как a float или double ввести.
  
  Доступный в OS X v10.5 и позже.

`width`	Значение ширины.
`height`	Значение высоты.

`x`	X-координата точки.
`y`	Y-координата точки.

`dx`	X-координата вектора.
`dy`	Y-координата вектора.