NSCursor
Экземпляры NSCursor класс управляет появлением курсора.
Следующая таблица показывает и описывает системные курсоры и указывает метод класса для получения их:
Курсор |
Описание |
|---|---|
|
Курсор стрелки ( |
|
Курсор I-луча для указания точек вставки ( |
|
Курсор перекрестия ( |
|
Курсор закрытой руки ( |
|
Открыто-ручной курсор ( |
|
Ручной указанием курсор ( |
|
Изменение размеры - оставило курсор ( |
|
Курсор изменять-размеры-права ( |
|
Изменение размеры левого и правого курсора ( |
|
Курсор изменения размеры ( |
|
Курсор изменения размеры вниз ( |
|
Изменение размеры вверх и вниз курсора ( |
|
Исчезающий курсор элемента ( |
|
Текстовый курсор I-луча для вертикального макета ( |
В версии 10.3 OS X и позже, размер курсора больше не ограничивается 16 на 16 пикселей.
Прямоугольники курсора
В Какао можно изменить в настоящее время выводимый на экран курсор на основе позиции мыши по одному из представлений. Вы могли бы использовать этот метод для обеспечения визуальной обратной связи о том, какие меры пользователь может принять с мышью. Например, Вы могли бы вывести на экран один из изменять размеры курсоров каждый раз, когда мышь отодвигается часть Вашего представления, действующего как пользовательский дескриптор изменения размеров. Для установки этого Вы связываете объект курсора с одним или более прямоугольниками курсора в представлении.
Прямоугольники курсора являются специализированным типом отслеживания прямоугольников, использующихся для контроля расположения мыши в представлении. Представления реализуют прямоугольные прямоугольники отслеживания использования курсора, но обеспечивают методы для установки и обновления прямоугольников курсора, которые отличны от универсального прямоугольного интерфейса отслеживания. Для получения информации о том, как установить прямоугольники курсора, посмотрите События Отслеживания мыши и Обновления курсора.
Балансирование сокрытия курсора и вывода на экран
Каждый вызов к hide курсор должен иметь соответствие unhide вызвать. Например,
[NSCursor hide];[NSCursor hide];….[NSCursor unhide];
Приведет к курсору, все еще скрытому потому что hide и unhide вызовы метода не сбалансированы. Вместо этого необходимо сбалансировать вызовы метода, такой как в следующем примере:
[NSCursor hide];[NSCursor hide];….[NSCursor unhide];[NSCursor unhide];
Существует соответствующий курсор hide и unhide вызовы, таким образом курсор станет видимым.
Соответствует
-
AnyObject -
CVarArgType -
Equatable -
Hashable -
NSCoding -
NSObjectProtocol -
Печатаемый -
Reflectable -
NSCoding -
NSObject
Оператор импорта
Swift
import AppKit
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
-
Инициализирует курсор с данным изображением и горячей точкой.
Объявление
Параметры
newImageИзображение для присвоения к курсору.
aPointТочка для установки как горячая точка курсора.
Возвращаемое значение
Инициализированный объект курсора.
Обсуждение
Этот метод является определяемым инициализатором для класса.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
init (image:foregroundColorHint:backgroundColorHint:hotSpot:) - initWithImage:foregroundColorHint:backgroundColorHint:hotSpot:Инициализирует курсор с указанным изображением и горячей точкой.
Объявление
Параметры
newImageИзображение для присвоения к курсору.
fgОсновной цвет. Это в настоящее время игнорируется.
bgЦвет фона. Это в настоящее время игнорируется.
hotSpotТочка для присвоения как горячая точка курсора.
Возвращаемое значение
Инициализированный объект курсора.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает изображение получателя.
Возвращаемое значение
Изображение курсора или
nilесли ни один не существуетОбсуждение
Обратите внимание на то, что
NSCursorобъект является неизменным: Вы не можете изменить его изображение после того, как это будет создаваться. Вместо этого используйтеinitWithImage:hotSpot:создать новый курсор с новыми настройками.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает позицию горячей точки курсора.
Возвращаемое значение
Точка, описывающая позицию горячей точки, указанной согласно зеркально отраженной системе координат курсора.
Обсуждение
Для более полного объяснения см. описание класса.
Обратите внимание на то, что
NSCursorобъект является неизменным: Вы не можете изменить его горячую точку после того, как это будет создаваться. Вместо этого используйтеinitWithImage:hotSpot:создать новый курсор с новыми настройками.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Делает текущий курсор невидимым.
Объявление
Swift
class func hide()Objective C
+ (void)hideОбсуждение
Если другой курсор станет текущим, то тот курсор будет невидим, также. Это останется невидимым, пока Вы не вызовете
unhideметод.Каждый вызов
hideдолжен быть сбалансирован вызовомunhideдля курсора, который будет выведен на экран.hideпереопределения методаsetHiddenUntilMouseMoves:.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Инвертирует более ранний вызов к
hideпутем показа текущего курсора.Объявление
Swift
class func unhide()Objective C
+ (void)unhideОбсуждение
Каждый вызов
unhideдолжен быть сбалансирован вызовомhideдля курсора выводят на экран, чтобы быть корректным.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Наборы, скрыт ли курсор до перемещений мыши.
Объявление
Swift
class func setHiddenUntilMouseMoves(_flag: Bool)Objective C
+ (void)setHiddenUntilMouseMoves:(BOOL)flagПараметры
flagYEStrueдля сокрытия курсора до, одно из следующего происходит:Перемещения мыши.
Вы вызываете метод снова, с
flagнабор кNOfalse.
Обсуждение
Не пытайтесь противостоять этому методу путем вызова
unhide. Результаты не определены.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Выталкивает текущий курсор от вершины штабеля.
Объявление
Swift
class func pop()Objective C
+ (void)popОбсуждение
Новый объект на вершине штабеля становится текущим курсором. Если текущий курсор является единственным курсором на штабеле, этот метод ничего не делает.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Отправляет a
popобменивайтесь сообщениями к классу получателя.Объявление
Swift
func pop()Objective C
- (void)popОператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Помещает получатель поверх штабеля курсора и делает его текущим курсором.
Объявление
Swift
func push()Objective C
- (void)pushОператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Делает получатель текущим курсором.
Объявление
Swift
func set()Objective C
- (void)setОператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Автоматически отправленный в получатель, когда курсор вводит прямоугольник курсора, принадлежавший получателю.
Объявление
Swift
func mouseEntered(_anEvent: NSEvent)Objective C
- (void)mouseEntered:(NSEvent *)anEventПараметры
anEventКогда курсор вводит прямоугольник курсора, событие генерировало.
Обсуждение
Если используется после
setOnMouseEntered:был вызван с параметромYEStrue,mouseEntered:может сделать получатель текущим курсором.В Ваших программах Вы не вызовете
mouseEntered:явно. Это только включено в интерфейс класса, таким образом, можно переопределить его.Для более полного объяснения посмотрите События Отслеживания мыши и Обновления курсора и
NSViewметодaddTrackingRect:owner:userData:assumeInside:.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Указывает, принимает ли получатель mouseEntered: события.
Объявление
Swift
func setOnMouseEntered(_flag: Bool)Objective C
- (void)setOnMouseEntered:(BOOL)flagПараметры
flagYEStrueесли получатель принимает будущееmouseEntered:сообщения о событиях; иначе это игнорирует их.Обсуждение
Принятие
mouseEntered:когда курсор вводит прямоугольник курсора представления, сообщения о событиях позволяют курсору быть сделанным текущим курсором.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
isSetOnMouseEntered - isSetOnMouseEnteredДоступный в OS X v10.0 через OS X v10.9Возвращает булево значение, указывающее, становится ли получатель текущим при получении a
mouseEntered:сообщение.Объявление
Objective C
- (BOOL)isSetOnMouseEnteredВозвращаемое значение
YEStrueесли получатель станет текущим, когда он получит amouseEntered:сообщение; иначе,NOfalse.Обсуждение
Для получения такого сообщения получатель должен сначала быть присвоен прямоугольник курсора. Это присвоение может быть сделано с помощью
NSViewметодaddCursorRect:cursor:. Для более полного объяснения см. описание класса.Оператор импорта
Objective C
@import AppKit;Доступность
Доступный в OS X v10.0 через OS X v10.9.
См. также
-
Автоматически отправленный в получатель, когда курсор выходит из прямоугольника курсора, принадлежавшего получателю.
Объявление
Swift
func mouseExited(_anEvent: NSEvent)Objective C
- (void)mouseExited:(NSEvent *)anEventПараметры
anEventКогда курсор выходит из прямоугольника курсора, событие генерировало.
Обсуждение
Как
mouseEntered:, это сообщение является частью интерфейса класса только, таким образом, можно переопределить его.Для более полного объяснения посмотрите События Отслеживания мыши и Обновления курсора и метод NSView
addTrackingRect:owner:userData:assumeInside:.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Наборы, принимает ли получатель
mouseExited:события.Объявление
Swift
func setOnMouseExited(_flag: Bool)Objective C
- (void)setOnMouseExited:(BOOL)flagПараметры
flagYEStrueесли получатель принимает будущееmouseExited:сообщения о событиях; иначе это игнорирует их.Обсуждение
Принятие
mouseExited:когда курсор выходит из прямоугольника курсора представления, сообщения о событиях позволяют курсору быть сделанным текущим курсором.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
isSetOnMouseExited - isSetOnMouseExitedДоступный в OS X v10.0 через OS X v10.9Возвращает булево значение, указывающее, становится ли получатель текущим, когда он получает a
mouseExited:сообщение.Объявление
Objective C
- (BOOL)isSetOnMouseExitedВозвращаемое значение
YEStrueесли получатель становится текущим, когда он получает amouseExited:сообщение; иначе,NOfalse.Обсуждение
Для получения такого сообщения получатель должен сначала быть присвоен прямоугольник курсора. Это присвоение может быть сделано с помощью
NSViewметодaddCursorRect:cursor:. Для более полного объяснения см. описание класса.Оператор импорта
Objective C
@import AppKit;Доступность
Доступный в OS X v10.0 через OS X v10.9.
См. также
-
Возвращает текущий курсор приложения.
Возвращаемое значение
Главный курсор на штабеле курсора приложения. Если различное приложение в настоящее время активно, этот курсор может не быть видимым курсором на экране.
Обсуждение
Метод только возвращает курсор, установленный Вашим использованием приложения
NSCursorметоды. Это возвращает не курсоры, установленные другими приложениями или курсорами, установленными Вашим приложением с помощью Углерода API.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Возвращает курсор существующей системы.
Объявление
Swift
class func currentSystemCursor() -> NSCursor?Objective C
+ (NSCursor *)currentSystemCursorВозвращаемое значение
Курсор, изображение которого и горячая точка соответствуют те из выведенного на экран в настоящее время курсора в системе
Обсуждение
Этот метод возвращает курсор существующей системы, независимо от которого приложение установило курсор, и или Какао или Углерод, APIs использовался для установки его.
Этот метод заменяет теперь осуждаемый
QDGetCursorDataфункция.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.6 и позже.
-
Возвращает курсор по умолчанию, курсор стрелки.
Возвращаемое значение
Курсор по умолчанию, наклонная стрелка с ее горячей точкой в подсказке. Курсор стрелки является тем, который Вы привыкли видеть по кнопкам, скроллерам и многим другим объектам в оконной системе.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Возвращает системный курсор контекстного меню.
Объявление
Swift
class func contextualMenuCursor() -> NSCursorObjective C
+ (NSCursor *)contextualMenuCursorВозвращаемое значение
Курсор контекстного меню
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.6 и позже.
-
Возвращает системный курсор закрытой руки.
Объявление
Swift
class func closedHandCursor() -> NSCursorObjective C
+ (NSCursor *)closedHandCursorВозвращаемое значение
Курсор закрытой руки.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.3 и позже.
-
Возвращает системный курсор перекрестия.
Возвращаемое значение
Курсор перекрестия. Этот курсор используется для ситуаций, когда точное расположение требуется (где крест строк является горячей точкой).
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.3 и позже.
-
Возвращает курсор, указывающий, что текущая работа приведет к исчезающему элементу.
Объявление
Swift
class func disappearingItemCursor() -> NSCursorObjective C
+ (NSCursor *)disappearingItemCursorВозвращаемое значение
Системный курсор, указывающий, что текущая работа приведет к исчезающему элементу (например, при перетаскивании элемента от прикрепления или панели инструментов).
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.3 и позже.
-
Возвращает курсор, указывающий, что текущая работа приведет к действию копии.
Возвращаемое значение
Курсор копии перетаскивания.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.6 и позже.
-
Возвращает курсор, указывающий, что текущая работа приведет к действию ссылки.
Возвращаемое значение
Курсор ссылки перетаскивания.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.6 и позже.
-
Возвращает курсор, который похож на капитал I с крошечной поперечной балкой в ее середину.
Возвращаемое значение
Курсор I-луча. Это - курсор, который Вы привыкли видеть по доступному для редактирования или выбираемому тексту. Горячая точка курсора I-луча по умолчанию - то, где поперечная балка пересекает меня.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает открыто-ручной системный курсор.
Возвращаемое значение
Открыто-ручной курсор.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.3 и позже.
-
Возвращает работу, не позволенную курсор.
Объявление
Swift
class func operationNotAllowedCursor() -> NSCursorObjective C
+ (NSCursor *)operationNotAllowedCursorВозвращаемое значение
Работа, не позволенная курсор.
Обсуждение
Этот курсор указывает, что отклоняется работа, пробующаяся, возможно перетаскивая к элементу, который не может принять тип перетаскивания.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.5 и позже.
-
Возвращает ручной указанием системный курсор.
Объявление
Swift
class func pointingHandCursor() -> NSCursorObjective C
+ (NSCursor *)pointingHandCursorВозвращаемое значение
Ручной указанием курсор. Подсказка указывающего пальца является горячей точкой.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.3 и позже.
-
Возвращает системный курсор изменения размеры вниз.
Объявление
Swift
class func resizeDownCursor() -> NSCursorObjective C
+ (NSCursor *)resizeDownCursorВозвращаемое значение
Курсор изменения размеры вниз. Этот курсор используется при перемещении или изменении размеров объекта указать, что пользователь может переместиться только в обозначенное направление.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.3 и позже.
-
Возвращает изменение размеры - оставленный системный курсор.
Объявление
Swift
class func resizeLeftCursor() -> NSCursorObjective C
+ (NSCursor *)resizeLeftCursorВозвращаемое значение
Изменение размеры - оставило курсор. Этот курсор используется при перемещении или изменении размеров объекта указать, что пользователь может переместиться только в обозначенное направление.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.3 и позже.
-
Возвращает изменение размеры левого и правого системного курсора.
Объявление
Swift
class func resizeLeftRightCursor() -> NSCursorObjective C
+ (NSCursor *)resizeLeftRightCursorВозвращаемое значение
Изменение размеры левого и правого курсора. Этот курсор используется при перемещении или изменении размеров объекта, и объект может быть перемещен левый или правый.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.3 и позже.
-
Возвращает системный курсор изменять-размеры-права.
Объявление
Swift
class func resizeRightCursor() -> NSCursorObjective C
+ (NSCursor *)resizeRightCursorВозвращаемое значение
Курсор изменять-размеры-права. Этот курсор используется при перемещении или изменении размеров объекта указать, что пользователь может переместиться только в обозначенное направление.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.3 и позже.
-
Возвращает системный курсор изменения размеры.
Возвращаемое значение
Курсор изменения размеры. Этот курсор используется при перемещении или изменении размеров объекта указать, что пользователь может переместиться только в обозначенное направление.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.3 и позже.
-
Возвращает изменение размеры вверх и вниз системного курсора.
Объявление
Swift
class func resizeUpDownCursor() -> NSCursorObjective C
+ (NSCursor *)resizeUpDownCursorВозвращаемое значение
Изменение размеры вверх и вниз курсора. Этот курсор используется при перемещении или изменении размеров объекта, и объект может быть повышен или вниз.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.3 и позже.
-
Возвращает курсор для редактирования текста вертикального макета.
Объявление
Swift
class func IBeamCursorForVerticalLayout() -> NSCursorObjective C
+ (NSCursor *)IBeamCursorForVerticalLayoutВозвращаемое значение
Текстовый курсор вертикального макета. Этот курсор используется при редактировании текста вертикального макета.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.7 и позже.
-
Версия платформы AppKit, содержащей определенное исправление ошибки.
Объявление
Swift
var NSAppKitVersionNumberWithCursorSizeSupport: Double { get }Objective C
#define NSAppKitVersionNumberWithCursorSizeSupport 682.0Константы
-
NSAppKitVersionNumberWithCursorSizeSupportNSAppKitVersionNumberWithCursorSizeSupportОпределенная версия платформы AppKit, представившей поддержку курсоров, больше, чем 16 x 16 пикселей в размере. Разработчики не должны должны быть использовать эту константу, если они не пишут приложения для OS X v10.2 и ранее.
Доступный в OS X v10.3 и позже.
-
