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

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

Разработчик

Ссылка платформы основы ссылка класса NSAppleScript

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

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

NSAppleScript

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

Этот класс предоставляет приложениям возможность к

  • загрузите сценарий из URL или из текстовой строки

  • скомпилируйте или выполните сценарий или отдельное событие Apple

  • получите NSAppleEventDescriptor содержа ответ из выполняемого сценария или события

  • получите приписанную строку для скомпилированного сценария, подходящего для дисплея в редакторе сценариев

  • получите различные виды информации о любых ошибках, которые могут произойти

Когда Вы создаете экземпляр NSAppleScript объект, можно использовать URL для указания сценария, который может быть или в тексте или в скомпилированной форме, или можно предоставить сценарий как строку. Если ошибка происходит при компиляции или выполнении сценария, несколько из методов возвращают словарь, содержащий информацию об ошибке. Ключи для получения информации об ошибке, такой как NSAppleScriptErrorMessage, описаны в разделе Constants.

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

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

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

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

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

Инициализация сценария
  • init (contentsOfURL:error:) - initWithContentsOfURL:error: Определяемый инициализатор

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

    Объявление

    Swift

    init?(contentsOfURL url: NSURL, error errorInfo: AutoreleasingUnsafeMutablePointer<NSDictionary?>)

    Objective C

    - (instancetype)initWithContentsOfURL:(NSURL *)url error:(NSDictionary **)errorInfo

    Параметры

    url

    URL, определяющий местоположение сценария, или в тексте или в скомпилированной форме.

    errorInfo

    По возврату, если ошибка происходит, указатель на словарь информации об ошибке.

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

    Инициализированный объект сценария, nil если происходит ошибка.

    Обсуждение

    Этот метод является определяемым инициализатором для NSAppleScript.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • init (источник:) - initWithSource: Определяемый инициализатор

    Инициализирует недавно выделенный экземпляр сценария из переданного источника.

    Объявление

    Swift

    init?(source source: String)

    Objective C

    - (instancetype)initWithSource:(NSString *)source

    Параметры

    source

    Строка, содержащая исходный код сценария.

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

    Инициализированный объект сценария, nil если происходит ошибка.

    Обсуждение

    Этот метод является определяемым инициализатором для NSAppleScript.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

Получение информации о сценарии
  • isCompiled - isCompiled

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

    Объявление

    Objective C

    - (BOOL)isCompiled

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

    YEStrue если получатель уже компилируется, NOfalse иначе.

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

    Objective C

    @import Foundation;

    Доступность

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

  • источник - источник

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

    Объявление

    Swift

    var source: String? { get }

    Objective C

    @property(readonly, copy) NSString *source

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

    Исходный код сценария получателя, если это доступно, nil иначе.

    Обсуждение

    Это возможно для NSAppleScript с этим инстанцировали initWithContentsOfURL:error: быть сценарием, для которого исходный код не доступен, но является, тем не менее, исполнимой программой.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

Компиляция и выполнение сценария
  • compileAndReturnError (_:) - compileAndReturnError:

    Компилирует получатель, если он уже не компилируется.

    Объявление

    Swift

    func compileAndReturnError(_ errorInfo: AutoreleasingUnsafeMutablePointer<NSDictionary?>) -> Bool

    Objective C

    - (BOOL)compileAndReturnError:(NSDictionary **)errorInfo

    Параметры

    errorInfo

    По возврату, если ошибка происходит, указатель на словарь информации об ошибке.

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

    YEStrue для успеха или если сценарий был уже скомпилирован, NOfalse иначе.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • executeAndReturnError (_:) - executeAndReturnError:

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

    Объявление

    Swift

    func executeAndReturnError(_ errorInfo: AutoreleasingUnsafeMutablePointer<NSDictionary?>) -> NSAppleEventDescriptor?

    Objective C

    - (NSAppleEventDescriptor *)executeAndReturnError:(NSDictionary **)errorInfo

    Параметры

    errorInfo

    По возврату, если ошибка происходит, указатель на словарь информации об ошибке.

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

    Результат выполнения события, или nil если происходит ошибка.

    Обсуждение

    Любые изменения в значениях свойств, вызванных путем выполнения сценария, не сохраняются.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • executeAppleEvent (_: ошибка:) - executeAppleEvent:error:

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

    Объявление

    Swift

    func executeAppleEvent(_ event: NSAppleEventDescriptor, error errorInfo: AutoreleasingUnsafeMutablePointer<NSDictionary?>) -> NSAppleEventDescriptor?

    Objective C

    - (NSAppleEventDescriptor *)executeAppleEvent:(NSAppleEventDescriptor *)event error:(NSDictionary **)errorInfo

    Параметры

    event

    Событие Apple для выполнения.

    errorInfo

    По возврату, если ошибка происходит, указатель на словарь информации об ошибке.

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

    Результат выполнения события, или nil если происходит ошибка.

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

Константы
  • Ошибочные ключи словаря

    Если результат initWithContentsOfURL:error:, compileAndReturnError:, executeAndReturnError:, или executeAppleEvent:error:, отказ сигналов (nil, NOfalse, nil, или nil, соответственно), указатель на автовыпущенный словарь помещается в расположение, на которое указывает параметр ошибок. Ошибочный информационный словарь может содержать записи, использующие любую комбинацию следующих ключей, включая никакие записи вообще.

    Объявление

    Swift

    let NSAppleScriptErrorMessage: NSString! let NSAppleScriptErrorNumber: NSString! let NSAppleScriptErrorAppName: NSString! let NSAppleScriptErrorBriefMessage: NSString! let NSAppleScriptErrorRange: NSString!

    Objective C

    extern NSString *NSAppleScriptErrorMessage; extern NSString *NSAppleScriptErrorNumber; extern NSString *NSAppleScriptErrorAppName; extern NSString *NSAppleScriptErrorBriefMessage; extern NSString *NSAppleScriptErrorRange;

    Константы

    • NSAppleScriptErrorMessage

      NSAppleScriptErrorMessage

      NSString это предоставляет подробное описание состояния ошибки.

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

    • NSAppleScriptErrorNumber

      NSAppleScriptErrorNumber

      NSNumber это указывает код ошибки.

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

    • NSAppleScriptErrorAppName

      NSAppleScriptErrorAppName

      NSString это указывает имя приложения, генерировавшего ошибку.

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

    • NSAppleScriptErrorBriefMessage

      NSAppleScriptErrorBriefMessage

      NSString это предоставляет краткое описание ошибки.

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

    • NSAppleScriptErrorRange

      NSAppleScriptErrorRange

      NSValue это указывает диапазон.

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