WoW:Using the Interface Options Addons panel - Revision history

Move page script: Move page script moved page Using the Interface Options Addons panel to WoW:Using the Interface Options Addons panel without leaving a redirect

2023-08-15T04:49:15Z

Move page script moved page Using the Interface Options Addons panel to Using the Interface Options Addons panel without leaving a redirect

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

WoWWiki>NightnessDev: /* Directly opening your options panel */

2018-12-24T08:37:35Z

Directly opening your options panel

← Older revision		Revision as of 08:37, 24 December 2018
Line 86:		Line 86:

	== Directly opening your options panel ==		== Directly opening your options panel ==
	If you wish to open your addon's options panel directly ~~– for example~~, ~~with a slash command –~~ you can do so by calling ~~a single~~ function:		If you wish to open your addon's options panel directly, you can do so by calling this function:

	InterfaceOptionsFrame_OpenToCategory(panel);		InterfaceOptionsFrame_OpenToCategory(panel);
Line 93:		Line 93:

	InterfaceOptionsFrame_OpenToCategory(panel.name);		InterfaceOptionsFrame_OpenToCategory(panel.name);

			Note: Call this function twice (in a row), there is a bug in Blizzard's code which makes the first call (after login or /reload) fail. It opens interface options but not on the addon's interface options; instead it opens the default interface options. If you call it twice in a row, it works as intended.

	== Removing an existing options panel ==		== Removing an existing options panel ==

WoWWiki>Raylan13: Reverted edit(s) by 195.37.208.218 (talk) to last version by Zasurus

2014-12-19T03:02:51Z

Reverted edit(s) by 195.37.208.218 (talk) to last version by Zasurus

← Older revision		Revision as of 03:02, 19 December 2014
Line 122:		Line 122:
	end;		end;

	This function takes two ~~parameter~~ "Parent" and "Child" and they are both strings:		This function takes two peramiters "Parent" and "Child" and they are both strings:
	* Parent is the name of the main panel (normally the name of the addon)		* Parent is the name of the main panel (normally the name of the addon)
	* Child is the name of any child panels you wish to remove		* Child is the name of any child panels you wish to remove
	If both Parent and Child are given then the function removes only the child panel from the parent. If however only the parent is given then the whole panel and all child panels are removed.		If both Parent and Child are given then the function removes only the child panel from the parent. If however only the parent is given then the whole panel and all child panels are removed.
	[[Category:HOWTOs\|Using the Interface Options Addons panel]]		[[Category:HOWTOs\|Using the Interface Options Addons panel]]

195.37.208.218: /* Removing an existing options panel */ typos fixed

2014-12-16T09:58:07Z

Removing an existing options panel: typos fixed

← Older revision		Revision as of 09:58, 16 December 2014
Line 122:		Line 122:
	end;		end;

	This function takes two ~~peramiters~~ "Parent" and "Child" and they are both strings:		This function takes two parameter "Parent" and "Child" and they are both strings:
	* Parent is the name of the main panel (normally the name of the addon)		* Parent is the name of the main panel (normally the name of the addon)
	* Child is the name of any child panels you wish to remove		* Child is the name of any child panels you wish to remove
	If both Parent and Child are given then the function removes only the child panel from the parent. If however only the parent is given then the whole panel and all child panels are removed.		If both Parent and Child are given then the function removes only the child panel from the parent. If however only the parent is given then the whole panel and all child panels are removed.
	[[Category:HOWTOs\|Using the Interface Options Addons panel]]		[[Category:HOWTOs\|Using the Interface Options Addons panel]]

WoWWiki>Zasurus: /* Removing an existing options panel */ Added this secion. Feel free to reword it or make it nicer ;-)

2010-10-03T15:55:33Z

Removing an existing options panel: Added this secion. Feel free to reword it or make it nicer ;-)

← Older revision		Revision as of 15:55, 3 October 2010
Line 93:		Line 93:

	InterfaceOptionsFrame_OpenToCategory(panel.name);		InterfaceOptionsFrame_OpenToCategory(panel.name);

			== Removing an existing options panel ==
			If you wish to remove any of the options panels for whatever reason after they have been created (maybe to modify another addon's options) there is no blizzard function avalible to do this but it can be done with the folowing function:

			function RemoveInterfaceOptions(Parent, Child)
			local bChildPanel = true;
			if (Child == nil) then -- Assume we are removing the whole panel if no child was specified
			Child = Parent;
			bChildPanel = false;
			AceConfigDialog3.BlizOptions[Parent] = nil;
			else
			AceConfigDialog3.BlizOptions[Parent][Parent.."\001".. Child] = nil;
			end;

			for Key,Value in pairs(INTERFACEOPTIONS_ADDONCATEGORIES) do
			if (bChildPanel and ((Value.parent == Parent) and (Value.name == Child))) then -- We are looking for a child panel and this is it...
			INTERFACEOPTIONS_ADDONCATEGORIES[Key] = nil;
			end;

			if (not(bChildPanel) and ((Value.parent == nil) and (Value.name == Child))) then -- We are looking for a parent and this is it...
			INTERFACEOPTIONS_ADDONCATEGORIES[Key] = nil;
			elseif (not(bChildPanel) and ((Value.parent == Parent))) then -- We are looking for a parent and this is it's child...
			INTERFACEOPTIONS_ADDONCATEGORIES[Key] = nil;
			end;
			end;

			InterfaceAddOnsList_Update();
			end;

			This function takes two peramiters "Parent" and "Child" and they are both strings:
			* Parent is the name of the main panel (normally the name of the addon)
			* Child is the name of any child panels you wish to remove
			If both Parent and Child are given then the function removes only the child panel from the parent. If however only the parent is given then the whole panel and all child panels are removed.
	[[Category:HOWTOs\|Using the Interface Options Addons panel]]		[[Category:HOWTOs\|Using the Interface Options Addons panel]]

WoWWiki>Tcaresset: /* The XML frame */ spelling

2010-08-09T19:20:30Z

The XML frame: spelling

← Older revision		Revision as of 19:20, 9 August 2010
Line 30:		Line 30:
	All we need to do first is to create the Frame. As we are using the Interface Options - Addon panels, we do not need to use any sizing or movement options.		All we need to do first is to create the Frame. As we are using the Interface Options - Addon panels, we do not need to use any sizing or movement options.

	The OnLoad script calls he Panel_OnLoad() function.		The OnLoad script calls the Panel_OnLoad() function.


Line 42:		Line 42:
	</Scripts>		</Scripts>
	</Frame>		</Frame>


	=== The Lua function ===		=== The Lua function ===

WoWWiki>Voyseys at 17:44, 10 July 2010

2010-07-10T17:44:50Z

← Older revision		Revision as of 17:44, 10 July 2010
Line 25:		Line 25:

	== Example XML with Okay and Cancel buttons ==		== Example XML with Okay and Cancel buttons ==
	This example is taken from an addon called SC_ChaChing, available from http://~~wow~~.~~curseforge~~.com/~~addons/sc_cha-ching/files/1-sc_cha-ching-1-0-2/~~.		This example is taken from an addon called SC_ChaChing, available from http://wowui.incgamers.com/?p=mod&m=4934.

	=== The XML frame ===		=== The XML frame ===
Line 94:		Line 94:

	InterfaceOptionsFrame_OpenToCategory(panel.name);		InterfaceOptionsFrame_OpenToCategory(panel.name);

	[[Category:HOWTOs\|Using the Interface Options Addons panel]]		[[Category:HOWTOs\|Using the Interface Options Addons panel]]

WoWWiki>Mortilus: /* Example entirely in Lua */

2010-05-19T16:21:09Z

Example entirely in Lua

← Older revision		Revision as of 16:21, 19 May 2010
Line 77:		Line 77:
	-- Add the panel to the Interface Options		-- Add the panel to the Interface Options
	InterfaceOptions_AddCategory(MyAddon.panel);		InterfaceOptions_AddCategory(MyAddon.panel);

			-- Make a child panel
			MyAddon.childpanel = CreateFrame( "Frame", "MyAddonChild", MyAddon.panel);
			MyAddon.childpanel.name = "MyChild";
			-- Specify childness of this panel (this puts it under the little red [+], instead of giving it a normal AddOn category)
			MyAddon.childpanel.parent = MyAddon.panel.name;
			-- Add the child to the Interface Options
			InterfaceOptions_AddCategory(MyAddon.childpanel);

	== Directly opening your options panel ==		== Directly opening your options panel ==

WoWWiki>Fric: edited the forum link

2009-12-02T08:20:02Z

edited the forum link

← Older revision		Revision as of 08:20, 2 December 2009
Line 3:		Line 3:
	As we use a Frame, we can do anything we like within it. Just like doing any other GUI Frame. You can also do sub-categories within these panels as well.		As we use a Frame, we can do anything we like within it. Just like doing any other GUI Frame. You can also do sub-categories within these panels as well.

	Most of this has been taken from One Blue post on the ''World of Warcraft'' Forums (http://forums.worldofwarcraft.com/thread.html?topicId=2968233433&sid=1&pageNo=15 ~~post~~ 294).		Most of this has been taken from One Blue post on the ''World of Warcraft'' Forums (http://forums.worldofwarcraft.com/thread.html?topicId=2968233433&sid=1&pageNo=15#294).

	== Description of the panel parts ==		== Description of the panel parts ==

WoWWiki>Blamdarot: added panel.refresh

2009-11-10T03:04:22Z

added panel.refresh

← Older revision		Revision as of 03:04, 10 November 2009
Line 20:		Line 20:
	:panel.parent'' - an optional string''		:panel.parent'' - an optional string''
	:::Name of the parent of the AddOn or group of configuration options. This identifies "panel" as the child of another category. If the parent category doesn't exist, "panel" will be displayed as a regular category.		:::Name of the parent of the AddOn or group of configuration options. This identifies "panel" as the child of another category. If the parent category doesn't exist, "panel" will be displayed as a regular category.

			:panel.refresh'' - Optional function()''
			:::This method will run when the Interface Options frame calls its OnShow function and after defaults have been applied via the panel.default method described above. Use this to refresh your panel's UI in case settings have been changed without player interaction. (-- from a post by Zootfizzle)

	== Example XML with Okay and Cancel buttons ==		== Example XML with Okay and Cancel buttons ==