Документация Python неофициальный перевод

aetypes.md

176 строк · 6.9 КБ · обычная страница · сырой текст · скачать

1> **Источник:** https://python-all.ru/2.6/library/aetypes.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 37.4. `aetypes` – объекты AppleEvent89*Платформы:* Mac1011Модуль `aetypes` определяет классы, используемые для представления дескрипторов данных Apple Event и спецификаторов объектов Apple Event.1213Данные Apple Event содержатся в дескрипторах, и эти дескрипторы типизированы. Для многих дескрипторов представление в Python – это просто соответствующий тип Python: `typeText` в OSA – это строка Python, `typeFloat` – число с плавающей запятой, и т.д. Для типов OSA, не имеющих прямого аналога в Python, этот модуль объявляет классы. Упаковка и распаковка экземпляров этих классов выполняется автоматически модулем [`aepack`](https://python-all.ru/2.6/library/aepack.html#module-aepack).1415Спецификатор объекта – это, по сути, адрес объекта, реализованного в сервере Apple Event. Спецификатор Apple Event используется как прямой объект для Apple Event или как аргумент необязательного параметра. Модуль `aetypes` содержит базовые классы для классов и свойств OSA, которые используются пакетами, сгенерированными [`gensuitemodule`](https://python-all.ru/2.6/library/gensuitemodule.html#module-gensuitemodule), для заполнения классов и свойств в заданном наборе.1617По причинам обратной совместимости, а также для случаев, когда необходимо написать сценарий для приложения, для которого ещё не создан пакет-заглушка, этот модуль также содержит спецификаторы объектов для ряда распространённых классов OSA, таких как `Document`, `Window`, `Character` и т.д.1819> **Примечание**20>21> Этот модуль был удалён в Python 3.x.2223Модуль `AEObjects` определяет следующие классы для представления данных дескрипторов Apple Event:2425#### `class aetypes.Unknown(type, data)`2627Представление данных дескриптора OSA, для которых модули2829[`aepack`](https://python-all.ru/2.6/library/aepack.html#module-aepack)3031и3233`aetypes`3435не предоставляют поддержки, то есть всё, что не представлено другими классами здесь и не эквивалентно простому значению Python.3637#### `class aetypes.Enum(enum)`3839Значение перечисления с заданным 4-символьным строковым значением.4041#### `class aetypes.InsertionLoc(of, pos)`4243Позиция4445`pos`4647в объекте4849`of`5051.5253#### `class aetypes.Boolean(bool)`5455Булево значение.5657#### `class aetypes.StyledText(style, text)`5859Текст со включённой информацией о стиле (шрифт, начертание и т. д.).6061#### `class aetypes.AEText(script, style, text)`6263Текст со включённой информацией о системе письма и стиле.6465#### `class aetypes.IntlText(script, language, text)`6667Текст со включённой информацией о системе письма и языке.6869#### `class aetypes.IntlWritingCode(script, language)`7071Информация о системе письма и языке.7273#### `class aetypes.QDPoint(v, h)`7475Точка QuickDraw.7677#### `class aetypes.QDRectangle(v0, h0, v1, h1)`7879Прямоугольник QuickDraw.8081#### `class aetypes.RGBColor(r, g, b)`8283Цвет.8485#### `class aetypes.Type(type)`8687Значение типа OSA с указанным 4-символьным именем.8889#### `class aetypes.Keyword(name)`9091Ключевое слово OSA с указанным 4-символьным именем.9293#### `class aetypes.Range(start, stop)`9495Диапазон.9697#### `class aetypes.Ordinal(abso)`9899Нечисловые абсолютные позиции, такие как100101`"firs"`102103, first, или104105`"midd"`106107, middle.108109#### `class aetypes.Logical(logc, term)`110111Логическое выражение применения оператора112113`logc`114115к116117`term`118119.120121#### `class aetypes.Comparison(obj1, relo, obj2)`122123Сравнение124125`relo`126127`obj1`128129с130131`obj2`132133.134135Следующие классы используются в качестве базовых классов сгенерированными пакетами-заглушками для представления классов и свойств AppleScript в Python:136137#### `class aetypes.ComponentItem(which[, fr])`138139Абстрактный базовый класс для класса OSA. Подкласс должен установить атрибут класса140141`want`142143в 4-символьный код класса OSA. Экземпляры подклассов этого класса эквивалентны Object Specifiers AppleScript. При создании экземпляра следует передать селектор в144145`which`146147и, опционально, родительский объект в148149`fr`150151.152153#### `class aetypes.NProperty(fr)`154155Абстрактный базовый класс для свойства OSA. Подкласс должен установить атрибуты класса156157`want`158159и160161`which`162163, чтобы указать, о каком свойстве идёт речь. Экземпляры подклассов этого класса являются Object Specifiers.164165#### `class aetypes.ObjectSpecifier(want, form, seld[, fr])`166167Базовый класс168169`ComponentItem`170171и172173`NProperty`174175, общего OSA Object Specifier. Смотрите документацию Apple Open Scripting Architecture для параметров. Обратите внимание, что этот класс не является абстрактным.176