WoW:SecureUnitButtonTemplate - Revision history

Move page script: Move page script moved page SecureUnitButtonTemplate to WoW:SecureUnitButtonTemplate without leaving a redirect

2023-08-15T04:48:57Z

Move page script moved page SecureUnitButtonTemplate to SecureUnitButtonTemplate without leaving a redirect

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

Bear at 07:00, 18 May 2020

2020-05-18T07:00:35Z

← Older revision		Revision as of 07:00, 18 May 2020
Line 1:		Line 1:
	{{uitech}}		{{uitech}}
	'''SecureUnitButtonTemplate''' is one of the SecureTemplates introduced in [[Patch 2.0]]. It's purpose is to allow creation of unit frames, executing certain protected actions from secure code in response to clicks.		'''SecureUnitButtonTemplate''' is one of the SecureTemplates introduced in Patch 2.0. It's purpose is to allow creation of unit frames, executing certain protected actions from secure code in response to clicks.

	This template's behavior differs only slightly from [[SecureActionButtonTemplate]], and can be thought of as a special case. The only difference is in how the menu function is handled: the template allows spells currently being targeted to be cancelled before calling the menu function.		This template's behavior differs only slightly from [[SecureActionButtonTemplate]], and can be thought of as a special case. The only difference is in how the menu function is handled: the template allows spells currently being targeted to be cancelled before calling the menu function.

WoWWiki>Starlightblunder: argument list

2010-09-10T21:05:56Z

argument list

← Older revision		Revision as of 21:05, 10 September 2010
Line 10:		Line 10:
	:; unit : String - unit this unit frame is showing/acting on.		:; unit : String - unit this unit frame is showing/acting on.
	:; menuFunc : Function - menu function to show when the frame is right clicked.		:; menuFunc : Function - menu function to show when the frame is right clicked.
	The function sets a limited number of attributes on a frame to make it behave like the default unit frames: left clicks target the unit, and right clicks open the menu by calling menuFunc ~~with~~ (self, button~~) arguments (''possibly incorrect, see discussion''~~).		The function sets a limited number of attributes on a frame to make it behave like the default unit frames: left clicks target the unit, and right clicks open the menu by calling menuFunc(self, unit, button).

WoWWiki>BobClown: menufunc parameters?

2010-09-10T06:51:47Z

menufunc parameters?

← Older revision		Revision as of 06:51, 10 September 2010
Line 10:		Line 10:
	:; unit : String - unit this unit frame is showing/acting on.		:; unit : String - unit this unit frame is showing/acting on.
	:; menuFunc : Function - menu function to show when the frame is right clicked.		:; menuFunc : Function - menu function to show when the frame is right clicked.
	The function sets a limited number of attributes on a frame to make it behave like the default unit frames: left clicks target the unit, and right clicks open the menu by calling menuFunc with (self, button) arguments.		The function sets a limited number of attributes on a frame to make it behave like the default unit frames: left clicks target the unit, and right clicks open the menu by calling menuFunc with (self, button) arguments (''possibly incorrect, see discussion'').

WoWWiki>Starlightblunder: Created page with '{{uitech}} '''SecureUnitButtonTemplate''' is one of the SecureTemplates introduced in Patch 2.0. It's purpose is to allow creation of unit frames, executing certain protected...'

2009-06-01T20:29:04Z

Created page with '{{uitech}} '''SecureUnitButtonTemplate''' is one of the SecureTemplates introduced in Patch 2.0. It's purpose is to allow creation of unit frames, executing certain protected...'

New page

{{uitech}}
'''SecureUnitButtonTemplate''' is one of the SecureTemplates introduced in [[Patch 2.0]]. It's purpose is to allow creation of unit frames, executing certain protected actions from secure code in response to clicks.

This template's behavior differs only slightly from [[SecureActionButtonTemplate]], and can be thought of as a special case. The only difference is in how the menu function is handled: the template allows spells currently being targeted to be cancelled before calling the menu function.

== Supporting API ==
FrameXML defines a convenience method to interact with this template:
'''SecureUnitButton_OnLoad'''(self, unit, menufunc)
:; self : Frame - frame inheriting from SecureUnitButtonTemplate.
:; unit : String - unit this unit frame is showing/acting on.
:; menuFunc : Function - menu function to show when the frame is right clicked.
The function sets a limited number of attributes on a frame to make it behave like the default unit frames: left clicks target the unit, and right clicks open the menu by calling menuFunc with (self, button) arguments.

Another useful function is {{api|RegisterUnitWatch}}(frame), which controls the visibility of a protected frame based on whether the unit specified by the frame's "unit" attribute exists.

== Supported Attributes ==
The template supports all of the attributes supported by [[SecureActionButtonTemplate]], and behaves in similar fashion. There is a single special case: if the value of the [[SecureActionButtonTemplate#Modified attributes|modified attribute]] "type" is "menu" (with no unit remapping performed), the OnClick cancels any spell being targeted and calls menuFunc().

[[SecureActionButtonTemplate#Other attributes|Some attributes]] may be used to enable automatic vehicle unit remapping for the frame: making the player frame behave as a vehicle frame, and a pet frame behave as a player frame when the player is in a vehicle.

{{API Trail Secure}}