AddonsTools

5. очистить настройки любого аддона. Например если вы хотите отказаться от использования какого-либо адона, рекомендую сначала удалить его настройки - чтобы они место не занимали в user.cfg Делаем это так:

Для сброса настроек любого аддона (убиения его секции в User.cfg) до настроек записанных в config.txt:

1. выгружаем аддон НужныйАддон с помощью AddonsMenu

2. там же жмем правую кнопку и выбирает Очистить настройки аддона

3. загружаем НужныйАддон - он при запуске возьмет настройки пустые из User.cfg

6. Запрещает/разрешает ДнД для аддонов - можно как для отдельного аддона (правая мышка по аддону) так и для всех аддонов разом: "Полный запрет DnD" - это задается в параметрах АТ

--------- Системные аддоны -------

1. Клик мышкой по пункту меню с именем аддона - поменять режим - ВКЛ/ВЫКЛ/АВТО. Режим АВТО - значит AddonsMenu ничего с этим аддоном не делает. Но его могут выгрузить другие аддоны. ВКЛ - загрузить - даже если его выгрузили. ВЫКЛ - выгрузить, даже если его загрузили

2. Правый клик - временно загрузить/выгрузить аддон

Настройки нужно сохранить через меню - чтобы они потом восстановились

Информация для программистов

Отличие AddonsMenu от AddonsMeneger в том что меню выбора аддонов проще, к тому же аддоны, которые используют библиотеку от AddonsMenu (AddonsMenuClient.lua и AddonsTools_Support.lua), не будут вообще загружаться без вашего разрешения. В то время как обычные аддоны, выгружаемые через AddonManager, сначала полностью загружаются и выполняются, а потом начинают выгружаться, хотя уже успевают сделать нежелательные действия, например выгрузить другой нужный вам (пользовательский или системный) аддон.

Еще AddonsMenu может менять локализацию всех поддерживающих его аддонов "на лету". Это удобно для того чтобы можно было посмотреть как ваш аддон будет выглядеть, например на европейских серверах или на японском сервере. Или если вы играете на европейском, то можете задать для аддонов русскую локализацию и они в нее переключатся.

так же из AddonsMenu можно вызвать основное меню аддонов поддерживающих AOPANEL вызовы, а сам аддон AOPANEL при этом не нужен.

Еще ваш аддон получает текущее значение локализации через SetGameLocalization, которая описана в

В добавок при использовании AddonsMenu вы получаете набор готовых виджетов (содержащихся в глобальной переменной dsc), благодаря чему можно создавать новые виджеты "на лету" по их описаниям, например такой командой:

--- описание функции (ScriptLIB): w = WCD(descr, name, parent, place, show )

n = WCD( dsc.Text, "Text1_txt", wParent, { alignX = 0, alignY = 0, sizeX = 200, }, true )

Еще задавать параметры для аддонов прямо из контекстного меню AddonsMenu, пример использования см. в Example2.zip. Тоесть ваш аддон может вообще не иметь ни одной формы или меню, а все настройки задавать через AddonsMenu. Например так:

Пример (шаблон аддона) с использованием AddonsMenu и AddonsTools находится в архиве Example1.zip и Example2.zip (более свежая версия)

AddonsMenu вызывается двойным кликом мышки по часам, которые я заимствовала из аддона PhanTime (автор Phantasmagor)

в параметрах используется (возвращаются из setAMSupport():

desc = L("описание этого аддона"),

on_click_hide = true, -- hide AddonsMenu when to show me - скрывать ли меню аддонов при нажатии на пункт меню

DnD for old versions

ДнД для старых версий

Теперь можно взять файл библиотеки для ДнД из \Scripts\LibDnD.lua и скопировать его в папку вашего или старого аддона - тогда станет работать событие по запрету ДнД из настроек АТ для этого аддона

Автор

icreator
Добавлен

28.03.2011
Категория

Аддоны

icreator · 12 сентября, 2011

Теперь аддон включает в себя класс menu (menuCls.lua) - для конструирования собственных меню в ваших аддонах на лету, то есть без описания множества файлов .xdb

Так же аддон включает:

+ библиотеку (LibDnD_ic.lua) для Drag'n'Drop с автоматическим назначением уникального номера для окна

+ библиотеку полезных функций (ScriptLIB.lua), часто используемых в аддонах

При инициализации описаний виджетов, попутно все описания из menuCls становятся вам доступны:

Code:

dsc = menuDscInit(wAddonsTools)

в переменной dsc содержатся описания виджетов. Можно создать виджет кнопки например так:

Code:

n = mainForm:CreateWidgetByDesc( dsc.Button ); n:SetName( "Main_btn" )

wtSetVal( n, "iM") wtSetPlace(n, { sizeX= 60 } )

n:Show( true )

DnD:Init( n, n, true )

Пример использования в файле Example1.zip - тут готовый аддон, который вы можете взять как шаблон для своего аддона.

Все значения из меню возвращаются как строковые, поэтому если вам наlо сохранять в параметры числовые значения то делайте преобразование

_PS = tonumber( value)

Дополнительное описание тут

пример как создать свою меню.

Для создания меню в вашем аддоне:

1. вставьте ссылки на файлы menuCls.lua, ScriptLIB.lua и LibDnD_ic.lua в ваш AddonDesc.(UIAddon).xdb например так:

Code:

2. задайте структуру будущего меню, например так:

Code:

local strucMenu = {

[1] = { name = "ex1", label = "Simple Example"},

[2] = { token = "1", label = "-----"},

[3] = { name = "ex2", label = "Complex Example"},

}

3. Инициализируйте виджеты и их описания - когда аватар уже загружен:

Code:

local wAddonsTools = stateMainForm:GetChildUnchecked("AddonsTools", false)

if wAddonsTools then

--- exist

mainForm:GetChildUnchecked("ErrorText", false):Show(false)

--- set widgets descriprions for menu class and get its:

dsc = menuDscInit(wAddonsTools)

else

--- not exist

return

end

--- continue if AddonsTools is loaded:

3.1. создайте новый объект меню:

Code:

m1 = menu{ name="menu1", strucMenu = strucMenu }

4. инициируйте его:

Code:

m1:init({

mouse_left_click = FUNC_m1,

mouse_overRun = true,

})

5. и теперь можно его использовать, например показать:

Code:

m1:Show ( true )

пример и описание есть в http://ui9.ru/forum/menuclasslib

icreator · 12 сентября, 2011

Примеры использования в аддонах:

InterfaceManager

MenuClassLIB

icreator · 14 сентября, 2011

новый параметр пункта меню - tip - вызывает подсказку при наведении мышкой на пункт

Code:

local strucMenu = {

[1] = { name = "ex1", label = "Simple Example", tip="Sinple Example.."},

[2] = { token = "1", label = "-----"},

[3] = { name = "ex2", label = "Complex Example"},

}

icreator · 19 сентября, 2011

AddonsTools

Просмотр файла