tk_mac

ИМЯ

tk::mac — Доступ к функциям, специфичным для Mac, в OS X из Tk

СИНТАКСИС

ОБРАБОТЧИКИ СОБЫТИЙ (CALLBACK)

::tk::mac::ShowPreferences

::tk::mac::OpenApplication

::tk::mac::ReopenApplication

::tk::mac::OpenDocument file...

::tk::mac::PrintDocument file...

::tk::mac::Quit

::tk::mac::OnHide

::tk::mac::OnShow

::tk::mac::ShowHelp

Имя

Синопсис

Обработчики событий (callbacks)

::tk::mac::ShowPreferences

Стандартный обработчик Apple Event для kAEShowPreferences, «pref». Элемент меню приложения «Настройки» активен только при определении этой процедуры. Обычно эта команда используется для обертывания собственной команды настроек, которая отображает окно настроек. Что-то вроде:

proc ::tk::mac::ShowPreferences {} {
    setPref
}

::tk::mac::OpenApplication

Если определена процедура с этим именем, она вызывается при первоначальном открытии приложения. Это стандартный обработчик Apple Event для kAEOpenApplication, «oapp».

::tk::mac::ReopenApplication

Если определена процедура с этим именем, она является стандартным обработчиком Apple Event для kAEReopenApplication, «rapp», события Apple Event, отправляемого при открытии приложения, когда оно уже запущено (например, щелчком по его значку в Dock). Вот пример, который поднимает минимизированное окно при щелчке по значку Dock:

proc ::tk::mac::ReopenApplication {} {
    if {[wm state .] eq "withdrawn"} {
        wm state . normal
    } else {
        wm deiconify .
    }
    raise .
}

::tk::mac::OpenDocument file...

Если определена процедура с этим именем, она является стандартным обработчиком Apple Event для kAEOpenDocuments, «odoc», события Apple Event, отправляемого, когда приложение должно открыть один или несколько документов (например, перетаскиванием на приложение или открытием документа, связанного с типом приложения). Процедура должна принимать в качестве аргументов пути к открываемым файлам, как показано ниже:

proc ::tk::mac::OpenDocument {args} {
    foreach f $args {my_open_document $f}
}

::tk::mac::PrintDocument file...

Если определена процедура с этим именем, она является стандартным обработчиком Apple Event для kAEPrintDocuments, «pdoc», события Apple Event, отправляемого, когда приложение должно напечатать один или несколько документов (например, через пункт меню «Печать» в Finder). Она работает аналогично tk::mac::OpenDocument с точки зрения аргументов.

::tk::mac::Quit

Если определена процедура с этим именем, она является стандартным обработчиком Apple Event для kAEQuitApplication, «quit», события Apple Event, отправляемого, когда приложение должно быть закрыто, например, через пункт меню «Выход» в меню приложения, меню «Выход» в меню Dock или во время выхода/перезагрузки/выключения и т. д. Если она не определена, вызывается exit.

::tk::mac::OnHide

Если определена, она вызывается, когда приложение получает событие kEventAppHidden, например, через пункт меню «Скрыть» в меню приложения или Dock.

::tk::mac::OnShow

Если определена, она вызывается, когда приложение получает событие kEventAppShown, например, через пункт меню «Показать всё» в меню приложения или щелчком по значку Dock скрытого приложения.

::tk::mac::ShowHelp

Настраивает поведение меню «Справка» Apple; если эта процедура не определена, стандартный элемент меню «Справка Вашего приложения» платформы выполняет стандартное действие Cocoa, отображая книгу справки, настроенную в Info.plist приложения (или отображая предупреждение, если книга справки не задана).

Дополнительные диалоги

::tk::mac::standardAboutPanel

Выводит стандартный диалог «О программе» Cocoa с заполненной информацией из файлов пакета приложения (стандартный диалог «О программе» без указания параметров). См. техническое примечание Apple TN2179 и документацию AppKit по -[NSApplication orderFrontStandardAboutPanelWithOptions:] для получения подробностей о ключах Info.plist и файлах пакета приложения, используемых диалогом «О программе».

Настройка системы

::tk::mac::useCompatibilityMetrics boolean

Сохраняет совместимость со старыми метриками Tk/Aqua; установите в false для более естественного форматирования.

::tk::mac::CGAntialiasLimit limit

Устанавливает предел сглаживания; линии, толщина которых меньше, чем limit пикселей, не будут сглаживаться. Целое число, по умолчанию установлено в 0, что включает сглаживание для всех линий.

::tk::mac::antialiasedtext number

Устанавливает сглаживание текста. Управляет сглаживанием текста, возможные значения для number: -1 (по умолчанию, использовать системное значение по умолчанию для сглаживания текста), 0 (отключить сглаживание текста), 1 (включить сглаживание текста).

::tk::mac::useThemedToplevel boolean

Устанавливает окна toplevel для отображения современного серого/полосатого фона Mac. Эквивалентно конфигурации toplevel с «-background systemWindowHeaderBackground» или использованию ttk::frame.

Команды поддержки

::tk::mac::iconBitmap name width height -kind value

Отображает родные значки и битовые карты в приложениях Tk (включая любой файл изображения, читаемый NSImage). Имя родной битовой карты интерпретируется следующим образом (в порядке приоритета):

• предопределённое встроенное имя значка 32x32 (stop, caution, document и т. д.)
• name, как определено в tk::mac::iconBitmap
• имя NSImage
• строка URL NSImage
• 4-символьный OSType значка IconServices

Аргументы width и height для tk::mac::iconBitmap определяют размеры создаваемого изображения, а -kind должен быть одним из следующих:

-file

значок файла по указанному пути

-fileType

значок данного типа файла

-osType

значок файла данного 4-символьного OSType

-systemType

значок для данного 4-символьного OSType IconServices

-namedImage

именованное NSImage для данного имени

-imageFile

изображение по указанному пути

См. также