NSScriptClassDescription
Экземпляр NSScriptClassDescription
описывает класс сценария что Какао поддержка приложений.
scriptable приложение предоставляет scriptability информацию, описывающую команды и возражающую, что сценаристы могут использовать в сценариях, предназначающихся для приложения. Это включает информацию о классах, из которых создаются те scriptable объекты.
scriptability информация приложения собрана автоматически экземпляром NSScriptSuiteRegistry
. Объект реестра создает NSScriptClassDescription
для каждого класса это находит и кэширует эти объекты в памяти. Какао, пишущее сценарий информации о реестре использования в обрабатывании запросов сценариев, предназначающихся для приложения.
Экземпляр описания класса хранит имя, атрибуты, отношения и поддерживаемые команды для класса. Например, scriptable document
класс для приложения получения мог бы поддерживать атрибуты такой как file
и file type
, отношения, такие как наборы circles
, rectangles
, и lines
, и команды такой как align
и rotate
.
Как со многими классами во встроенной поддержке сценариев Какао, Ваше приложение никогда, возможно, не должно непосредственно работать с экземплярами NSScriptClassDescription
. Однако один случай, где Вам, возможно, понадобился бы доступ к описанию класса, - то, если Вы переопределяете objectSpecifier
в scriptable классе. Для получения информации о том, как сделать это, посмотрите Объектные Спецификаторы в Руководстве по созданию сценариев Какао.
Другой случай, где Вашему приложению, возможно, понадобится доступ к информации об описании класса, - то, если Вы переопределяете indicesOfObjectsByEvaluatingWithContainer:count:
в классе спецификатора.
Несмотря на то, что можно разделить на подклассы NSScriptClassDescription
, маловероятно, что необходимо было бы для этого или даже создать экземпляры его.
Наследование
-
NSObject
-
NSClassDescription
-
NSScriptClassDescription
-
NSObject
-
NSClassDescription
-
NSScriptClassDescription
Оператор импорта
Swift
import Foundation
Objective C
@import Foundation;
Доступность
Доступный в OS X v10.0 и позже.
-
init (suiteName:className:dictionary:) - initWithSuiteName:className:dictionary:
Определяемый инициализаторИнициализирует и возвращает недавно выделенный экземпляр
NSScriptClassDescription
.Объявление
Swift
init?(suiteName
suiteName
: String, classNameclassName
: String, dictionaryclassDeclaration
: [NSObject : AnyObject]?)Objective C
- (instancetype)initWithSuiteName:(NSString *)
suiteName
className:(NSString *)className
dictionary:(NSDictionary *)classDeclaration
Параметры
suiteName
Имя комплекта (в scriptability информации приложения), которому принадлежит класс. Например,
"AppName Suite"
.className
Имя класса, который описывает этот экземпляр.
classDeclaration
Словарь объявления класса вида, который допустим в файлах списка свойств комплекта сценария. Этот словарь предоставляет информацию о классе, таком как его атрибуты и отношения.
Возвращаемое значение
Инициализированный экземпляр. Возвраты
nil
если значение кода события для самого описания класса отсутствует или неNSString
. Также возвратыnil
если суперимя класса или какой-либо из подсловарей описаний не имеют правильного типа.Обсуждение
Этот метод регистры
self
с глобальным экземпляром приложенияNSScriptSuiteRegistry
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает описание класса для указанного класса или, если это не scriptable для первого суперкласса, который является.
Объявление
Swift
init?(forClass
aClass
: AnyClass!) -> NSScriptClassDescriptionObjective C
+ (NSScriptClassDescription *)classDescriptionForClass:(Class)
aClass
Параметры
aClass
Класс, описание которого необходимо.
Возвращаемое значение
Описание класса для класса, указанного
aClass
или, если тот класс не scriptable для описания класса для первого суперкласса, который является. Возвратыnil
если это не находит scriptable класс.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.5 и позже.
-
Возвращает экземпляр описания класса для типа класса указанного атрибута или отношения.
Объявление
Swift
func classDescriptionForKey(_
key
: String) -> NSScriptClassDescription?Objective C
- (NSScriptClassDescription *)classDescriptionForKey:(NSString *)
key
Параметры
key
Ключ идентификации для атрибута или отношения получателя.
Возвращаемое значение
Экземпляр
NSScriptClassDescription
для типа атрибута или отношения, указанногоkey
. Возвратыnil
если никакое scriptable свойство не соответствуетkey
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает экземпляр описания класса для суперкласса класса получателя.
Объявление
Swift
var superclassDescription: NSScriptClassDescription? { get }
Objective C
@property(readonly, retain) NSScriptClassDescription *superclassDescription
Возвращаемое значение
Экземпляр описания класса, описывающий суперкласс класса получателя. Возвраты
nil
если класс не имеет никакого суперкласса.Обсуждение
Экземпляр
NSScriptClassDescription
это описывает суперкласс, может быть в том же комплекте как получатель или в различном комплекте.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает имя класса, который получатель описывает, как предусмотрено во время инициализации.
Объявление
Swift
var className: String? { get }
Objective C
@property(readonly, copy) NSString *className
Возвращаемое значение
Имя класса. Это может быть или человекочитаемым именем для класса — т.е. имя, использующееся в сценарии — или имя класса Objective C, который инстанцируют для реализации класса. Для надежного получения имени реализации использовать
implementationClassName
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает значение
DefaultSubcontainerAttribute
запись словаря класса, из которого инстанцировали получатель.Объявление
Swift
var defaultSubcontainerAttributeKey: String? { get }
Objective C
@property(readonly, copy) NSString *defaultSubcontainerAttributeKey
Возвращаемое значение
Значение подконтейнера по умолчанию приписывает запись. Возвраты
nil
если не было такой записи.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.2 и позже.
-
Возвращает имя класса Objective C, который инстанцируют для реализации класса сценариев.
Объявление
Swift
var implementationClassName: String? { get }
Objective C
@property(readonly, copy) NSString *implementationClassName
Возвращаемое значение
Имя класса Objective C.
Обсуждение
Имя, возвращенное
className
метод для экземпляраNSScriptClassDescription
следование из sdef объявления класса является человекочитаемым именем для класса — т.е. имя, использующееся в сценарии. Для получения имени класса Objective C, который инстанцируют для реализации класса, использоватьimplementationClassName
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.5 и позже.
-
Возвращает булево значение, указывающее, должно ли расположение вставки быть указано при создании нового объекта в указанном к - многие отношение получателя.
Объявление
Swift
func isLocationRequiredToCreateForKey(_
toManyRelationshipKey
: String) -> BoolObjective C
- (BOOL)isLocationRequiredToCreateForKey:(NSString *)
toManyRelationshipKey
Параметры
toManyRelationshipKey
Ключ для к - многие отношение, которое может потребовать расположения вставки.
Возвращаемое значение
YES
true
если должно быть указано расположение вставки; иначе,NO
false
.Обсуждение
Объект команды сценария, создающий новый объект в к - много потребностей отношения знать, требуется ли явно указанное расположение вставки. Это может получить эту информацию от экземпляра
NSScriptClassDescription
. Например,NSMakeCommand
использование этот метод, чтобы определить, действительно ли определенноеmake
Команда AppleScript должна иметьat
параметр.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.2 и позже.
-
Возвращает имя комплекта получателя.
Объявление
Swift
var suiteName: String? { get }
Objective C
@property(readonly, copy) NSString *suiteName
Возвращаемое значение
Имя комплекта получателя. В scriptability информации приложения, названной комплектами, содержат связанные наборы информации.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает код события Apple, связанный с классом получателя.
Объявление
Swift
var appleEventCode: FourCharCode { get }
Objective C
@property(readonly) FourCharCode appleEventCode
Возвращаемое значение
Код события Apple связался с классом получателя. Это - основной код, используемый для идентификации класса в событиях Apple.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает код события Apple для указанного атрибута или отношения в получателе.
Объявление
Swift
func appleEventCodeForKey(_
key
: String) -> FourCharCodeObjective C
- (FourCharCode)appleEventCodeForKey:(NSString *)
key
Параметры
key
Ключ идентификации для атрибута или отношения получателя.
Возвращаемое значение
Код события Apple с четырьмя символами связался с атрибутом или отношением, идентифицированным
key
в получателе или, если ни один не существует в описании класса для суперкласса получателя. Возвраты0
если не найдены никакой такой атрибут или отношение.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает булево значение, указывающее, соответствует ли основной или вторичный код события Apple в получателе переданный код.
Объявление
Swift
func matchesAppleEventCode(_
appleEventCode
: FourCharCode) -> BoolObjective C
- (BOOL)matchesAppleEventCode:(FourCharCode)
appleEventCode
Параметры
appleEventCode
Код события Apple для сравнения с основными или вторичными кодами получателя.
Возвращаемое значение
YES
true
если основной код события Apple получателя с четырьмя символами или любой из его вторичных кодов (его синонимы) соответствияcode
; иначе,NO
false
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает булево значение, указывающее, имеет ли описанный класс упорядоченный - многие отношение, идентифицированное указанным ключом.
Объявление
Swift
func hasOrderedToManyRelationshipForKey(_
key
: String) -> BoolObjective C
- (BOOL)hasOrderedToManyRelationshipForKey:(NSString *)
key
Параметры
key
Ключ идентификации для свойства получателя.
Возвращаемое значение
YES
true
если описанный класс имеет упорядоченный - многие отношение, идентифицированное указанным ключом; иначе,NO
false
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.5 и позже.
-
Возвращает булево значение, указывающее, идентифицировал ли описанному классу свойство указанный ключ.
Объявление
Swift
func hasPropertyForKey(_
key
: String) -> BoolObjective C
- (BOOL)hasPropertyForKey:(NSString *)
key
Параметры
key
Ключ идентификации для свойства получателя.
Возвращаемое значение
YES
true
если описанному классу идентифицировал свойство указанный ключ; иначе,NO
false
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.5 и позже.
-
Возвращает булево значение, указывающее, идентифицировал ли описанному классу читаемое свойство указанный ключ.
Объявление
Swift
func hasReadablePropertyForKey(_
key
: String) -> BoolObjective C
- (BOOL)hasReadablePropertyForKey:(NSString *)
key
Параметры
key
Ключ идентификации для свойства получателя.
Возвращаемое значение
YES
true
если описанному классу идентифицировал читаемое свойство указанный ключ; иначе,NO
false
.Обсуждение
Чтобы определить, только ли свойство для чтения, вызвать
hasWritablePropertyForKey:
/Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.5 и позже.
-
Возвращает булево значение, указывающее, идентифицировал ли описанному классу перезаписываемое свойство указанный ключ.
Объявление
Swift
func hasWritablePropertyForKey(_
key
: String) -> BoolObjective C
- (BOOL)hasWritablePropertyForKey:(NSString *)
key
Параметры
key
Ключ идентификации для свойства получателя.
Возвращаемое значение
YES
true
если описанному классу идентифицировал перезаписываемое свойство указанный ключ; иначе,NO
false
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.5 и позже.
-
isReadOnlyKey: - isReadOnlyKey:
(OS X v10.5)Возвращает булево значение, указывающее, только ли указанное свойство в получателе для чтения.
Оператор осуждения
Использовать
hasWritablePropertyForKey:
вместо этого.Объявление
Objective C
- (BOOL)isReadOnlyKey:(NSString *)
key
Параметры
key
Ключ идентификации для свойства получателя.
Возвращаемое значение
YES
true
если свойство, указанноеkey
существует в получателе или вNSScriptClassDescription
для любого суперкласса, и только для чтения; иначе,NO
false
.Специальные замечания
Этот метод мог возвратиться
NO
false
также, потому чтоkey
является нераспознанным или потому что не поддерживается запись в свойство. ИспользоватьhasWritablePropertyForKey:
вместо этого.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в в OS X v10.0.
Осуждаемый в OS X v10.5.
См. также
-
Учитывая код события Apple, идентифицирующий свойство или класс элемента, возвращает ключ для соответствующего атрибута, непосредственного отношения или связи «один ко многим».
Объявление
Swift
func keyWithAppleEventCode(_
appleEventCode
: FourCharCode) -> String?Objective C
- (NSString *)keyWithAppleEventCode:(FourCharCode)
appleEventCode
Параметры
appleEventCode
Код события Apple, идентифицирующий класс элемента или свойство.
Возвращаемое значение
Ключ, соответствующий свойству или классу элемента, идентифицированному
appleEventCode
в получателе или, если ни один не существует в описании класса в суперклассах получателя.Код события Apple с четырьмя символами связался с атрибутом или отношением, идентифицированным
key
Возвраты0
если не найдены никакой такой атрибут или отношение. Возвратыnil
если это не может найти никакой подобный атрибут или отношение.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает имя заявленного типа атрибута или отношения, идентифицированного переданным ключом.
Объявление
Параметры
key
Ключ идентификации для атрибута, непосредственного отношения или связи «один ко многим» получателя.
Возвращаемое значение
Имя заявленного типа атрибута или отношения, идентифицированного
key
; например, «NSString». Поиски в получателе сначала, затем в любом суперклассе. Возвратыnil
если не найдено никакое соответствие.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает селектор, связанный с получателем для указанного описания команды.
Объявление
Swift
func selectorForCommand(_
commandDescription
: NSScriptCommandDescription) -> SelectorObjective C
- (SEL)selectorForCommand:(NSScriptCommandDescription *)
commandDescription
Параметры
commandDescription
Описание для команды сценария, такой как
duplicate
,make
, илиmove
. Инкапсулирует scriptability информацию для той команды, такой как ее селектор Objective C, ее имена параметра и типы и его тип возврата (если таковые имеются).Возвращаемое значение
Селектор от получателя для команды, указанной
commandDescription
. Поиски в получателе сначала, затем в любом суперклассе. ВозвратыNULL
если не найден никакой селектор соответствия.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает булево значение, указывающее, поддерживают ли получатель или какой-либо суперкласс указанную команду.
Объявление
Swift
func supportsCommand(_
commandDescription
: NSScriptCommandDescription) -> BoolObjective C
- (BOOL)supportsCommand:(NSScriptCommandDescription *)
commandDescription
Параметры
commandDescription
Описание для команды сценария, такой как
duplicate
,make
, илиmove
. Инкапсулирует scriptability информацию для той команды, такой как ее селектор Objective C, ее имена параметра и типы и его тип возврата (если таковые имеются).Возвращаемое значение
YES
true
если получатель или экземплярNSScriptClassDescription
из любого суперкласса списков учащихся получателя команда, описаннаяcommandDesc
среди его поддерживаемых команд; иначе,NO
false
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
См. также