class func shared() -> NSAppleEventManager
NSAppleEventManager
, creating it first if it doesn’t exist.
NSAppleEventManager
の唯一のインスタンスを返します、それが存在しないならばそれを最初に作成します。
Availability 有効性
Technology
class NSAppleEventManager : NSObject
Cocoa provides built-in scriptability support that uses scriptability information supplied by an application to automatically convert Apple events into script command objects that perform the desired operation. However, some applications may want to perform more basic Apple event handling, in which an application registers handlers for the Apple events it can process, then calls on the Apple Event Manager to dispatch received Apple events to the appropriate handler. NSApple
supports these mechanisms by providing methods to register and remove handlers and to dispatch Apple events to the appropriate handler, if one exists. For related information, see How Cocoa Applications Handle Apple Events
Cocoaは、組み込みのスクリプト対応機能をサポートします、それは、あるアプリケーションによって提供されるスクリプト対応機能情報を使って、自動的に様々なアップルイベントを色々な望む操作を実行するスクリプトコマンドオブジェクトへと変換します。しかしながら、いくつかのアプリケーションはもっと基本的なアップルイベントの取り扱いを行うことを望むかもしれません、そのようなアプリケーションでは、それが処理可能ないくらかのアップルイベントに対してのハンドラを登録します、それから受け取ったアップルイベントを適切なハンドラーへと発送(ディスパッチ)するようにアップルイベントマネージャに頼みます。NSApple
は、ハンドラの登録と除去をするためにそしてアップルイベントを適切なハンドラーに、もしそれが存在すれば、発送するためにメソッドを提供することによってこれらの仕組みを支えます。関連した情報として、どのようにCocoaアプリケーションはアップルイベントを取り扱うかを見てください。
Each application has at most one instance of NSApple
. To obtain a reference to it, you call the class method shared()
, which creates the instance if it doesn’t already exist.
各アプリケーションは、最大で1つのNSApple
のインスタンスを持ちます。それに対する参照を入手するには、あなたはクラスメソッドshared()
を呼び出します、それはそれがまだ存在しないならばそのインスタンスを作成します。
For information about the Apple Event Manager, see Apple Event Manager and Apple Events Programming Guide. アップルイベントマネージャについての情報として、Apple Event Managerと「アップルイベントプログラミングガイド」を見てください。
class func shared() -> NSAppleEventManager
NSAppleEventManager
, creating it first if it doesn’t exist.
NSAppleEventManager
の唯一のインスタンスを返します、それが存在しないならばそれを最初に作成します。
func removeEventHandler (forEventClass : AEEventClass, andEventID : AEEventID)
eventClass
and eventID
, removes it.
あるアップルイベントハンドラーがeventClass
とeventID
で指定されるイベントに対して登録されているならば、それを取り除きます。
func setEventHandler (Any, andSelector : Selector, forEventClass : AEEventClass, andEventID : AEEventID)
handler
for the event specified by eventClass
and eventID
.
handler
で指定されるアップルイベントハンドラーを、eventClass
とeventID
で指定されるイベントに対して登録します。
func dispatchRawAppleEvent (UnsafePointer<AppleEvent>, withRawReply : UnsafeMutablePointer<AppleEvent>, handlerRefCon : SRefCon) -> OSErr
theAppleEvent
to be dispatched to the appropriate Apple event handler, if one has been registered by calling setEventHandler(_:andSelector:forEventClass:andEventID:)
.
theAppleEvent
で指定されるアップルイベントが適切なアップルイベントハンドラーに発送されるようにします、もしそういったものがsetEventHandler(_:andSelector:forEventClass:andEventID:)
を呼び出すことで登録されているならば。
func appleEvent (forSuspensionID : NSAppleEventManager.SuspensionID) -> NSAppleEventDescriptor
suspensionID
returned by an invocation of suspendCurrentAppleEvent()
, returns the descriptor for the event whose handling was suspended.
非ゼロのsuspensionID
がsuspendCurrentAppleEvent()
の発動によって返されて指定されることで、取り扱いが休止されたイベントに対する記述子を返します。
var currentAppleEvent : NSAppleEventDescriptor?
currentAppleEvent
if an Apple event is being handled on the current thread.
あるアップルイベントが現在のスレッド上で取り扱われているならば、currentAppleEvent
に対する記述子を返します。
var currentReplyAppleEvent : NSAppleEventDescriptor?
func replyAppleEvent (forSuspensionID : NSAppleEventManager.SuspensionID) -> NSAppleEventDescriptor
suspensionID
returned by an invocation of suspendCurrentAppleEvent()
, returns the corresponding reply event descriptor.
非ゼロのsuspensionID
がsuspendCurrentAppleEvent()
の発動によって返されて指定されることで、該当する返答イベント記述子を返します。
func resume(withSuspensionID : NSAppleEventManager.SuspensionID)
suspensionID
returned by an invocation of suspendCurrentAppleEvent()
, signal that handling of the suspended event may now continue.
非ゼロのsuspensionID
がsuspendCurrentAppleEvent()
の発動によって返されて指定されることで、休止されたイベントの取り扱いが今続きを行われるように合図します。
func setCurrentAppleEventAndReplyEventWithSuspensionID (NSAppleEventManager.SuspensionID)
suspensionID
returned by an invocation of suspendCurrentAppleEvent()
, sets the values that will be returned by subsequent invocations of currentAppleEvent
and currentReplyAppleEvent
to be the event whose handling was suspended and its corresponding reply event, respectively.
非ゼロのsuspensionID
がsuspendCurrentAppleEvent()
の発動によって返されて指定されることで、すぐ後に起こるcurrentAppleEvent
とcurrentReplyAppleEvent
の発動によって返される値を、それぞれ処理が休止されたイベントおよびそれの該当する返答イベントになるように設定します。
func suspendCurrentAppleEvent () -> NSAppleEventManager.SuspensionID?
typealias NSAppleEventManager.SuspensionID
class NSAppleEventDescriptor