aetypes — Объекты AppleEvent

Модуль aetypes определяет классы, используемые для представления данных описателей событий Apple Event и указателей на объекты Apple Event.

Данные события Apple Event содержатся в описателях, и эти описатели имеют тип. Для многих описателей представление в Python просто соответствует соответствующему типу Python: typeText в OSA — это строка Python, typeFloat — это число с плавающей точкой и т. д. Для типов OSA, у которых нет прямого аналога в Python, в этом модуле объявлены классы. Упаковка и распаковка экземпляров этих классов обрабатываются автоматически модулем aepack.

Указатель на объект — это по существу адрес объекта, реализованного в сервере Apple Event. Указатель на объект Apple Event используется в качестве непосредственного объекта события Apple Event или в качестве аргумента необязательного параметра. Модуль aetypes содержит базовые классы для классов и свойств OSA, которые используются пакетами, сгенерированными модулем gensuitemodule, для заполнения классов и свойств в заданном наборе.

По соображениям обратной совместимости и в случаях, когда вам нужно программировать приложение, для которого вы не сгенерировали пакет-заглушку, этот модуль также содержит указатели на объекты для ряда распространенных классов OSA, таких как Document, Window, Character, и т. д.

Модуль AEObjects определяет следующие классы для представления данных описателей событий Apple Event:

class aetypes.Unknown(type, data)

Представление данных описателя OSA, для которого модули aepack и aetypes не поддерживают, т. е. все, что не представлено другими классами здесь и не эквивалентно простому значению Python.

class aetypes.Enum(enum)

Значение перечисления со заданным значением строки из 4 символов.

class aetypes.InsertionLoc(of, pos)

Позиция pos в объекте of.

class aetypes.Boolean(bool)

Булево значение.

class aetypes.StyledText(style, text)

Текст со стилем (шрифт, начертание и т. д.).

class aetypes.AEText(script, style, text)

Текст со скриптовой системой и информацией о стиле.

class aetypes.IntlText(script, language, text)

Текст со скриптовой системой и языковой информацией.

class aetypes.IntlWritingCode(script, language)

Информация о скриптовой системе и языке.

class aetypes.QDPoint(v, h)

Точка QuickDraw.

class aetypes.QDRectangle(v0, h0, v1, h1)

Прямоугольник QuickDraw.

class aetypes.RGBColor(r, g, b)

Цвет.

class aetypes.Type(type)

Значение типа OSA с заданным 4-символьным именем.

class aetypes.Keyword(name)

Ключевое слово OSA с заданным 4-символьным именем.

class aetypes.Range(start, stop)

Диапазон.

class aetypes.Ordinal(abso)

Нечисловые абсолютные позиции, такие как "firs", первая, или "midd", средняя.

class aetypes.Logical(logc, term)

Логическое выражение применения оператора logc к term.

class aetypes.Comparison(obj1, relo, obj2)

Сравнение relo obj1 с obj2.

Следующие классы используются в качестве базовых классов сгенерированными пакетами-заглушками для представления классов и свойств AppleScript в Python:

class aetypes.ComponentItem(which[, fr])

Абстрактный базовый класс для класса OSA. Подкласс должен установить атрибут класса want в 4-символьном коде класса OSA. Экземпляры подклассов этого класса эквивалентны указателям на объекты AppleScript. При создании экземпляра вы должны передать селектор в which, а необязательно — родительский объект в fr.

class aetypes.NProperty(fr)

Абстрактный базовый класс для свойства OSA. Подкласс должен установить атрибуты класса want и which для обозначения свойства, о котором идёт речь. Экземпляры подклассов этого класса являются указателями на объекты.

class aetypes.ObjectSpecifier(want, form, seld[, fr])

Базовый класс для ComponentItem и NProperty, общий указатель на объект OSA. См. документацию Apple Open Scripting Architecture для параметров. Обратите внимание, что этот класс не является абстрактным.