Type Method 型メソッド

appleEventWithEventClass:eventID:targetDescriptor:returnID:transactionID:

Creates a descriptor that represents an Apple event, initialized according to the specified information. あるアップルイベントを表す記述子を作成します、指定の情報に従って初期化されます。

Declaration 宣言

+ (NSAppleEventDescriptor *)appleEventWithEventClass:(AEEventClass)eventClass 
                                             eventID:(AEEventID)eventID 
                                    targetDescriptor:(NSAppleEventDescriptor *)targetDescriptor 
                                            returnID:(AEReturnID)returnID 
                                       transactionID:(AETransactionID)transactionID;

Parameters パラメータ

eventClass: The event class to be set in the returned descriptor. 返される記述子の中に設定されるイベントクラス。
eventID: The event ID to be set in the returned descriptor. 返される記述子の中に設定されるイベントID。
addressDescriptor: A pointer to a descriptor that identifies the target application for the Apple event. Passing nil results in an Apple event descriptor that has no keyAddressAttr attribute (it is valid for an Apple event to have no target address attribute). このアップルイベントのための目標アプリケーションを識別する記述子へのポインタ。nilを渡すことは、keyAddressAttr属性を持たないアップルイベント記述子という結果になります（目標アドレス属性を持たないことはアップルイベントに対して有効です）。
returnID: The return ID to be set in the returned descriptor. If you pass a value of kAutoGenerateReturnID, the Apple Event Manager assigns the created Apple event a return ID that is unique to the current session. If you pass any other value, the Apple Event Manager assigns that value for the ID. 返される記述子の中に設定されるリターンID。あなたがkAutoGenerateReturnIDの値を渡すならば、アップルイベントマネージャーは作成されたアップルイベントをリターンIDに代入します、それは現在のセッションに対して特有です。あなたが何らかの他の値を渡したならば、アップルイベントマネージャはその値をこのIDに対して割り当てます。
transactionID: The transaction ID to be set in the returned descriptor. A transaction is a sequence of Apple events that are sent back and forth between client and server applications, beginning with the client’s initial request for a service. All Apple events that are part of a transaction must have the same transaction ID. You can specify kAnyTransactionID if the Apple event is not one of a series of interdependent Apple events. 返される記述子の中に設定されるトランザクションID。トランザクションは、クライアントのサーバーへの最初の要請で始まる、クライアントとサーバー・アプリケーションの間を行ったり来たり渡されるいくらかのアップルイベントからなる１つの連なりです。あるトランザクションの一部である全てのアップルイベントは、同じトランザクションIDを持たなければなりません。あなたは、そのアップルイベントが相互依存のアップルイベントの一続きの１つでないならば、kAnyTransactionIDを指定できます。

Return Value 戻り値

A descriptor for an Apple event, initialized according to the specified parameter values, or nil if an error occurs. 指定のパラメータ値に従って初期化された、あるアップルイベントのための記述子、またはエラーが起こるならばnil。

Discussion 議論

Constants such as kAutoGenerateReturnID and kAnyTransactionID are defined in AE.framework, a subframework of ApplicationServices.framework. kAutoGenerateReturnIDとkAnyTransactionIDのような定数は、AE.frameworkにおいて、ApplicationServices.frameworkの下位フレームワークで、定義されます。

See Also 参照

Creating and Initializing Descriptors 記述子の作成と初期化

+ descriptorWithBoolean:

Creates a descriptor initialized with type typeBoolean that stores the specified Boolean value. 型typeBooleanで初期化される記述子を作成します、それは措定されたブール値を格納します。

+ descriptorWithDescriptorType:bytes:length:

Creates a descriptor initialized with the specified event type that stores the specified data (from a series of bytes). 指定されたイベント型で初期化される記述子を作成します、それは指定されたデータを格納します（一続きのバイトから）。

+ descriptorWithDescriptorType:data:

Creates a descriptor initialized with the specified event type that stores the specified data (from an instance of NSData). 指定されたイベント型で初期化される記述子を作成します、それは指定されたデータを格納します（NSDataのインスタンスから）。

+ descriptorWithEnumCode:

Creates a descriptor initialized with type typeEnumerated that stores the specified enumerator data type value. 型typeEnumeratedで初期化される記述子を作成します、それは指定された列挙子データ型値を格納します。

+ descriptorWithInt32:

Creates a descriptor initialized with Apple event type typeSInt32 that stores the specified integer value. アップルイベント型typeSInt32で初期化される記述子を作成します、それは指定された整数値を格納します。

+ descriptorWithString:

Creates a descriptor initialized with type typeUnicodeText that stores the text from the specified string. typeUnicodeText型で初期化される記述子を作成します、それは指定された文字列からのテキストを格納します。

+ descriptorWithTypeCode:

Creates a descriptor initialized with type typeType that stores the specified type value. typeType型で初期化される記述子を作成します、それは指定された型値を格納します。

+ listDescriptor

Creates and initializes an empty list descriptor. 空のリスト記述子を作成して初期化します。

+ nullDescriptor

Creates and initializes a descriptor with no parameter or attribute values set. パラメータまたは属性値が設定されない記述子を作成して初期化します。

+ recordDescriptor

Creates and initializes a descriptor for an Apple event record whose data has yet to be set. あるアップルイベントレコードに対する記述子を作成して初期化します、それのデータはまだ設定されません。

- initListDescriptor

Initializes a newly allocated instance as an empty list descriptor. 新たに割り当てされたインスタンスを空のリスト記述子として初期化します。

- initRecordDescriptor

Initializes a newly allocated instance as a descriptor that is an Apple event record. 新たに割り当てされたインスタンスをアップルイベントレコードである記述子として初期化します。

- initWithAEDescNoCopy:

Initializes a newly allocated instance as a descriptor for the specified Carbon AEDesc structure. 新たに割り当てされたインスタンスを指定されたCarbonAEDesc構造体に対する記述子として初期化します。

- initWithDescriptorType:bytes:length:

Initializes a newly allocated instance as a descriptor with the specified descriptor type and data (from an arbitrary sequence of bytes and a length count). 新たに割り当てされたインスタンスを指定された記述子型とデータ（随意のバイトシーケンスと長さ合計から）を伴う記述子として初期化します。

- initWithDescriptorType:data:

Initializes a newly allocated instance as a descriptor with the specified descriptor type and data (from an instance of NSData). 新たに割り当てされたインスタンスを指定された記述子型とデータ（NSDataのインスタンスから）を伴う記述子として初期化します。

- initWithEventClass:eventID:targetDescriptor:returnID:transactionID:

Initializes a newly allocated instance as a descriptor for an Apple event, initialized with the specified values. 新たに割り当てされたインスタンスをあるアップルイベントに対する記述子として初期化します、指定された値で初期化されます。