NSSharingServiceDelegate

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

Посмотрите Ссылку класса NSSharingService для получения дополнительной информации.

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

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

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

NSObjectProtocol
NSObject

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Настройка анимации перехода


    
    sharingService (_: sourceFrameOnScreenForShareItem:)
    - sharingService:sourceFrameOnScreenForShareItem:

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

Объявление

Swift

optional func sharingService(_ sharingService: NSSharingService, sourceFrameOnScreenForShareItem item: NSPasteboardWriting) -> NSRect

Objective C

- (NSRect)sharingService:(NSSharingService *)sharingService sourceFrameOnScreenForShareItem:(id<NSPasteboardWriting>)item

Параметры

`sharingService`	Служба совместного использования.
`item`	Совместно используемый элемент.

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

Прямоугольник, в координатах экрана, для отображения перехода.

Обсуждение

Следующее является реализацией в качестве примера этого метода:

      - (NSRect)sharingService:(NSSharingService *)sharingService sourceFrameOnScreenForShareItem:(id <NSPasteboardWriting>)item
{
    if ([item isKindOfClass:[NSImage class]]) {
        NSImage * image = [_imageView image];
        NSRect frame = [_imageView bounds];
        frame = [_imageView convertRect:frame toView:nil];
        frame.origin = [[_imageView window] convertBaseToScreen:frame.origin];
        return frame;
    }
    return NSZeroRect;
}


  

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    sharingService (_: transitionImageForShareItem:contentRect:)
    - sharingService:transitionImageForShareItem:contentRect:

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

Объявление

Swift

optional func sharingService(_ sharingService: NSSharingService, transitionImageForShareItem item: NSPasteboardWriting, contentRect contentRect: UnsafeMutablePointer<NSRect>) -> NSImage?

Objective C

- (NSImage *)sharingService:(NSSharingService *)sharingService transitionImageForShareItem:(id<NSPasteboardWriting>)item contentRect:(NSRect *)contentRect

Параметры

`sharingService`	Служба совместного использования.
`item`	Совместно используемый элемент.
`contentRect`	Прямоугольник содержания является кадром фактического содержания в изображении перехода, исключая все художественные оформления. Например, если бы изображение перехода является миниатюрой QuickLook, значение было бы `QLThumbnailGetContentRect`.

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

Изображение для отображения для перехода совместного использования. Его размер должен точно соответствовать размер исходного изображения.

Обсуждение

Демонстрационная реализация этого метода:

      - (NSImage *)sharingService:(NSSharingService *)sharingService
             transitionImageForShareItem:(id <NSPasteboardWriting>)item
             contentRect:(NSRect *)contentRect
{
    if ([item isKindOfClass:[NSImage class]]) {
        return [_imageView image];
    }
}


  

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    sharingService (_: sourceWindowForShareItems:sharingContentScope:)
    - sharingService:sourceWindowForShareItems:sharingContentScope:

Возвращает окно, содержавшее элементы доли.

Объявление

Swift

optional func sharingService(_ sharingService: NSSharingService, sourceWindowForShareItems items: [AnyObject], sharingContentScope sharingContentScope: UnsafeMutablePointer<NSSharingContentScope>) -> NSWindow?

Objective C

- (NSWindow *)sharingService:(NSSharingService *)sharingService sourceWindowForShareItems:(NSArray *)items sharingContentScope:(NSSharingContentScope *)sharingContentScope

Параметры

`sharingService`	Служба совместного использования.
`items`	Совместно используемые элементы.
`sharingContentScope`	Объем содержания совместного использования. Объем совместного использования может быть изменен от значения по умолчанию `NSSharingContentScopeItem` путем установки различного значения в параметре `sharingContentScope`. Посмотрите NSSharingContentScope для поддерживаемых значений.

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

Окно совместно используемых элементов.

Обсуждение

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

      - (NSWindow *)sharingService:(NSSharingService *)sharingService
              sourceWindowForShareItems:(NSArray *)items
              sharingContentScope:(NSSharingContentScope *)sharingContentScope
{
    *sharingContentScope = NSSharingContentScopeItem;
    return [_imageView window];
}


  

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Совместное использование элементов


    
    sharingService (_: willShareItems:)
    - sharingService:willShareItems:

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

Объявление

Swift

optional func sharingService(_ sharingService: NSSharingService, willShareItems items: [AnyObject])

Objective C

- (void)sharingService:(NSSharingService *)sharingService willShareItems:(NSArray *)items

Параметры

`sharingService`	Служба совместного использования.
`items`	Совместно используемые элементы.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– sharingService:willShareItems:
– sharingService:didShareItems:
– sharingService:didFailToShareItems:error:


    
    sharingService (_: didShareItems:)
    - sharingService:didShareItems:

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

Объявление

Swift

optional func sharingService(_ sharingService: NSSharingService, didShareItems items: [AnyObject])

Objective C

- (void)sharingService:(NSSharingService *)sharingService didShareItems:(NSArray *)items

Параметры

`sharingService`	Служба совместного использования.
`items`	Совместно используемые элементы.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– sharingService:willShareItems:
– sharingService:didShareItems:
– sharingService:didFailToShareItems:error:


    
    sharingService (_: didFailToShareItems:error:)
    - sharingService:didFailToShareItems:error:

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

Объявление

Swift

optional func sharingService(_ sharingService: NSSharingService, didFailToShareItems items: [AnyObject], error error: NSError)

Objective C

- (void)sharingService:(NSSharingService *)sharingService didFailToShareItems:(NSArray *)items error:(NSError *)error

Параметры

`sharingService`	Служба совместного использования.
`items`	Совместно используемые элементы.
`error`	Ошибка, с которой встретились при попытке совместно использовать элемент. Если ошибка `NSUserCancelledError`, пользователь просто отменил ошибку.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– sharingService:willShareItems:
– sharingService:didShareItems:
– sharingService:didFailToShareItems:error:

Константы

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

Объявление

Swift

enum NSSharingContentScope : Int { case Item case Partial case Full }

Objective C

enum { NSSharingContentScopeItem, NSSharingContentScopePartial, NSSharingContentScopeFull }; typedef NSInteger NSSharingContentScope;

Константы
- Item
  
  NSSharingContentScopeItem
  
  Используемый при совместном использовании ясно идентифицированного элемента, например, файл представлен его значком.
  
  Доступный в OS X v10.8 и позже.
- Partial
  
  NSSharingContentScopePartial
  
  Используемый при совместном использовании части более глобального содержания, например, части веб-страницы.
  
  Доступный в OS X v10.8 и позже.
- Full
  
  NSSharingContentScopeFull
  
  Используемый при совместном использовании целого содержания текущего документа, например, URL веб-страницы.
  
  Доступный в OS X v10.8 и позже.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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