WoW:Using UIDropDownMenu - Revision history

Move page script: Move page script moved page Using UIDropDownMenu to WoW:Using UIDropDownMenu without leaving a redirect

2023-08-15T04:49:15Z

Move page script moved page Using UIDropDownMenu to Using UIDropDownMenu without leaving a redirect

← Older revision	Revision as of 04:49, 15 August 2023
(No difference)

Bear at 02:26, 15 December 2020

2020-12-15T02:26:53Z

← Older revision		Revision as of 02:26, 15 December 2020
Line 1:		Line 1:
	{{~~UIHowTo~~}}		{{wow/uihowto}}
	'''UIDropDownMenu''' is a [[FrameXML]] Frame template that can be used to create contextual menus and dropdown boxes in World of Warcraft. This tutorial explains how to use it in your addon.		'''UIDropDownMenu''' is a [[FrameXML]] Frame template that can be used to create contextual menus and dropdown boxes in World of Warcraft. This tutorial explains how to use it in your addon.

Line 32:		Line 32:

	* The standard drop down menu.		* The standard drop down menu.
	:[[Image:~~WoWiki~~ Example ~~UIDropDownMenu~~ NoMenu.jpg\|The standard drop down menu.]]		: [[Image:UIDropDownMenu-Example NoMenu.jpg\|The standard drop down menu.]]

	* Using the "MENU" keyword.		* Using the "MENU" keyword.
	: [[Image:~~WoWiki Example~~ UIDropDownMenu ~~Menu~~.jpg\|Using the "MENU" keyword.]]		: [[Image:UIDropDownMenu-Example_Menu.jpg\|Using the "MENU" keyword.]]

	== Step 2 : The Menu ==		== Step 2 : The Menu ==
Line 95:		Line 95:
	[[API_ToggleDropDownMenu\|Click here]] for more information on [[API_ToggleDropDownMenu\|ToggleDropDownMenu]].		[[API_ToggleDropDownMenu\|Click here]] for more information on [[API_ToggleDropDownMenu\|ToggleDropDownMenu]].

	~~[[Category:HOWTOs\|Use UIDropDownMenu]]~~

	== HOWTO: nested submenu structures with UIDropDownMenu ==		== HOWTO: nested submenu structures with UIDropDownMenu ==
Line 160:		Line 159:
	* [[UI Object UIDropDownMenu]]: template documentation.		* [[UI Object UIDropDownMenu]]: template documentation.
	* [[API EasyMenu]]: a table-based interface for dropdowns		* [[API EasyMenu]]: a table-based interface for dropdowns
			[[Category:HOWTOs\|Use UIDropDownMenu]]

WoWWiki>Speedwaystar: 4.0.1 API: this -> self

2010-10-28T16:41:31Z

4.0.1 API: this -> self

← Older revision		Revision as of 16:41, 28 October 2010
Line 43:		Line 43:
	<Scripts>		<Scripts>
	<OnLoad>		<OnLoad>
	UIDropDownMenu_Initialize(~~this~~, MyDropDownMenu_OnLoad, "MENU");		UIDropDownMenu_Initialize(self, MyDropDownMenu_OnLoad, "MENU");
	</OnLoad>		</OnLoad>
	</Scripts>		</Scripts>
Line 58:		Line 58:
	<Scripts>		<Scripts>
	<OnLoad>		<OnLoad>
	UIDropDownMenu_Initialize(~~this~~, MyDropDownMenu_OnLoad);		UIDropDownMenu_Initialize(self, MyDropDownMenu_OnLoad);
	</OnLoad>		</OnLoad>

WoWWiki>Starlightblunder: + /* Provided functionality */

2009-12-01T09:16:19Z

+ Provided functionality

@@ Line 1: / Line 1: @@
-[[UI Object UIDropDownMenu|UIDropDownMenu]] can be used to display a basic drop down menu or a series of complex menus such as those that occur when you right click a chat tab. This tutorial explains both.
+{{UIHowTo}}
 == Step 1 : The Button ==
@@ Line 145: / Line 158: @@
 == See also ==
-*[[UI Object UIDropDownMenu]]
+* [[UI Object UIDropDownMenu]]: template documentation.
-*[[API EasyMenu]]
+* [[API EasyMenu]]: a table-based interface for dropdowns

WoWWiki>KirkBot: Typo fixing using AWB

2009-04-07T17:16:07Z

Typo fixing using AWB

← Older revision		Revision as of 17:16, 7 April 2009
Line 19:		Line 19:

	* The standard drop down menu.		* The standard drop down menu.
	:[[Image:~~WoWiki_Example_UIDropDownMenu_NoMenu~~.jpg\|The standard drop down menu.]]		:[[Image:WoWiki Example UIDropDownMenu NoMenu.jpg\|The standard drop down menu.]]

	* Using the "MENU" keyword.		* Using the "MENU" keyword.
	: [[Image:~~WoWiki_Example_UIDropDownMenu_Menu~~.jpg\|Using the "MENU" keyword.]]		: [[Image:WoWiki Example UIDropDownMenu Menu.jpg\|Using the "MENU" keyword.]]

	== Step 2 : The Menu ==		== Step 2 : The Menu ==
Line 144:		Line 144:
	ToggleDropDownMenu(1, nil, dropdown, self, -20, 0);		ToggleDropDownMenu(1, nil, dropdown, self, -20, 0);

	== See ~~Also~~ ==		== See also ==
	*[[UI Object UIDropDownMenu]]		*[[UI Object UIDropDownMenu]]
	*[[API EasyMenu]]		*[[API EasyMenu]]

WoWWiki>Peeka at 22:52, 17 October 2008

2008-10-17T22:52:40Z

← Older revision		Revision as of 22:52, 17 October 2008
Line 101:		Line 101:

	-- menu create function		-- menu create function
	function Test1_DropDown_Initialize(level)		function Test1_DropDown_Initialize(self,level)
	level = level or 1;		level = level or 1;
	if (level == 1) then		if (level == 1) then

WoWWiki>IAmParadox: I found out that the original way to use .func was correct, but, mine is also valid and may help someone else looking for the answer.

2008-06-24T02:11:29Z

I found out that the original way to use .func was correct, but, mine is also valid and may help someone else looking for the answer.

← Older revision		Revision as of 02:11, 24 June 2008
Line 64:		Line 64:
	info.text = "This is an option in the menu.";		info.text = "This is an option in the menu.";
	info.value = "OptionVariable";		info.value = "OptionVariable";
	info.func = FunctionCalledWhenOptionIsClicked;		info.func = FunctionCalledWhenOptionIsClicked
			-- can also be done as function() FunctionCalledWhenOptionIsClicked() end;

	-- Add the above information to the options menu as a button.		-- Add the above information to the options menu as a button.

WoWWiki>Tuhljin at 21:00, 11 May 2008

2008-05-11T21:00:47Z

← Older revision		Revision as of 21:00, 11 May 2008
Line 1:		Line 1:
	UIDropDownMenu can be used to display a basic drop down menu or a series of complex menus such as those that occur when you right click a chat tab. This tutorial explains both.		[[UI Object UIDropDownMenu\|UIDropDownMenu]] can be used to display a basic drop down menu or a series of complex menus such as those that occur when you right click a chat tab. This tutorial explains both.

	== Step 1 : The Button ==		== Step 1 : The Button ==
Line 142:		Line 142:

	ToggleDropDownMenu(1, nil, dropdown, self, -20, 0);		ToggleDropDownMenu(1, nil, dropdown, self, -20, 0);

			== See Also ==
			*[[UI Object UIDropDownMenu]]
			*[[API EasyMenu]]

WoWWiki>Zurr: sp

2007-08-18T09:14:52Z

← Older revision		Revision as of 09:14, 18 August 2007
Line 56:		Line 56:
	</Frame>		</Frame>

	As you have seen from the example, the third variable in ''UIDropDownMenu_Initialize'' changes the appearance of the menu. If the third variable is nil, the menu will be displayed in the fashion of the first example shown in [[#Step 1 : The Button]]. If the third variable is "MENU", which requires the initialization to occur in a ~~seperate~~ frame outside of the button as shown in [[#Step 2 : The Menu]], the menu will be displayed in the fashion of the second example shown in [[#Step 1 : The Button]].		As you have seen from the example, the third variable in ''UIDropDownMenu_Initialize'' changes the appearance of the menu. If the third variable is nil, the menu will be displayed in the fashion of the first example shown in [[#Step 1 : The Button]]. If the third variable is "MENU", which requires the initialization to occur in a separate frame outside of the button as shown in [[#Step 2 : The Menu]], the menu will be displayed in the fashion of the second example shown in [[#Step 1 : The Button]].

	The ''OnLoad'' function itself should be as follows. This example adds one option to the menu.		The ''OnLoad'' function itself should be as follows. This example adds one option to the menu.

WoWWiki>Dieck: /* Howto: nested submenues */

2007-02-16T21:42:55Z

Howto: nested submenues

← Older revision		Revision as of 21:42, 16 February 2007
Line 82:		Line 82:

	[[Category:HOWTOs\|Use UIDropDownMenu]]		[[Category:HOWTOs\|Use UIDropDownMenu]]

			== HOWTO: nested submenu structures with UIDropDownMenu ==

			If you want to split menus, this code examples may help you:

			-- creating test data structure
			local Test1_Data = {
			["level1_test_1"] = {
			[1] = { ["name"] = "sublevel 1"; },
			[2] = { ["name"] = "sublevel 2"; },
			},
			["level1_test_2"] = {
			[1] = { ["name"] = "sublevel A"; },
			[2] = { ["name"] = "sublevel B"; },
			}
			}

			-- menu create function
			function Test1_DropDown_Initialize(level)
			level = level or 1;
			if (level == 1) then
			for key, subarray in pairs(Test1_Data) do
			local info = UIDropDownMenu_CreateInfo();
			info.hasArrow = true; -- creates submenu
			info.notCheckable = true;
			info.text = key;
			info.value = {
			["Level1_Key"] = key;
			};
			UIDropDownMenu_AddButton(info, level);
			end -- for key, subarray
			end -- if level 1

			if (level == 2) then
			-- getting values of first menu
			local Level1_Key = UIDROPDOWNMENU_MENU_VALUE["Level1_Key"];
			subarray = Test1_Data[Level1_Key];
			for key, subsubarray in pairs(subarray) do
			local info = UIDropDownMenu_CreateInfo();
			info.hasArrow = false; -- no submenues this time
			info.notCheckable = true;
			info.text = subsubarray["name"];
			-- use info.func to set a function to be called at "click"
			info.value = {
			["Level1_Key"] = Level1_Key;
			["Sublevel_Key"] = key;
			};
			UIDropDownMenu_AddButton(info, level);
			end -- for key,subsubarray
			end -- if level 2
			end -- function Test1_DropDown_Initialize

			To use the Menu, you can do

			local dropdown = CreateFrame("Frame", "Test_DropDown", UIParent, "UIDropDownMenuTemplate");
			UIDropDownMenu_Initialize(dropdown, Test1_DropDown_Initialize, "MENU");

			and you need something to active the menu, as with any menu

			ToggleDropDownMenu(1, nil, dropdown, self, -20, 0);