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

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

Разработчик

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

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

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

NSDraggingSource

NSDraggingSource протокол объявляет методы, реализованные исходным объектом в сеансе перетаскивания.

В OS X v10.7 и позже NSDraggingSource теперь формальный протокол и имеет обновленный интерфейс. OS X v10.6 поведение был сохранен, но будет отброшен в будущей версии операционной системы. Методы, которые должны быть осуждены, отмечены как таковые.

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

Не применимый

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Перетаскивание работы сеанса
  • draggingSession (_: sourceOperationMaskForDraggingContext:) - draggingSession:sourceOperationMaskForDraggingContext: Требуемый

    Объявляет типы операций, источник позволяет выполняться. (требуемый)

    Объявление

    Swift

    func draggingSession(_ session: NSDraggingSession, sourceOperationMaskForDraggingContext context: NSDraggingContext) -> NSDragOperation

    Objective C

    - (NSDragOperation)draggingSession:(NSDraggingSession *)session sourceOperationMaskForDraggingContext:(NSDraggingContext)context

    Параметры

    session

    Сеанс перетаскивания.

    context

    Контекст перетаскивания. Посмотрите NSDraggingContext для поддерживаемых значений.

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

    Надлежащая работа перетаскивания, как определено в

    Обсуждение

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

    • switch(context) {
    • case NSDraggingContextOutsideApplication:
    • return ...
    • break;
    • case NSDraggingContextWithinApplication:
    • default:
    • return ...
    • break;
    • }

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Перетаскивание расположений сеанса
  • draggingSession (_: endedAtPoint:operation:) - draggingSession:endedAtPoint:operation:

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

    Объявление

    Swift

    optional func draggingSession(_ session: NSDraggingSession, endedAtPoint screenPoint: NSPoint, operation operation: NSDragOperation)

    Objective C

    - (void)draggingSession:(NSDraggingSession *)session endedAtPoint:(NSPoint)screenPoint operation:(NSDragOperation)operation

    Параметры

    session

    Сеанс перетаскивания.

    screenPoint

    Точка, где перетаскивание закончилось в координатах экрана.

    operation

    Работа перетаскивания. Посмотрите NSDragOperation для типов работы перетаскивания.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • draggingSession (_: movedToPoint:) - draggingSession:movedToPoint:

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

    Объявление

    Swift

    optional func draggingSession(_ session: NSDraggingSession, movedToPoint screenPoint: NSPoint)

    Objective C

    - (void)draggingSession:(NSDraggingSession *)session movedToPoint:(NSPoint)screenPoint

    Параметры

    session

    Сеанс перетаскивания.

    screenPoint

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • draggingSession (_: willBeginAtPoint:) - draggingSession:willBeginAtPoint:

    Вызванный, когда начнется перетаскивание.

    Объявление

    Swift

    optional func draggingSession(_ session: NSDraggingSession, willBeginAtPoint screenPoint: NSPoint)

    Objective C

    - (void)draggingSession:(NSDraggingSession *)session willBeginAtPoint:(NSPoint)screenPoint

    Параметры

    session

    Сеанс перетаскивания.

    screenPoint

    Точка, где перетаскивание начнется в координатах экрана.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Перетаскивание модифицирующих клавиш сеанса
  • ignoreModifierKeysForDraggingSession (_:) - ignoreModifierKeysForDraggingSession:

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

    Объявление

    Swift

    optional func ignoreModifierKeysForDraggingSession(_ session: NSDraggingSession) -> Bool

    Objective C

    - (BOOL)ignoreModifierKeysForDraggingSession:(NSDraggingSession *)session

    Параметры

    session

    Сеанс перетаскивания.

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

    YEStrue если модифицирующие клавиши будут проигнорированы, NOfalse иначе.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Перетаскивание опций
  • draggingSourceOperationMaskForLocal: - draggingSourceOperationMaskForLocal: (OS X v10.7)

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

    Оператор осуждения

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

    Объявление

    Objective C

    - (NSDragOperation)draggingSourceOperationMaskForLocal:(BOOL)isLocal

    Параметры

    isLocal

    YEStrue указывает, что целевой объект кандидата (окно или представление, по которому перетащенное изображение в настоящее время сбалансировано) находится в том же приложении как источник, в то время как a NOfalse значение указывает, что целевой объект находится в различном приложении.

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

    Маска, создаваемая путем объединения операций перетаскивания, перечисленных в NSDragOperation раздел NSDraggingInfo ссылка на протокол с помощью оператора битового «ИЛИ» C. Если источник не разрешает операций перетаскивания, он должен возвратиться NSDragOperationNone.

    Обсуждение

    Если не реализованный, значение по умолчанию NSDragOperationCopy | NSDragOperationLink | NSDragOperationGeneric | NSDragOperationPrivate.

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

    Objective C

    @import AppKit;

    Доступность

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

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

  • namesOfPromisedFilesDroppedAtDestination (_:) - namesOfPromisedFilesDroppedAtDestination: (OS X v10.7)

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

    Объявление

    Swift

    func namesOfPromisedFilesDroppedAtDestination(_ dropDestination: NSURL) -> [AnyObject]?

    Objective C

    - (NSArray *)namesOfPromisedFilesDroppedAtDestination:(NSURL *)dropDestination

    Параметры

    dropDestination

    Объект URL, идентифицирующий расположение, в котором будут создаваться обещанные файлы.

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

    Массив имен файлов (не полные пути), в котором получатель обещает создать dropDestination.

    Обсуждение

    Этот метод вызывается, когда отбрасывание было принято местом назначения, и место назначения, в случае другого приложения Какао, вызывает метод NSDraggingInfo namesOfPromisedFilesDroppedAtDestination:. Для длинных операций можно кэшироваться dropDestination и задержите создание файлов до draggedImage:endedAt:operation: метод, чтобы избежать блокировать целевое приложение.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

  • ignoreModifierKeysWhileDragging - ignoreModifierKeysWhileDragging (OS X v10.7)

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

    Оператор осуждения

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

    Объявление

    Objective C

    - (BOOL)ignoreModifierKeysWhileDragging

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

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

    Обсуждение

    Если этот метод не реализован, поведение по умолчанию эквивалентно возврату NOfalse

    Опция перетаскивания, соответствующая модифицирующей клавише, объединена с маской источника (как установлено с draggingSourceOperationMaskForLocal: метод) использование оператора битового «ИЛИ» C. См. описание для draggingSourceOperationMask метод в NSDraggingInfo спецификация протокола для получения дополнительной информации о перетаскивании масок и модифицирующих клавиш.

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

    Objective C

    @import AppKit;

    Доступность

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

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

Ответ на сообщения во время сеанса перетаскивания
  • draggedImage:beganAt: - draggedImage:beganAt: (OS X v10.7)

    Дает исходному объекту возможность реагировать на инициирование сеанса перетаскивания.

    Оператор осуждения

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

    Объявление

    Objective C

    - (void)draggedImage:(NSImage *)anImage beganAt:(NSPoint)aPoint

    Параметры

    anImage

    Изображение перетащенного элемента.

    aPoint

    Источник изображения в координатах экрана.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Доступность

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

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

    См. также

    convertScreenToBase: (NSWindow)
    convertBaseToScreen: (NSWindow)
    convertPoint:fromView: (NSView)
    convertPoint:toView: (NSView)

  • draggedImage:movedTo: - draggedImage:movedTo: (OS X v10.7)

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

    Оператор осуждения

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

    Объявление

    Objective C

    - (void)draggedImage:(NSImage *)draggedImage movedTo:(NSPoint)screenPoint

    Параметры

    draggedImage

    Перетащенное изображение.

    screenPoint

    Точка, указывающая новое расположение изображения в координатах экрана.

    Обсуждение

    Это сообщение подобно отправляемому месту назначения перетаскивания draggingUpdated: сообщения.

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

    Objective C

    @import AppKit;

    Доступность

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

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

  • draggedImage:endedAt:deposited: - draggedImage:endedAt:deposited: (OS X v10.1)

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

    Оператор осуждения

    Использовать draggedImage:endedAt:operation: вместо этого.

    Объявление

    Objective C

    - (void)draggedImage:(NSImage *)image endedAt:(NSPoint)screenPoint deposited:(BOOL)flag

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

    Objective C

    @import AppKit;

    Доступность

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

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

  • draggedImage:endedAt:operation: - draggedImage:endedAt:operation: (OS X v10.7)

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

    Оператор осуждения

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

    Объявление

    Objective C

    - (void)draggedImage:(NSImage *)anImage endedAt:(NSPoint)aPoint operation:(NSDragOperation)operation

    Параметры

    anImage

    Перетащенное изображение.

    aPoint

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

    operation

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

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Доступность

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

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