SBObject

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

Каждый SBObject создается вокруг объектного спецификатора, говорящего Мост Сценариев, как определить местоположение объекта. Поэтому можно думать SBObject как ссылка на объект в целевом приложении, а не сам объект. Для обхода этого основанного на ссылке подхода и оценки силы используйте get метод.

Как правило, а не создать SBObject экземпляры explictly, Вы получаете SBObject объекты вызывающими методами SBApplication подкласс. Например, если Вы хотели добраться SBObject представляя текущую дорожку iTunes, Вы использовали бы код как это (где iTunesTrack подкласс SBObject):

      iTunesApplication *iTunes = [SBApplication applicationWithBundleIdentifier:@"com.apple.iTunes"];
iTunesTrack *track = [iTunes currentTrack];

Можно обнаружить имена динамично сгенерированных классов такой как iTunesApplication и iTunesTrack путем исследования заголовочного файла, создаваемого sdp инструмент. Также Вы даете этим переменным динамический тип Objective C id.

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

NSObject
SBObject
SBApplication

NSObject
SBObject
SBApplication

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

AnyObject
CVarArgType
Сопоставимый
Hashable
NSCoding
NSObjectProtocol
Печатаемый
NSCoding
NSObject

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

Swift

import ScriptingBridge

Objective C

@import ScriptingBridge;

Доступность

Доступный в OS X v10.5

Инициализация объекта моста сценариев

init () - init

Инициализирует и возвращает экземпляр SBObject подкласс.

Объявление

Swift

init!()

Objective C

- (id)init

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

SBObject объект или nil если не мог бы быть инициализирован объект.

Обсуждение

Сценарии Моста фактически не создают объект в целевом приложении, пока Вы не добавляете, что объект возвратился от этого метода до массива элемента (SBElementArray).

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

Objective C

@import ScriptingBridge;

Swift

import ScriptingBridge

Доступность

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

См. также

– initWithProperties:
– initWithData:
– initWithElementCode:properties:data:


    
    init (данные:)
    - initWithData:

Возвращает экземпляр SBObject подкласс инициализируется с определенными данными.

Объявление

Swift

init!(data data: AnyObject!)

Objective C

- (id)initWithData:(id)data

Параметры


      data

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

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

SBObject объект или nil если не мог бы быть инициализирован объект.

Обсуждение

Сценарии Моста фактически не создают объект в целевом приложении, пока Вы не добавляете, что объект возвратился от этого метода до массива элемента (SBElementArray).

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

Objective C

@import ScriptingBridge;

Swift

import ScriptingBridge

Доступность

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

См. также

– init
– initWithProperties:
– initWithElementCode:properties:data:


    
    init (свойства:)
    - initWithProperties:

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

Объявление

Swift

init!(properties properties: [NSObject : AnyObject]!)

Objective C

- (id)initWithProperties:(NSDictionary *)properties

Параметры


      properties

Словарь с ключами, указывающими имена свойств (т.е. атрибуты или к - отношения) и значения для тех свойств.

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

SBObject объект или nil если не мог бы быть инициализирован объект.

Обсуждение

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

Objective C

@import ScriptingBridge;

Swift

import ScriptingBridge

Доступность

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

См. также

– init
– initWithData:
– initWithElementCode:properties:data:


    
    init (elementCode:properties:data:)
    - initWithElementCode:properties:data:

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

Объявление

Swift

init!(elementCode code: DescType, properties properties: [NSObject : AnyObject]!, data data: AnyObject!)

Objective C

- (id)initWithElementCode:(DescType)code properties:(NSDictionary *)properties data:(id)data

Параметры

`code`	Четыре кода символа раньше идентифицировали элемент в интерфейсе сценариев целевого приложения. Посмотрите Ссылку менеджера по корпоративным мероприятиям Apple для подробных данных.
`properties`	Словарь с ключами, указывающими имена свойств (т.е. атрибуты или к - отношения) и значения для тех свойств. Передача `nil` если Вы инициализируете объект `data` только.
`data`	Объект, содержащий данные для нового `SBObject` объект. Данные варьируются согласно типу сценариев объекта, который будет создаваться. Передача `nil` если Вы инициализирующий объект `properties` только.

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

SBObject объект или nil если не мог бы быть инициализирован объект.

Обсуждение

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

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

Objective C

@import ScriptingBridge;

Swift

import ScriptingBridge

Доступность

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

См. также

– init
– initWithData:
– initWithProperties:

Получение справочных данных

доберитесь () - добраться

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

Объявление

Swift

func get() -> AnyObject!

Objective C

- (id)get

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

На объект ссылается получатель.

Обсуждение

Этот метод вынуждает текущую ссылку на объект (получатель) быть оцененной, приводя к возврату ссылочного объекта. По умолчанию Сценарии Моста имеют дело со ссылками на объекты, пока Вы фактически не запрашиваете некоторые конкретные данные от них или пока Вы не вызываете get метод.

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

Objective C

@import ScriptingBridge;

Swift

import ScriptingBridge

Доступность

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

Отправка событий Apple


    
    sendEvent:id:parameters:
    - sendEvent:id:parameters:

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

Объявление

Objective C

- (id)sendEvent:(AEEventClass)eventClass id:(AEEventID)eventID parameters:(DescType)firstParamCode, ...

Параметры

`eventClass`	Класс событий события Apple, которое будет отправлено.
`eventID`	Идентификатор события события Apple, которое будет отправлено.
`firstParamCode,...`	Список кодов параметра с четырьмя символами (`DescType`) и объектные значения (`id`) завершенный нулем.

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

Событие Apple целевого приложения отправило в ответ; это преобразовывается в объект Какао надлежащего типа.

Обсуждение

Сценарии Моста используют этот метод для передачи с целевыми приложениями. Если целевое приложение реагирует на этот метод путем отправки события Apple, представляющего ошибку, получатель вызывает своего делегата eventDidFail:withError: метод. Если никакой делегат не был присвоен, получатель повышает исключение.

Вам придется редко вызывать этот метод непосредственно.

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

Objective C

@import ScriptingBridge;

Доступность

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

См. также

– заваруха:


    
    заваруха (_:)
    - заваруха:

Устанавливает получатель в указанное значение.

Объявление

Swift

func setTo(_ value: AnyObject!)

Objective C

- (void)setTo:(id)value

Параметры


      value

Данные получатель должны быть установлены в. Это может быть NSString, NSNumber, NSArray, SBObject, или любой другой тип объекта поддерживается платформой Моста Сценариев.

Обсуждение

Вы не должны вызывать этот метод непосредственно.

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

Objective C

@import ScriptingBridge;

Swift

import ScriptingBridge

Доступность

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

См. также

– sendEvent:id:parameters:

Получение свойств и элементов


    
    propertyWithClass (_: код:)
    - propertyWithClass:code:

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

Объявление

Swift

func propertyWithClass(_ class: AnyClass!, code code: AEKeyword) -> SBObject!

Objective C

- (SBObject *)propertyWithClass:(Class)class code:(AEKeyword)code

Параметры

`class`	`SBObject` подкласс, с которым можно инстанцировать объекта.
`code`	Четыре кода символа, однозначно определяющие свойство получателя.

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

Экземпляр определяемого class это представляет свойство получателя, идентифицированное code.

Обсуждение

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

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

Objective C

@import ScriptingBridge;

Swift

import ScriptingBridge

Доступность

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

См. также

– propertyWithCode:

propertyWithCode (_:) - propertyWithCode:

Возвращает объект, представляющий указанное свойство получателя.

Объявление

Swift

func propertyWithCode(_ code: AEKeyword) -> SBObject!

Objective C

- (SBObject *)propertyWithCode:(AEKeyword)code

Параметры

code

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

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

Объект, представляющий свойство получателя, как идентифицировано code.

Обсуждение

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

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

Objective C

@import ScriptingBridge;

Swift

import ScriptingBridge

Доступность

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

См. также

– propertyWithClass:code:
– elementArrayWithCode:
elementArrayWithCode (_:) - elementArrayWithCode:

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

Объявление

Swift

func elementArrayWithCode(_ code: DescType) -> SBElementArray!

Objective C

- (SBElementArray *)elementArrayWithCode:(DescType)code

Параметры

code

Четыре кода символа, идентифицирующие класс сценариев.

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

SBElementArray объект, содержащий каждый дочерний элемент получателя, класс которого соответствует code.

Обсуждение

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

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

Objective C

@import ScriptingBridge;

Swift

import ScriptingBridge

Доступность

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

См. также

– propertyWithCode: