38.4. aetypes — AppleEvent 对象

aetypes定义用于表示 Apple Event 数据 Descriptors 和 Apple Event 对象说明符的类。

Apple Event 数据包含在 Descriptors 中，并键入这些 Descriptors。对于许多 Descriptors，Python 表示形式只是对应的 Python 类型：OSA 中的typeText是 Python 字符串，typeFloat是浮点型，等等。对于没有直接 Python 对应物的 OSA 类型，此模块语句类。这些类的打包实例由aepack自动处理。

对象说明符本质上是在 Apple Event Server 中实现的对象的地址。 Apple Event 说明符用作 Apple Event 的直接对象或用作可选参数的参数。 aetypes模块包含 OSA 类和属性的 Base Class，由gensuitemodule生成的包使用这些 Base Class 来填充给定套件中的类和属性。

出于向后兼容性的原因，以及需要编写尚未为其生成存根包的应用程序的脚本的情况，此模块还包含许多常见 OSA 类(例如Document，Window，Character等)的对象说明符。

AEObjects模块定义以下类来表示 Apple 事件 Descriptors 数据：

• 类别 aetypes. Unknown(类型，数据)

  • aepack和aetypes模块不支持的 OSADescriptors 数据的表示形式，即此处其他类未表示的任何内容，并且不等同于简单的 Python 值。

• 类别 aetypes. Enum(枚举)

  • 具有给定 4 个字符的字符串值的枚举值。
• • class * aetypes. InsertionLoc(* of ， pos *)
  • 将pos放置在对象of中。
• • class * aetypes. Boolean(* bool *)
  • A boolean.
• • class * aetypes. StyledText(* style ， text *)
  • 包含样式信息(字体，面部等)的文本。
• • class * aetypes. AEText(* script ， style ， text *)
  • 包含脚本系统和样式信息的文本。
• • class * aetypes. IntlText(* script ， language ， text *)
  • 包含脚本系统和语言信息的文本。
• • class * aetypes. IntlWritingCode(* script ， language *)
  • 脚本系统和语言信息。

• 类别 aetypes. QDPoint(* v ， h *)

  • 快速抽奖点。
• • class * aetypes. QDRectangle(* v0 ， h0 ， v1 ， h1 *)
  • 快速绘制矩形。

• 类别 aetypes. RGBColor(* r ， g ， b *)

  • A color.

• 类别 aetypes. Type(类型)

  • 具有给定 4 个字符名称的 OSA 类型值。

• 类别 aetypes. Keyword(名称)

  • 具有给定 4 个字符名称的 OSA 关键字。

• 类别 aetypes. Range(开始，停止)

  • A range.
• • class * aetypes. Ordinal(* abso *)
  • 非数字绝对位置，例如"firs"(第一个)或"midd"(中间)。
• • class * aetypes. Logical(* logc ， term *)
  • 将运算符logc应用于term的逻辑表达式。

• 类别 aetypes. Comparison(* obj1 ， relo ， obj2 *)

  • obj1与obj2的比较relo。

生成的存根包将以下类用作 Base Class，以表示 Python 中的 AppleScript 类和属性：

• 类别 aetypes. ComponentItem(其中 [，* fr *])

  • OSA 类的抽象 Base Class。子类应将类属性want设置为 4 个字符的 OSA 类代码。此类的子类的实例等效于 AppleScript 对象说明符。实例化时，应在which中传递 selectors，并在fr中传递父对象。

• 类别 aetypes. NProperty(* fr *)

  • OSA 属性的抽象 Base Class。子类应设置类属性want和which来指定我们要讨论的属性。此类的子类的实例是对象说明符。
• • class * aetypes. ObjectSpecifier(* want ， form ， seld * [，* fr *])
  • 通用 OSA 对象说明符ComponentItem和NProperty的 Base Class。有关参数，请参阅 Apple Open Scripting Architecture 文档。请注意，此类不是抽象的。