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
Параметры
flag
YES
true
для сокрытия курсора до, одно из следующего происходит:Перемещения мыши.
Вы вызываете метод снова, с
flag
набор кNO
false
.
Обсуждение
Не пытайтесь противостоять этому методу путем вызова
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:
был вызван с параметромYES
true
,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
Параметры
flag
YES
true
если получатель принимает будущее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
Возвращаемое значение
YES
true
если получатель станет текущим, когда он получит amouseEntered:
сообщение; иначе,NO
false
.Обсуждение
Для получения такого сообщения получатель должен сначала быть присвоен прямоугольник курсора. Это присвоение может быть сделано с помощью
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
Параметры
flag
YES
true
если получатель принимает будущее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
Возвращаемое значение
YES
true
если получатель становится текущим, когда он получает amouseExited:
сообщение; иначе,NO
false
.Обсуждение
Для получения такого сообщения получатель должен сначала быть присвоен прямоугольник курсора. Это присвоение может быть сделано с помощью
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() -> NSCursor
Objective C
+ (NSCursor *)contextualMenuCursor
Возвращаемое значение
Курсор контекстного меню
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
Возвращает системный курсор закрытой руки.
Объявление
Swift
class func closedHandCursor() -> NSCursor
Objective 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() -> NSCursor
Objective 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() -> NSCursor
Objective C
+ (NSCursor *)operationNotAllowedCursor
Возвращаемое значение
Работа, не позволенная курсор.
Обсуждение
Этот курсор указывает, что отклоняется работа, пробующаяся, возможно перетаскивая к элементу, который не может принять тип перетаскивания.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
-
Возвращает ручной указанием системный курсор.
Объявление
Swift
class func pointingHandCursor() -> NSCursor
Objective C
+ (NSCursor *)pointingHandCursor
Возвращаемое значение
Ручной указанием курсор. Подсказка указывающего пальца является горячей точкой.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Возвращает системный курсор изменения размеры вниз.
Объявление
Swift
class func resizeDownCursor() -> NSCursor
Objective C
+ (NSCursor *)resizeDownCursor
Возвращаемое значение
Курсор изменения размеры вниз. Этот курсор используется при перемещении или изменении размеров объекта указать, что пользователь может переместиться только в обозначенное направление.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Возвращает изменение размеры - оставленный системный курсор.
Объявление
Swift
class func resizeLeftCursor() -> NSCursor
Objective C
+ (NSCursor *)resizeLeftCursor
Возвращаемое значение
Изменение размеры - оставило курсор. Этот курсор используется при перемещении или изменении размеров объекта указать, что пользователь может переместиться только в обозначенное направление.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Возвращает изменение размеры левого и правого системного курсора.
Объявление
Swift
class func resizeLeftRightCursor() -> NSCursor
Objective C
+ (NSCursor *)resizeLeftRightCursor
Возвращаемое значение
Изменение размеры левого и правого курсора. Этот курсор используется при перемещении или изменении размеров объекта, и объект может быть перемещен левый или правый.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Возвращает системный курсор изменять-размеры-права.
Объявление
Swift
class func resizeRightCursor() -> NSCursor
Objective 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() -> NSCursor
Objective C
+ (NSCursor *)resizeUpDownCursor
Возвращаемое значение
Изменение размеры вверх и вниз курсора. Этот курсор используется при перемещении или изменении размеров объекта, и объект может быть повышен или вниз.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Возвращает курсор для редактирования текста вертикального макета.
Объявление
Swift
class func IBeamCursorForVerticalLayout() -> NSCursor
Objective 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
Константы
-
NSAppKitVersionNumberWithCursorSizeSupport
NSAppKitVersionNumberWithCursorSizeSupport
Определенная версия платформы AppKit, представившей поддержку курсоров, больше, чем 16 x 16 пикселей в размере. Разработчики не должны должны быть использовать эту константу, если они не пишут приложения для OS X v10.2 и ранее.
Доступный в OS X v10.3 и позже.
-