Макросы, диалоги и библиотеки (Basic)

Автор перевода: Александр Гец

Итак, вы написали замечательный макрос для OpenOffice.org, и хотели бы поделиться им с остальным миром. Вы можете, например, опубликовать его исходный код на собственном веб-сайте, но гораздо лучше упаковать его в лёгкий для установки пакет — расширение OpenOffice.org.

Расширение — это всего лишь обыкновенный zip-архив, содержащий помимо самого макроса несколько XML-файлов, необходимых OpenOffice.org для правильной установки пакета. Теоретически, можно создать требуемые XML-файлы в любом текстовом редакторе, но по эффективности это можно сравнить с перекапыванием огорода чайной ложкой. К счастью, существует инструмент, который можно использовать для создания расширения методом «наведи и щёлкни».  

Имя этому чудесному инструменту — BasicAddonBuilder (BAB). После установки он добавляет новую панель инструментов с единственной кнопкой на ней, запускающей Мастера создания расширений. Тем не менее, перед тем, как нажать на эту кнопку, необходимо выполнить небольшую подготовительную работу. Прежде всего, имеет смысл поместить макрос (или макросы), которые вы хотите добавить в расширение, в отдельную библиотеку; в этом случае BAB не придётся вмешиваться в другие макросы в вашей системе. Для перемещения макроса в отдельную библиотеку, выберите Сервис → Макросы → Управление макросами → OpenOffice.org Basic и нажмите кнопку Управление. Там вы сможете добавить новую библиотеку и переместить в неё свой макрос.

Если вы захотите добавить картинку к соответствующим пунктам меню, необходимо заранее приготовить графические файлы. Чтобы найти качественные картинки для ваших расширений, попробуйте поисковую машину IconLet. Вам понадобится как минимум одна иконка 16×16 пикселов в формате PNG для каждого макроса, который вы хотите добавить как пункт меню. Так как OpenOffice.org поддерживает маленькие (16×16) и большие (26×26) иконки для панели инструментов, вы можете при желании создать и соответствующие иконки большего размера.
После того, как вся подготовительная работа выполнена, можно начать процесс создания расширения.

Начало 

Нажмите кнопку BasicAddonBuilder в панели инструментов чтобы открыть мастер, который проведёт вас через весь процесс создания расширения. Начните с выбора библиотеки, содержащей макрос, добавляемый в расширение. Далее следует выбрать способ, которым расширение будет встроено в OpenOffice.org. Здесь будет несколько опций. Как правило, отдельные панель инструментов и меню верхнего уровня предпочтительны для расширений, содержащих несколько макросов (и, следовательно, несколько пунктов меню), тогда как меню Сервис → Расширения или Справка предпочтительнее для расширений с одним или двумя макросами.

Использование BAB

Создание меню верхнего уровня

Для примера создадим меню верхнего уровня. Отметьте параметр Add top level menu и нажмите кнопку Next для перехода к следующему окну, где вы сформируете структуру меню вашего расширения. Первым делом вам здесь нужно будет создать меню верхнего уровня. Нажмите кнопку Edit возле поля Menu title. В диалоге, окно которого откроется, введите заголовок меню в поле Item label. Вы также должны установить так называемый Office context, т.е. приложения OpenOffice.org, в которых меню верхнего уровня должно отображаться. Например, если ваше расширение работает только в документах Writer, поставьте галочку Writer, и меню верхнего уровня появится только в указанном приложении.

Cледующим шагом будет указание пунктов меню. Чтобы сделать это, нажмите кнопку Add menu. При этом откроется диалоговое окно, аналогичное предыдущему, но имеющее чуть больше опций, обязательных для заполнения. Кроме заголовка меню, вы должны привязать пункт меню с конкретным макросом. Щёлкните по кнопке рядом с полем Command, выберите соответствующую библиотеку из выпадающего списка, выберите интересующий модуль в левой части, затем выделите необходимый макрос в правой части.

В секции Icons вы можете добавить иконки для пунктов меню, щёлкнув в пустой квадратик и выбрав нужную иконку правильного размера. При необходимости повторите этот шаг для иконок другого размера. Укажите необходимые приложения в секции Office context и нажмите OK. Аналогично добавляются все остальные пункты меню. Также Вы можете добавить разделители для логической группировки пунктов меню.

Описание и лицензия

После того, как вы будете удовлетворены результатом, нажмите кнопку Next, добавьте необязательное описание к вашему расширению и нажмите Finish для генерации oxt-пакета. С этого момента ваше расширение готово к использованию.

Вы можете установить и распространять созданное расширение как угодно, но есть одна вещь, которую вы можете захотеть добавить к нему: файл description.xml, который содержит дополнительную информацию о вашем расширении, такую как его текущая версия, требуемая версия OpenOffice.org и лицензионная информация. Чтобы сделать это, создайте текстовый файл и вставьте в него следующий код:

Код 1

Замените значения по умолчанию, такие как identifier (название расширения), version (версия расширения) и OpenOffice.org-minimal-version (минимальная требуемая версия OpenOffice.org) корректными значениями, сохраните файл под именем description.xml и добавьте его к .oxt-пакету. Если вы хотите добавить собственное лицензионное соглашение, которое будет отображаться, когда пользователь будет устанавливать расширение, добавьте следующие строки в файл description.xml до закрывающего тега (это будет работать только с OpenOffice.org 2.3 или выше):

Код 2

Обсудить на форуме...

•  Загрузить BasicAddonBuilder(BAB)
•  articles:ooobab
•  Автор перевода: Александр Гец
•  Модификации от MyOOo.ru: заголовки, коррекция названий элементов интерфейса