37.6. FrameWork – Интерактивный каркас приложений¶FrameWork – Interactive application framework

37.6.1. Объекты приложения¶Application Objects

Объекты приложения имеют следующие методы, в числе прочих:

Application.makeusermenus()¶

Переопределите этот метод, если вашему приложению нужны меню. Добавьте меню в атрибут menubar.

Application.getabouttext()¶

Переопределите этот метод, чтобы вернуть текстовую строку с описанием приложения. В качестве альтернативы можно переопределить метод do_about() для более подробных сообщений «О программе».

Application.mainloop([mask[, wait]])¶

Эта процедура является основным циклом событий; вызовите её, чтобы запустить приложение. Mask – это маска событий, которые нужно обрабатывать; wait – количество тиков (ticks), которое следует выделить другим параллельным приложениям (по умолчанию 0, что, вероятно, не очень хорошая идея). Хотя вызов self для выхода из основного цикла по-прежнему поддерживается, это не рекомендуется: вместо этого вызывайте self._quit().

Цикл событий разбит на множество небольших частей, каждую из которых можно переопределить. Методы по умолчанию занимаются диспетчеризацией событий окнам и диалогам, обработкой перетаскивания и изменения размеров, событий Apple, событий для окон, не относящихся к FrameWork, и т.д.

В общем случае все обработчики событий должны возвращать 1, если событие полностью обработано, и 0 в противном случае (например, потому что переднее окно не было окном FrameWork). Это нужно, чтобы события обновления и подобные могли передаваться другим окнам, например окну консоли Sioux. Вызов MacOS.HandleEvent() не разрешен внутри our_dispatch или вызываемых им функций, так как это может привести к бесконечному циклу, если код вызывается через обработчик событий внутреннего цикла Python.

Application.asyncevents(onoff)¶

Вызовите этот метод с ненулевым параметром, чтобы включить асинхронную обработку событий. Это укажет внутреннему циклу интерпретатора вызывать обработчик событий приложения async_dispatch всякий раз, когда доступны события. Это позволит обновлениям окон FrameWork и пользовательскому интерфейсу оставаться рабочими во время длительных вычислений, но замедлит работу интерпретатора и может привести к неожиданным результатам в нереентерабельном коде (например, в самом FrameWork). По умолчанию async_dispatch немедленно вызывает our_dispatch, но вы можете переопределить это поведение, чтобы обрабатывать асинхронно только определённые события. События, которые вы не обрабатываете, будут переданы Sioux и подобным.

Возвращается предыдущее значение вкл/выкл.

Application._quit()¶

Завершить выполняющийся вызов mainloop() при ближайшей удобной возможности.

Application.do_char(c, event)¶

Пользователь ввёл символ c. Полные подробности события можно найти в структуре event. Этот метод также может быть предоставлен в объекте Window, который переопределяет общеприкладной обработчик, если окно является передним.

Application.do_dialogevent(event)¶

Вызывается в начале цикла событий для обработки событий немодальных диалогов. Метод по умолчанию просто отправляет событие соответствующему диалогу (не через задействованный объект DialogWindow). Переопределите, если требуется специальная обработка событий диалога (клавиатурные сокращения и т.д.).

Application.idle(event)¶

Вызывается главным циклом событий, когда нет доступных событий. Передаётся нулевое событие (так что можно проверить положение мыши и т.д.).

37.6.2. Объекты окна¶Window Objects

Объекты Window имеют следующие методы, среди прочих:

Window.open()¶

Переопределите этот метод, чтобы открыть окно. Сохраните идентификатор окна Mac OS в self.wid и вызовите метод do_postopen() для регистрации окна в родительском приложении.

Window.close()¶

Переопределите этот метод для выполнения специальной обработки при закрытии окна. Вызовите метод do_postclose(), чтобы очистить состояние родителя.

Window.do_postresize(width, height, macoswindowid)¶

Вызывается после изменения размера окна. Переопределите, если требуется сделать больше, чем просто вызов InvalRect.

Window.do_contentclick(local, modifiers, event)¶

Пользователь щёлкнул в области содержимого окна. Аргументы: координаты (относительно окна), модификаторы клавиш и исходное событие.

Window.do_update(macoswindowid, event)¶

Получено событие обновления окна. Перерисуйте окно.

Window.do_activate(activate, event)¶

Окно было активировано (activate == 1) или деактивировано (activate == 0). Обработайте такие вещи, как подсветка фокуса и т.д.

37.6.3. Объект ControlsWindow¶ControlsWindow Object

Объекты ControlsWindow имеют следующие методы помимо методов объектов Window:

ControlsWindow.do_controlhit(window, control, pcode, event)¶

Часть pcode элемента управления control была нажата пользователем. Отслеживание и прочее уже обработано.

37.6.4. Объект ScrolledWindow¶ScrolledWindow Object

Объекты ScrolledWindow являются объектами ControlsWindow со следующими дополнительными методами:

ScrolledWindow.scrollbars([wantx[, wanty]])¶

Создайте (или уничтожьте) горизонтальные и вертикальные полосы прокрутки. Аргументы указывают, какие из них нужны (по умолчанию обе). Полосы прокрутки всегда имеют минимум 0 и максимум 32767.

ScrolledWindow.getscrollbarvalues()¶

Вы должны предоставить этот метод. Он должен возвращать кортеж (x, y), указывающий текущее положение полос прокрутки (между 0 и 32767). Вы можете вернуть None для любой из них, чтобы указать, что весь документ виден в этом направлении.

ScrolledWindow.updatescrollbars()¶

Вызовите этот метод, когда документ изменился. Он вызовет getscrollbarvalues() и обновит полосы прокрутки.

ScrolledWindow.scrollbar_callback(which, what, value)¶

Предоставляется и вызывается после взаимодействия с пользователем. which будет 'x' или 'y', what будет '-', '--', 'set', '++' или '+'. Для 'set', value будет содержать новое положение полосы прокрутки.

ScrolledWindow.scalebarvalues(absmin, absmax, curmin, curmax)¶

Вспомогательный метод, помогающий вычислить значения для возврата из getscrollbarvalues(). Передаётся минимальное и максимальное значение документа, а также верхнее (левое) и нижнее (правое) видимые значения, и возвращается правильное число или None.

ScrolledWindow.do_activate(onoff, event)¶

Занимается затемнением/подсветкой полос прокрутки, когда окно становится передним. Если этот метод переопределяется, его следует вызывать в конце переопределяющего метода.

ScrolledWindow.do_postresize(width, height, window)¶

Перемещает полосы прокрутки в правильное положение. Этот метод следует вызывать в начале, если он переопределяется.

ScrolledWindow.do_controlhit(window, control, pcode, event)¶

Обрабатывает взаимодействие с полосами прокрутки. Если этот метод переопределяется, его следует вызывать первым; ненулевое возвращаемое значение указывает, что попадание пришлось на полосы прокрутки и было обработано.

37.6.5. Объекты DialogWindow¶DialogWindow Objects

Объекты DialogWindow имеют следующие методы в дополнение к методам объектов Window:

DialogWindow.open(resid)¶

Создаёт диалоговое окно из ресурса DLOG с идентификатором resid. Объект диалога сохраняется в self.wid.

DialogWindow.do_itemhit(item, event)¶

Был активирован элемент номер item. Ответственность за перерисовку переключателей и т.п. лежит на вызывающем коде.