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

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

Разработчик

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

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

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

NSCollectionViewDelegate

NSCollectionViewDelegate протокол определяет дополнительные методы, реализованные делегатами NSCollectionView объекты.

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

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

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

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Поддержка перетаскивания
  • collectionView (_: canDragItemsAtIndexes:withEvent:) - collectionView:canDragItemsAtIndexes:withEvent:

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

    Объявление

    Swift

    optional func collectionView(_ collectionView: NSCollectionView, canDragItemsAtIndexes indexes: NSIndexSet, withEvent event: NSEvent) -> Bool

    Objective C

    - (BOOL)collectionView:(NSCollectionView *)collectionView canDragItemsAtIndexes:(NSIndexSet *)indexes withEvent:(NSEvent *)event

    Параметры

    collectionView

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

    indexes

    Индексы предложенных элементов перетаскивания.

    event

    Мышь вниз событие, инициировавшее перетаскивание.

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

    YEStrue если элементы могут попытаться инициировать перетаскивание для указанных элементов, иначе NOfalse.

    Обсуждение

    Если делегат не реализует этот метод, то представление набора будет действовать, как будто это возвратилось YEStrue.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • collectionView (_: validateDrop:proposedIndex:dropOperation:) - collectionView:validateDrop:proposedIndex:dropOperation:

    Вызванный для определения допустимой цели отбрасывания.

    Объявление

    Swift

    optional func collectionView(_ collectionView: NSCollectionView, validateDrop draggingInfo: NSDraggingInfo, proposedIndex proposedDropIndex: UnsafeMutablePointer<Int>, dropOperation proposedDropOperation: UnsafeMutablePointer<NSCollectionViewDropOperation>) -> NSDragOperation

    Objective C

    - (NSDragOperation)collectionView:(NSCollectionView *)collectionView validateDrop:(id<NSDraggingInfo>)draggingInfo proposedIndex:(NSInteger *)proposedDropIndex dropOperation:(NSCollectionViewDropOperation *)proposedDropOperation

    Параметры

    collectionView

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

    draggingInfo

    Объект, содержащий подробные данные об этой работе перетаскивания.

    proposedDropIndex

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

    proposedDropOperation

    Предложенная работа отбрасывания. Этот параметр передается ссылкой и может быть изменен для изменения работы отбрасывания.

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

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

    Обсуждение

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

    Представление набора сделает предложение NSCollectionViewDropOn когда расположение перетаскивания ближе к середине элемента, чем любой из его краев. Иначе, это сделает предложение NSCollectionViewDropBefore. Можно переопределить это поведение по умолчанию путем изменения proposedDropOperation или proposedDropIndex.

    Для получения перетаскивают сообщения, необходимо сначала отправить registerForDraggedTypes: к представлению набора с типами перетаскивания Вы хотите поддерживать.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • collectionView (_: acceptDrop:index:dropOperation:) - collectionView:acceptDrop:index:dropOperation:

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

    Объявление

    Swift

    optional func collectionView(_ collectionView: NSCollectionView, acceptDrop draggingInfo: NSDraggingInfo, index index: Int, dropOperation dropOperation: NSCollectionViewDropOperation) -> Bool

    Objective C

    - (BOOL)collectionView:(NSCollectionView *)collectionView acceptDrop:(id<NSDraggingInfo>)draggingInfo index:(NSInteger)index dropOperation:(NSCollectionViewDropOperation)dropOperation

    Параметры

    collectionView

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

    draggingInfo

    Объект, содержащий больше информации об этой работе перетаскивания.

    index

    Индекс предложенного элемента отбрасывания.

    dropOperation

    Тип перетаскивания работы.

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

    YEStrue если работа отбрасывания должна быть принята, иначе NOfalse.

    Обсуждение

    Этот метод вызывают, когда мышь выпущена по представлению набора, ранее удалившему лед для разрешения отбрасывания через collectionView:validateDrop:proposedIndex:dropOperation: метод. В это время делегат должен включить данные от области монтажа перетаскивания и обновить содержание представления набора.

    Необходимо реализовать этот метод для представления набора, чтобы быть местом назначения перетаскивания

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • collectionView (_: draggingImageForItemsAtIndexes:withEvent:offset:) - collectionView:draggingImageForItemsAtIndexes:withEvent:offset:

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

    Объявление

    Swift

    optional func collectionView(_ collectionView: NSCollectionView, draggingImageForItemsAtIndexes indexes: NSIndexSet!, withEvent event: NSEvent!, offset dragImageOffset: NSPointPointer) -> NSImage!

    Objective C

    - (NSImage *)collectionView:(NSCollectionView *)collectionView draggingImageForItemsAtIndexes:(NSIndexSet *)indexes withEvent:(NSEvent *)event offset:(NSPointPointer)dragImageOffset

    Параметры

    collectionView

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

    indexes

    Индексы элементов перетаскивания.

    event

    Мышь вниз событие, инициировавшее перетаскивание.

    dragImageOffset

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

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

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

    Обсуждение

    Если делегат не реализует этот метод, представление набора с возвратом использование изображения draggingImageForItemsAtIndexes:withEvent:offset:. Вы можете безопасно вызванный draggingImageForItemsAtIndexes:withEvent:offset: на collectionView из этого метода.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • collectionView (_: namesOfPromisedFilesDroppedAtDestination:forDraggedItemsAtIndexes:) - collectionView:namesOfPromisedFilesDroppedAtDestination:forDraggedItemsAtIndexes:

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

    Объявление

    Swift

    optional func collectionView(_ collectionView: NSCollectionView, namesOfPromisedFilesDroppedAtDestination dropURL: NSURL!, forDraggedItemsAtIndexes indexes: NSIndexSet!) -> [AnyObject]!

    Objective C

    - (NSArray *)collectionView:(NSCollectionView *)collectionView namesOfPromisedFilesDroppedAtDestination:(NSURL *)dropURL forDraggedItemsAtIndexes:(NSIndexSet *)indexes

    Параметры

    collectionView

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

    dropURL

    Расположение отбрасывания, где создаются файлы.

    indexes

    Индексы элементов перетаскивания.

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

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

    Обсуждение

    Делегат может файл поддержки обещать перетащить путем добавления NSFilesPromisePboardType к области монтажа в collectionView:writeItemsAtIndexes:toPasteboard:.

    Для получения дополнительной информации о файле обещайте перетащить, см. документацию для NSDraggingSource протокол и namesOfPromisedFilesDroppedAtDestination:.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • collectionView (_: writeItemsAtIndexes:toPasteboard:) - collectionView:writeItemsAtIndexes:toPasteboard:

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

    Объявление

    Swift

    optional func collectionView(_ collectionView: NSCollectionView, writeItemsAtIndexes indexes: NSIndexSet, toPasteboard pasteboard: NSPasteboard) -> Bool

    Objective C

    - (BOOL)collectionView:(NSCollectionView *)collectionView writeItemsAtIndexes:(NSIndexSet *)indexes toPasteboard:(NSPasteboard *)pasteboard

    Параметры

    collectionView

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

    indexes

    Индексы элементов для записи в область монтажа.

    pasteboard

    Область монтажа, содержащая содержание от перетащенных элементов.

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

    YEStrue начать перетаскивание, иначе NOfalse.

    Обсуждение

    Для запуска перетаскивания необходимо сначала объявить типы области монтажа, поддерживающиеся путем отправки pasteboard a declareTypes:owner: метод. Вы тогда помещаете данные для элементов в указанных индексах на pasteboard, и возвратитесь YEStrue от метода.

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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