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 类(例如DocumentWindowCharacter等)的对象说明符。

Note

该模块已在 Python 3.x 中删除。

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

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

    • aepackaetypes模块不支持的 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 *)

    • obj1obj2的比较relo

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

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

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

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