WoW:API CreateFrame

Reference e
AddOns WoW API Widget API XML UI Event API WoW Lua Macro API CVars Battle.net HOWTOs Snippets UI tech Categories

→ WoW API

← WoW API < CreateFrame

Creates a new UI frame.

newFrame = CreateFrame("frameType"[, "frameName"[, parentFrame[, "inheritsFrame"]]]);

Parameters

Arguments

frameType

String - Type of the frame to be created (XML tag name): "Frame", "Button", etc. See UIOBJECT_Frame

frameName

String - Name of the newly created frame. If nil, no frame name is assigned. The function will also set a global variable of this name to point to the newly created frame.

parentFrame

Frame - The frame object that will be used as the created Frame's parent (cannot be a string!) Does not default to UIParent if given nil.

inheritsFrame

String - a comma-delimited list of names of virtual frames to inherit from (the same as in XML). If nil, no frames will be inherited. These frames cannot be frames that were created using this function, they must be created using XML with virtual="true" in the tag.

Returns

newFrame

Frame - Reference to the newly created frame.

Example

Result: displays the horde and alliance insignias in the middle of the screen.

local f = CreateFrame("Frame",nil,UIParent)
f:SetFrameStrata("BACKGROUND")
f:SetWidth(128) -- Set these to whatever height/width is needed 
f:SetHeight(64) -- for your Texture

local t = f:CreateTexture(nil,"BACKGROUND")
t:SetTexture("Interface\\Glues\\CharacterCreate\\UI-CharacterCreate-Factions.blp")
t:SetAllPoints(f)
f.texture = t

f:SetPoint("CENTER",0,0)
f:Show()

Notes

• CreateFrame() was added in 1.10
• The fourth argument, inheritFrame, was added in 1.11
• Frames CANNOT be deleted. Reuse them.
• The frame's OnLoad handler, which will only exist if inherited, will be executed during the CreateFrame call. Any OnLoad script handlers set after CreateFrame() will not execute; consider adding any non-inherited OnLoad code directly after a CreateFrame call or use XML frames instead.
• The returned frame reference is not strictly necessary because you can access frames by their global name if you give them one. For performance reasons, however, it is advised to store frame references in local variables and use those instead of getting frames by their global name.
• See also API_Frame_SetScript to handle OnFunction scripts when not using a template.
• The most common uses for this function are:
  • Creating anonymous event handlers.
  • Creating anonymous script handlers.
  • Creating frames on the fly for occasions when you don't know how many frames will be needed.
  • Creating infrequently used frames "on demand", for example: config dialogs, raid frames.
• Never forget to unset the frames parent, if you want to get rid of a frame. I would suggest to hide the frame via frame:Hide() and to use frame:SetParent(nil) afterward (this will remove the frame from its parents child list). If you just hide the frame without this additional step, frames created afterward will get a higher framelevel than the hidden one. After a while, you will get frames at maximum framelevel which are likely to be drawn in a distorted way (false order caused by equal framelevel).