LibUIDropDownMenu

Хочешь карту со своим ником? Оформить ❤️

О

Стандартные глобальные функции UIDropDownMenu используют защищенные фреймы и вызывают порчу при использовании сторонних аддонов. Но можно избежать загрязнений, используя ту же функциональность с этой библиотекой.

Что это

Библиотека-это стандартный код из файлов Blizzard EasyMenu.lua, UIDropDownMenu. lua, UIDropDownMenu.xml, UIDropDownMenuTemplates. lua и UIDropDownMenuTemplates.xml с фреймами, таблицами, переменными и функциями, ограниченными таблицами библиотеки.

Глобальные константы были добавлены с префиксом «L_«, например:

• L_UIDROPDOWNMENU_MINBUTTONS

Зависимость и конфигурация аддона

• Встраивая LibUIDropDownMenu в ваш аддон, вы можете указать подпапку LibUIDropDownMenu, если чувствуете, что это делает структуру папок вашего аддона легче.
• Добавить LibUIDropDownMenu.xml к вашему toc или вашему embeds.xml / libs.xml.
• Убедитесь, что ваш файл toc имеет следующие настройки:

## Зависимости: LibStub,! LibUIDropDownMenu

• Если ваш аддон не встраивает LibStub, он вам понадобится.

Как его использовать (для разработчика аддонов)

Начальная Подготовка

Предполагая, что ваш аддон использует все функции UIDropDownMenu из встроенных вызовов функций WoW, то предполагается, что в ваших кодах lua есть приведенная ниже подготовка:

local LibDD = LibStub:GetLibrary («LibUIDropDownMenu-4.0«)

Замена Вызова Функции

В зависимости от того, какие вызовы функций UIDropDownMenu вы использовали в своем аддоне, вам потребуется следующая аналогичная замена:

UIDropDownMenu_Initialize => LibDD:UIDropDownMenu_Initialize
UIDropDownMenu_CreateInfo => LibDD:UIDropDownMenu_CreateInfo
UIDropDownMenu_AddButton => LibDD:UIDropDownMenu_AddButton

UIDropDownMenu_AddSeparator => LibDD:UIDropDownMenu_AddSeparator
UIDropDownMenu_AddSpace=> LibDD:UIDropDownMenu_AddSpace

UIDropDownMenu_SetSelectedValue => LibDD:UIDropDownMenu_SetSelectedValue
UIDropDownMenu_SetSelectedName=> LibDD:UIDropDownMenu_SetSelectedName

UIDropDownMenu_SetSelectedID => LibDD:UIDropDownMenu_SetSelectedID
UIDropDownMenu_SetWidth => LibDD:UIDropDownMenu_SetWidth

CloseDropDownMenus => LibDD:CloseDropDownMenus

Создание нового UIDropDownMenu

Традиционно вы либо создадите новый фрейм в своих кодах lua, либо с помощью XML, установив фрейм наследуемым от «UIDropDownMenuTemplate«.

Используя эту библиотеку, вам нужно будет создать свое меню, как показано ниже:

local frame = LibDD:Create_UIDropDownMenu(«MyDropDownMenu«, parent_frame)

Константы

• L_UIDROPDOWNMENU_MINBUTTONS
• L_UIDROPDOWNMENU_MAXBUTTONS
• L_UIDROPDOWNMENU_MAXLEVELS
• L_UIDROPDOWNMENU_BUTTON_HEIGHT
• L_UIDROPDOWNMENU_BORDER_HEIGHT
• L_UIDROPDOWNMENU_OPEN_MENU
• L_UIDROPDOWNMENU_INIT_MENU
• L_UIDROPDOWNMENU_MENU_LEVEL
• L_UIDROPDOWNMENU_MENU_VALUE
• L_UIDROPDOWNMENU_SHOW_TIME
• L_UIDROPDOWNMENU_DEFAULT_TEXT_HEIGHT
• L_OPEN_DROPDOWNMENUS
• L_DropDownList1
• L_DropDownList2

Название Кнопки

Как вы (разработчики), возможно, знаете, что в какой-то момент вам может понадобиться манипулировать выпадающими списками, получая доступ к именам кнопок. Например, у вас есть несколько уровней меню, и вы хотели бы скрыть или показать кнопку меню какого-то уровня. В этом случае вам нужно убедиться, что вы также пересмотрели имя кнопки, используемое в ваших исходных кодах, когда вы переходите на использование LibUIDropDownMenu.

• «L_Dropdownlist С»..я

Пример:

	для i = 1, L_UIDROPDOWNMENU_MAXLEVELS, 1 do
dropDownList = _G["L_DropDownList" ..i];
Если (i >= L_UIDROPDOWNMENU_MENU_LEVEL или frame ~= L_UIDROPDOWNMENU_OPEN_MENU), то
dropDownList. numButtons = 0;
			dropDownList. maxWidth = 0;
			для J=1, L_UIDROPDOWNMENU_MAXBUTTONS, 1 сделать
 кнопка = _G["L_DropDownList"..я.."кнопку"..Дж];
				кнопка: скрыть();
			конец
выпадающего списка: скрыть();
		конец
конец

Список атрибутов кнопок

• info. text = [STRING] — текст кнопки
• информация.значение = [ничего] — значение, которое L_UIDROPDOWNMENU_MENU_VALUE имеет значение, когда кнопка нажата
• info. func = [function()] — функция, вызываемая при нажатии кнопки
• информация.проверено = [Нил, правда, функция] — проверить кнопку, если значение true или функция возвращает true
• информация.isNotRadio = [nil, то правда] — проверить кнопка использует радиальное изображение, если ложные проверить коробку если это правда
• info. isTitle = [nil, true] — если это заголовок, то кнопка отключена, а цвет шрифта установлен на желтый
• info. disabled = [nil, true] — отключите кнопку и покажите невидимую кнопку, которая все еще ловит событие наведения курсора мыши, чтобы меню не истекло тайм-аут
• информация.tooltipWhileDisabled = [Нил 1] … показывать подсказки, даже если кнопка отключена.
• информация.hasArrow = [nil, то правда] — показать на стрелку для многоуровневых меню
• info.hasColorSwatch = [nil, true] — показать образец цвета или нет, для выбора цвета
• info. r = [1-255] — значение красного цвета образца цвета
• info. g = [1-255] — значение зеленого цвета образца цвета
• info. b = [1-255] — значение синего цвета образца цвета
• info. colorCode = [STRING] — «/ cAARRGGBB » встроенное шестнадцатеричное значение цвета текста кнопки. Используется только при включенной кнопке
• информация.swatchFunc = [функция()] — функция вызывается палитра цветов на изменение цвета
• информация.hasOpacity = [Нил 1] — показать ползунок непрозрачности на палитре кадра
• info. opacity = [0.0-1.0] — процент непрозрачности, 1.0 полностью показан, 0 прозрачен
• информация.opacityFunc = [функция()] — функция, вызываемая непрозрачность, когда вы измените его значение
• информация.cancelFunc = [функция(previousValues)] — функция, вызываемая colorpicker, когда вы нажимаете кнопку Отменить (он принимает предыдущие значения в качестве аргумента)
• информация.notClickable = [Нил 1] — Отключить кнопки и цвет шрифта белый
• информация.notCheckable = [Нил 1] — уменьшить размер кнопок и не отображать флажок
• info. owner = [Frame] — выпадающий кадр, который «владеет» текущим выпадающим списком
• информация.keepShownOnClick = [Нил 1] — Не прячь элементе dropdownlist после нажатии кнопки
• info. tooltipTitle = [nil, STRING] — заголовок всплывающей подсказки, отображаемой при наведении курсора мыши
• информация.tooltipText = [Нил строки] — текст всплывающей подсказки отображается при наведении курсора мыши
• информация.tooltipOnButton = [Нил 1] … показывать подсказки, прикрепленный к кнопке, а не как подсказку новичку.
• информация.justifyH = [НИЛ «Центр»] — оправдать текст кнопки
• info. arg1 = [ANYTHING] — это первый аргумент, используемый info.func
• info. arg2 = [ANYTHING] — это второй аргумент, используемый info.func
• информация.fontObject = [шрифт] — шрифт замены объекта для нормальной и выделить
• информация.menuTable = [таблица] — это содержит массив из таблицы info будет отображаться в меню ребенка
• информация.noClickSound = [Нил 1] — Установите 1, чтобы подавить звук при нажатии кнопки. Звук воспроизводится только в том случае, если .функция установлена.
• info. padding = [nil, NUMBER] — количество пикселей для заполнения текста с правой стороны
• информация.leftPadding = [Нил числа — число пикселей на панели кнопки с левой стороны
• info. minWidth = [nil, NUMBER] — минимальная ширина для этой строки
• info. customFrame = frame — позволяет этой кнопке быть полностью пользовательским фреймом, должен наследовать от UIDropDownCustomMenuEntryTemplate и переопределять соответствующие методы.
• info. icon = [TEXTURE] — значок кнопки.
• информация.mouseOverIcon = [текстуры] — икона переопределить когда кнопка наведении курсора.
• информация.ignoreAsMenuSelection [Нил правда] — никогда не изменять значок меню «текст» /в этом, даже когда эта кнопка проверил.

ЧАСТО ЗАДАВАЕМЫЕ ВОПРОСЫ

Пожалуйста, перейдите на страницы часто задаваемых вопросов для получения более подробной информации.

Похожие аддоны

wowUnit framework TradeSkillMaster_TDAutoVendoring WhoLib StatLogicLib