1 --[[ $Id: AceGUIWidget-DropDown.lua 1029 2011-06-10 23:10:58Z nevcairiel $ ]]--
2 local AceGUI = LibStub("AceGUI-3.0")
5 local min, max, floor = math.min, math.max, math.floor
6 local select, pairs, ipairs, type = select, pairs, ipairs, type
7 local tsort = table.sort
10 local PlaySound = PlaySound
11 local UIParent, CreateFrame = UIParent, CreateFrame
14 -- Global vars/functions that we don't upvalue since they might get hooked, or upgraded
15 -- List them here for Mikk's FindGlobals script
18 local function fixlevels(parent,...)
20 local child = select(i, ...)
22 child:SetFrameLevel(parent:GetFrameLevel()+1)
23 fixlevels(child, child:GetChildren())
25 child = select(i, ...)
29 local function fixstrata(strata, parent, ...)
31 local child = select(i, ...)
32 parent:SetFrameStrata(strata)
34 fixstrata(strata, child, child:GetChildren())
36 child = select(i, ...)
41 local widgetType = "Dropdown-Pullout"
42 local widgetVersion = 3
47 bgFile = "Interface\\ChatFrame\\ChatFrameBackground",
48 edgeFile = "Interface\\DialogFrame\\UI-DialogBox-Border",
52 insets = { left = 11, right = 12, top = 12, bottom = 11 },
54 local sliderBackdrop = {
55 bgFile = "Interface\\Buttons\\UI-SliderBar-Background",
56 edgeFile = "Interface\\Buttons\\UI-SliderBar-Border",
57 tile = true, tileSize = 8, edgeSize = 8,
58 insets = { left = 3, right = 3, top = 3, bottom = 3 }
61 local defaultWidth = 200
62 local defaultMaxHeight = 600
64 --[[ UI Event Handlers ]]--
66 -- HACK: This should be no part of the pullout, but there
67 -- is no other 'clean' way to response to any item-OnEnter
68 -- Used to close Submenus when an other item is entered
69 local function OnEnter(item)
70 local self = item.pullout
71 for k, v in ipairs(self.items) do
72 if v.CloseMenu and v ~= item then
78 -- See the note in Constructor() for each scroll related function
79 local function OnMouseWheel(this, value)
80 this.obj:MoveScroll(value)
83 local function OnScrollValueChanged(this, value)
84 this.obj:SetScroll(value)
87 local function OnSizeChanged(this)
91 --[[ Exported methods ]]--
94 local function SetScroll(self, value)
95 local status = self.scrollStatus
96 local frame, child = self.scrollFrame, self.itemFrame
97 local height, viewheight = frame:GetHeight(), child:GetHeight()
100 if height > viewheight then
103 offset = floor((viewheight - height) / 1000 * value)
105 child:ClearAllPoints()
106 child:SetPoint("TOPLEFT", frame, "TOPLEFT", 0, offset)
107 child:SetPoint("TOPRIGHT", frame, "TOPRIGHT", self.slider:IsShown() and -12 or 0, offset)
108 status.offset = offset
109 status.scrollvalue = value
113 local function MoveScroll(self, value)
114 local status = self.scrollStatus
115 local frame, child = self.scrollFrame, self.itemFrame
116 local height, viewheight = frame:GetHeight(), child:GetHeight()
118 if height > viewheight then
122 local diff = height - viewheight
127 self.slider:SetValue(min(max(status.scrollvalue + delta*(1000/(diff/45)),0), 1000))
132 local function FixScroll(self)
133 local status = self.scrollStatus
134 local frame, child = self.scrollFrame, self.itemFrame
135 local height, viewheight = frame:GetHeight(), child:GetHeight()
136 local offset = status.offset or 0
138 if viewheight < height then
140 child:SetPoint("TOPRIGHT", frame, "TOPRIGHT", 0, offset)
141 self.slider:SetValue(0)
144 local value = (offset / (viewheight - height) * 1000)
145 if value > 1000 then value = 1000 end
146 self.slider:SetValue(value)
147 self:SetScroll(value)
149 child:ClearAllPoints()
150 child:SetPoint("TOPLEFT", frame, "TOPLEFT", 0, offset)
151 child:SetPoint("TOPRIGHT", frame, "TOPRIGHT", -12, offset)
152 status.offset = offset
157 -- exported, AceGUI callback
158 local function OnAcquire(self)
159 self.frame:SetParent(UIParent)
160 --self.itemFrame:SetToplevel(true)
163 -- exported, AceGUI callback
164 local function OnRelease(self)
166 self.frame:ClearAllPoints()
171 local function AddItem(self, item)
172 self.items[#self.items + 1] = item
174 local h = #self.items * 16
175 self.itemFrame:SetHeight(h)
176 self.frame:SetHeight(min(h + 34, self.maxHeight)) -- +34: 20 for scrollFrame placement (10 offset) and +14 for item placement
178 item.frame:SetPoint("LEFT", self.itemFrame, "LEFT")
179 item.frame:SetPoint("RIGHT", self.itemFrame, "RIGHT")
181 item:SetPullout(self)
182 item:SetOnEnter(OnEnter)
186 local function Open(self, point, relFrame, relPoint, x, y)
187 local items = self.items
188 local frame = self.frame
189 local itemFrame = self.itemFrame
191 frame:SetPoint(point, relFrame, relPoint, x, y)
195 for i, item in pairs(items) do
197 item:SetPoint("TOP", itemFrame, "TOP", 0, -2)
199 item:SetPoint("TOP", items[i-1].frame, "BOTTOM", 0, 1)
206 itemFrame:SetHeight(height)
207 fixstrata("TOOLTIP", frame, frame:GetChildren())
213 local function Close(self)
219 local function Clear(self)
220 local items = self.items
221 for i, item in pairs(items) do
228 local function IterateItems(self)
229 return ipairs(self.items)
233 local function SetHideOnLeave(self, val)
234 self.hideOnLeave = val
238 local function SetMaxHeight(self, height)
239 self.maxHeight = height or defaultMaxHeight
240 if self.frame:GetHeight() > height then
241 self.frame:SetHeight(height)
242 elseif (self.itemFrame:GetHeight() + 34) < height then
243 self.frame:SetHeight(self.itemFrame:GetHeight() + 34) -- see :AddItem
248 local function GetRightBorderWidth(self)
249 return 6 + (self.slider:IsShown() and 12 or 0)
253 local function GetLeftBorderWidth(self)
257 --[[ Constructor ]]--
259 local function Constructor()
260 local count = AceGUI:GetNextWidgetNum(widgetType)
261 local frame = CreateFrame("Frame", "AceGUI30Pullout"..count, UIParent)
264 self.type = widgetType
268 self.OnAcquire = OnAcquire
269 self.OnRelease = OnRelease
271 self.AddItem = AddItem
275 self.IterateItems = IterateItems
276 self.SetHideOnLeave = SetHideOnLeave
278 self.SetScroll = SetScroll
279 self.MoveScroll = MoveScroll
280 self.FixScroll = FixScroll
282 self.SetMaxHeight = SetMaxHeight
283 self.GetRightBorderWidth = GetRightBorderWidth
284 self.GetLeftBorderWidth = GetLeftBorderWidth
288 self.scrollStatus = {
292 self.maxHeight = defaultMaxHeight
294 frame:SetBackdrop(backdrop)
295 frame:SetBackdropColor(0, 0, 0)
296 frame:SetFrameStrata("FULLSCREEN_DIALOG")
297 frame:SetClampedToScreen(true)
298 frame:SetWidth(defaultWidth)
299 frame:SetHeight(self.maxHeight)
300 --frame:SetToplevel(true)
302 -- NOTE: The whole scroll frame code is copied from the AceGUI-3.0 widget ScrollFrame
303 local scrollFrame = CreateFrame("ScrollFrame", nil, frame)
304 local itemFrame = CreateFrame("Frame", nil, scrollFrame)
306 self.scrollFrame = scrollFrame
307 self.itemFrame = itemFrame
309 scrollFrame.obj = self
312 local slider = CreateFrame("Slider", "AceGUI30PulloutScrollbar"..count, scrollFrame)
313 slider:SetOrientation("VERTICAL")
314 slider:SetHitRectInsets(0, 0, -10, 0)
315 slider:SetBackdrop(sliderBackdrop)
317 slider:SetThumbTexture("Interface\\Buttons\\UI-SliderBar-Button-Vertical")
318 slider:SetFrameStrata("FULLSCREEN_DIALOG")
322 scrollFrame:SetScrollChild(itemFrame)
323 scrollFrame:SetPoint("TOPLEFT", frame, "TOPLEFT", 6, -12)
324 scrollFrame:SetPoint("BOTTOMRIGHT", frame, "BOTTOMRIGHT", -6, 12)
325 scrollFrame:EnableMouseWheel(true)
326 scrollFrame:SetScript("OnMouseWheel", OnMouseWheel)
327 scrollFrame:SetScript("OnSizeChanged", OnSizeChanged)
328 scrollFrame:SetToplevel(true)
329 scrollFrame:SetFrameStrata("FULLSCREEN_DIALOG")
331 itemFrame:SetPoint("TOPLEFT", scrollFrame, "TOPLEFT", 0, 0)
332 itemFrame:SetPoint("TOPRIGHT", scrollFrame, "TOPRIGHT", -12, 0)
333 itemFrame:SetHeight(400)
334 itemFrame:SetToplevel(true)
335 itemFrame:SetFrameStrata("FULLSCREEN_DIALOG")
337 slider:SetPoint("TOPLEFT", scrollFrame, "TOPRIGHT", -16, 0)
338 slider:SetPoint("BOTTOMLEFT", scrollFrame, "BOTTOMRIGHT", -16, 0)
339 slider:SetScript("OnValueChanged", OnScrollValueChanged)
340 slider:SetMinMaxValues(0, 1000)
341 slider:SetValueStep(1)
350 AceGUI:RegisterAsWidget(self)
354 AceGUI:RegisterWidgetType(widgetType, Constructor, widgetVersion)
358 local widgetType = "Dropdown"
359 local widgetVersion = 25
361 --[[ Static data ]]--
363 --[[ UI event handler ]]--
365 local function Control_OnEnter(this)
366 this.obj:Fire("OnEnter")
369 local function Control_OnLeave(this)
370 this.obj:Fire("OnLeave")
373 local function Dropdown_OnHide(this)
374 local self = this.obj
380 local function Dropdown_TogglePullout(this)
381 local self = this.obj
382 PlaySound("igMainMenuOptionCheckBoxOn") -- missleading name, but the Blizzard code uses this sound
389 self.pullout:SetWidth(self.frame:GetWidth())
390 self.pullout:Open("TOPLEFT", self.frame, "BOTTOMLEFT", 0, self.label:IsShown() and -2 or 0)
391 AceGUI:SetFocus(self)
395 local function OnPulloutOpen(this)
396 local self = this.userdata.obj
397 local value = self.value
399 if not self.multiselect then
400 for i, item in this:IterateItems() do
401 item:SetValue(item.userdata.value == value)
408 local function OnPulloutClose(this)
409 local self = this.userdata.obj
411 self:Fire("OnClosed")
414 local function ShowMultiText(self)
416 for i, widget in self.pullout:IterateItems() do
417 if widget.type == "Dropdown-Item-Toggle" then
418 if widget:GetValue() then
420 text = text..", "..widget:GetText()
422 text = widget:GetText()
430 local function OnItemValueChanged(this, event, checked)
431 local self = this.userdata.obj
433 if self.multiselect then
434 self:Fire("OnValueChanged", this.userdata.value, checked)
438 self:SetValue(this.userdata.value)
439 self:Fire("OnValueChanged", this.userdata.value)
449 --[[ Exported methods ]]--
451 -- exported, AceGUI callback
452 local function OnAcquire(self)
453 local pullout = AceGUI:Create("Dropdown-Pullout")
454 self.pullout = pullout
455 pullout.userdata.obj = self
456 pullout:SetCallback("OnClose", OnPulloutClose)
457 pullout:SetCallback("OnOpen", OnPulloutOpen)
458 self.pullout.frame:SetFrameLevel(self.frame:GetFrameLevel() + 1)
459 fixlevels(self.pullout.frame, self.pullout.frame:GetChildren())
466 -- exported, AceGUI callback
467 local function OnRelease(self)
471 AceGUI:Release(self.pullout)
475 self:SetDisabled(false)
476 self:SetMultiselect(false)
483 self.frame:ClearAllPoints()
488 local function SetDisabled(self, disabled)
489 self.disabled = disabled
491 self.text:SetTextColor(0.5,0.5,0.5)
492 self.button:Disable()
493 self.label:SetTextColor(0.5,0.5,0.5)
496 self.label:SetTextColor(1,.82,0)
497 self.text:SetTextColor(1,1,1)
502 local function ClearFocus(self)
509 local function SetText(self, text)
510 self.text:SetText(text or "")
514 local function SetLabel(self, text)
515 if text and text ~= "" then
516 self.label:SetText(text)
518 self.dropdown:SetPoint("TOPLEFT",self.frame,"TOPLEFT",-15,-18)
520 self.alignoffset = 30
522 self.label:SetText("")
524 self.dropdown:SetPoint("TOPLEFT",self.frame,"TOPLEFT",-15,0)
526 self.alignoffset = 12
531 local function SetValue(self, value)
533 self:SetText(self.list[value] or "")
539 local function GetValue(self)
544 local function SetItemValue(self, item, value)
545 if not self.multiselect then return end
546 for i, widget in self.pullout:IterateItems() do
547 if widget.userdata.value == item then
548 if widget.SetValue then
549 widget:SetValue(value)
557 local function SetItemDisabled(self, item, disabled)
558 for i, widget in self.pullout:IterateItems() do
559 if widget.userdata.value == item then
560 widget:SetDisabled(disabled)
565 local function AddListItem(self, value, text, itemType)
566 if not itemType then itemType = "Dropdown-Item-Toggle" end
567 local exists = AceGUI:GetWidgetVersion(itemType)
568 if not exists then error(("The given item type, %q, does not exist within AceGUI-3.0"):format(tostring(itemType)), 2) end
570 local item = AceGUI:Create(itemType)
572 item.userdata.obj = self
573 item.userdata.value = value
574 item:SetCallback("OnValueChanged", OnItemValueChanged)
575 self.pullout:AddItem(item)
578 local function AddCloseButton(self)
579 if not self.hasClose then
580 local close = AceGUI:Create("Dropdown-Item-Execute")
582 self.pullout:AddItem(close)
589 local function SetList(self, list, order, itemType)
593 if not list then return end
595 if type(order) ~= "table" then
596 for v in pairs(list) do
597 sortlist[#sortlist + 1] = v
601 for i, key in ipairs(sortlist) do
602 AddListItem(self, key, list[key], itemType)
606 for i, key in ipairs(order) do
607 AddListItem(self, key, list[key], itemType)
610 if self.multiselect then
617 local function AddItem(self, value, text, itemType)
619 self.list[value] = text
620 AddListItem(self, value, text, itemType)
625 local function SetMultiselect(self, multi)
626 self.multiselect = multi
634 local function GetMultiselect(self)
635 return self.multiselect
638 --[[ Constructor ]]--
640 local function Constructor()
641 local count = AceGUI:GetNextWidgetNum(widgetType)
642 local frame = CreateFrame("Frame", nil, UIParent)
643 local dropdown = CreateFrame("Frame", "AceGUI30DropDown"..count, frame, "UIDropDownMenuTemplate")
646 self.type = widgetType
648 self.dropdown = dropdown
653 self.OnRelease = OnRelease
654 self.OnAcquire = OnAcquire
656 self.ClearFocus = ClearFocus
658 self.SetText = SetText
659 self.SetValue = SetValue
660 self.GetValue = GetValue
661 self.SetList = SetList
662 self.SetLabel = SetLabel
663 self.SetDisabled = SetDisabled
664 self.AddItem = AddItem
665 self.SetMultiselect = SetMultiselect
666 self.GetMultiselect = GetMultiselect
667 self.SetItemValue = SetItemValue
668 self.SetItemDisabled = SetItemDisabled
670 self.alignoffset = 30
672 frame:SetScript("OnHide",Dropdown_OnHide)
674 dropdown:ClearAllPoints()
675 dropdown:SetPoint("TOPLEFT",frame,"TOPLEFT",-15,0)
676 dropdown:SetPoint("BOTTOMRIGHT",frame,"BOTTOMRIGHT",17,0)
677 dropdown:SetScript("OnHide", nil)
679 local left = _G[dropdown:GetName() .. "Left"]
680 local middle = _G[dropdown:GetName() .. "Middle"]
681 local right = _G[dropdown:GetName() .. "Right"]
683 middle:ClearAllPoints()
684 right:ClearAllPoints()
686 middle:SetPoint("LEFT", left, "RIGHT", 0, 0)
687 middle:SetPoint("RIGHT", right, "LEFT", 0, 0)
688 right:SetPoint("TOPRIGHT", dropdown, "TOPRIGHT", 0, 17)
690 local button = _G[dropdown:GetName() .. "Button"]
693 button:SetScript("OnEnter",Control_OnEnter)
694 button:SetScript("OnLeave",Control_OnLeave)
695 button:SetScript("OnClick",Dropdown_TogglePullout)
697 local text = _G[dropdown:GetName() .. "Text"]
700 text:ClearAllPoints()
701 text:SetPoint("RIGHT", right, "RIGHT" ,-43, 2)
702 text:SetPoint("LEFT", left, "LEFT", 25, 2)
704 local label = frame:CreateFontString(nil,"OVERLAY","GameFontNormalSmall")
705 label:SetPoint("TOPLEFT",frame,"TOPLEFT",0,0)
706 label:SetPoint("TOPRIGHT",frame,"TOPRIGHT",0,0)
707 label:SetJustifyH("LEFT")
712 AceGUI:RegisterAsWidget(self)
716 AceGUI:RegisterWidgetType(widgetType, Constructor, widgetVersion)