oqueue_ui_tools.lua

--[[ 
  @file       oqueue_ui_tools.lua
  @brief      various ui functions

  @author     rmcinnis
  @date       april 06, 2012
  @copyright  Solid ICE Technologies
              this file may be distributed so long as it remains unaltered
              if this file is posted to a web site, credit must be given to me along with a link to my web page
              no code in this file may be used in other works without expressed permission  
]]--
local addonName, OQ = ... ;
local oq = OQ:mod() ; -- thank goodness i stumbled across this trick
local _ ; -- throw away (was getting taint warning; what happened blizz?)
if (OQ.table == nil) then
  OQ.table = {} ;
end
local tbl = OQ.table ;

OQ.MENU_DISPLAY_TM  = 3 ;
OQ.BUTTON_SZ        = 32 ;
OQ.MAX_MENU_OPTIONS = 20 ;
OQ.DOWNARROW_DOWN   = "INTERFACE/CHATFRAME/UI-ChatIcon-ScrollDown-Down" ;
OQ.DOWNARROW_UP     = "INTERFACE/CHATFRAME/UI-ChatIcon-ScrollDown-Up" ;
OQ.BUTTON_PREV_DN   = "INTERFACE/BUTTONS/UI-SpellbookIcon-PrevPage-Down" ;
OQ.BUTTON_PREV_UP   = "INTERFACE/BUTTONS/UI-SpellbookIcon-PrevPage-Up" ;
OQ.BUTTON_NEXT_DN   = "INTERFACE/BUTTONS/UI-SpellbookIcon-NextPage-Down" ;
OQ.BUTTON_NEXT_UP   = "INTERFACE/BUTTONS/UI-SpellbookIcon-NextPage-Up" ;
OQ.BUTTON_PREV_DISABLED  = "INTERFACE/BUTTONS/UI-SpellbookIcon-PrevPage-Disabled" ;
OQ.BUTTON_NEXT_DISABLED  = "INTERFACE/BUTTONS/UI-SpellbookIcon-NextPage-Disabled" ;

function oq.save_position( f ) 
  if (f._save_position) then
    f._save_position( f ) ;
  end
end


function oq.moveto( f, x, y ) 
f.__x = x ;
f.__y = y ;

  if (y >= 0) then
    if (x >= 0) then 
      f:SetPoint("TOPLEFT",f:GetParent(),"TOPLEFT", x, -1 * y)
    else
      f:SetPoint("TOPRIGHT",f:GetParent(),"TOPRIGHT", x, -1 * y)
    end
  else
    if (x >= 0) then 
      f:SetPoint("BOTTOMLEFT",f:GetParent(),"BOTTOMLEFT", x, -1 * y)
    else
      f:SetPoint("BOTTOMRIGHT",f:GetParent(),"BOTTOMRIGHT", x, -1 * y)
    end
  end
end

function oq.setpos( f, x, y, cx, cy )
  oq.moveto( f, x, y ) ;
  if (cx ~= nil) and (cx > 0) then
    f:SetWidth(cx) ;
  end
  if (cy ~= nil) and (cy > 0) then
    f:SetHeight(cy) ;
  end
  return f ;
end

function oq.set_tab_order( a, b )
  a.next_edit = b ;
  b.prev_edit = a ;
  a:SetScript( "OnTabPressed", 
               function(self) 
                 if (IsShiftKeyDown() == 1) and (self.prev_edit ~= nil) then
                   self.prev_edit:SetFocus()  
                 elseif (self.next_edit ~= nil) then  
                   self.next_edit:SetFocus()  
                 end  
                end 
             ) ;
end

-- dump a count of frame types ready for reuse
--
function oq.frame_report()
  print( "--[ frame dump ]--" ) ;
  for i,v in pairs(oq.__frame_pool) do
    print( "  ".. tostring(i) .."  #".. tbl.size(v) ) ;
  end
  print( "--" ) ;
end

function oq.DeleteFrame( f ) 
  if (f == nil) then
    return ;
  end
  f:Hide() ;
  f:SetParent(nil) ;
  oq.__frame_pool[f:GetObjectType()][f] = true ;
end

function oq.CreateFrame( type, name, parent, template )
  if (oq.__frame_pool == nil) then
    oq.__frame_pool = tbl.new() ;
  end
  if (oq.__frame_pool[type] == nil) then
    oq.__frame_pool[type] = tbl.new() ;
  end
  local f = next(oq.__frame_pool[type]) ;
  if (f) then
    oq.__frame_pool[type][f] = nil ;
    f:SetParent( parent ) ;
    -- what about name and template?
  else
    f = CreateFrame( type, name, parent, template ) ;
  end
  if (parent ~= nil) then
    f:SetFrameLevel( parent:GetFrameLevel() + 1 ) ;
  end
  return f ;
end

function oq.editline( parent, name, x, y, cx, cy, max_chars )
  oq.nthings = (oq.nthings or 0) + 1 ;
  local n = "OQ_".. name .."".. oq.nthings ;
  local e = oq.CreateFrame("EditBox", n, parent, "InputBoxTemplate" )
  e:SetPoint("TOPLEFT", parent, "TOPLEFT", 0,0 ) ; 
  e:SetText( "" ) ;
  e:SetAutoFocus(false)
  e:SetFontObject("GameFontNormal")
  e:SetMaxLetters(max_chars or 30)
  e:SetCursorPosition(0) ;
  e:SetTextColor( 0.9, 0.9, 0.9, 1 ) ;
  e.str = "" ;
  e:SetScript( "OnTextChanged"  , function(self) self.str = self:GetText() or "" ; if (self.func ~= nil) then self.func(self.str) ; end end ) ;
  e:SetScript( "OnEscapePressed", function(self) self:ClearFocus() end ) ;
  oq.setpos( e, x, y, cx, cy ) ;
  e:Show() ;
  return e ;
end

function oq.editbox( parent, name, x, y, cx, cy, max_chars, func, init_val )
  oq.nthings = (oq.nthings or 0) + 1 ;
  local n = "OQ_".. name .."".. oq.nthings ;
  local e = oq.CreateFrame("EditBox", n, parent ) ;
  e:SetMultiLine(true) ;
  e:SetPoint("TOPLEFT", parent, "TOPLEFT", x,-y ) ; 
  e:SetPoint("BOTTOMRIGHT", parent, "TOPLEFT", x+cx,-y-cy ) ; 
  e.str = init_val or "" ;
  e.func = func ;
  e:SetScript( "OnTextChanged"  , function(self) self.str = self:GetText() or "" ; if (self.func ~= nil) then self.func(self.str) ; end end ) ;
  e:SetScript( "OnEscapePressed", function(self) self:ClearFocus() end ) ;
  e:SetText(init_val or "" ) ;
  e:SetBackdrop({bgFile="Interface/Tooltips/UI-Tooltip-Background", 
                 edgeFile="Interface/Tooltips/UI-Tooltip-Border", 
                 tile=true, tileSize = 16, edgeSize = 16,
                 insets = { left = 1, right = 1, top = 1, bottom = 1 }
                 })

  e:SetBackdropColor(0.0,0.0,0.0,1.0);
  e:SetAlpha( 0.8 ) ;
  e:SetAutoFocus(false) ;
  e:SetFontObject("GameFontNormal") ;
  e:SetMaxLetters(max_chars or 30) ;
  e:SetCursorPosition(0) ;
  e:SetTextColor( 0.9, 0.9, 0.9, 1 ) ;
  e:SetTextInsets(5, 5, 5, 5) ;
  oq.setpos( e, x-4, y, cx, cy ) ;
  e:Show() ;
  return e ;
end

function oq.checkbox( parent, x, y, cx, cy, text_cx, text, is_checked, on_click_func )
  oq.nthings = (oq.nthings or 0) + 1 ;
  local n = "OQ_Check".. oq.nthings ;
  local button = oq.CreateFrame("CheckButton", n, parent, "UICheckButtonTemplate")
  button:SetWidth(cx)
  button:SetHeight(cy)
  button.string = button:CreateFontString()
  button.string:SetWidth(text_cx)
  button.string:SetJustifyH("LEFT")
  button.string:SetPoint("LEFT", 24, 1)
  button:SetFontString(button.string)
  button:SetNormalFontObject("GameFontNormalSmall")
  button:SetHighlightFontObject("GameFontHighlightSmall")
  button:SetDisabledFontObject("GameFontDisableSmall")
  button:SetText(text)
  button:SetScript("OnClick", on_click_func )
  if (is_checked == 0) then
    is_checked = nil ;
  end
  button:SetChecked( is_checked ) ;
  oq.moveto( button, x, y ) ;
  button:Show() 
  button:SetScript("OnEnter", function(self, ...) oq.hint(self, self.tt, true) ; end ) ;
  button:SetScript("OnLeave", function(self, ...) oq.hint(self, self.tt, nil ) ; end ) ;
  return button ;
end

function oq.radiobutton( parent, x, y, cx, cy, text_cx, text, value, on_click_func )
  oq.nthings = (oq.nthings or 0) + 1 ;
  local n = "OQ_RadioButton".. oq.nthings ;
  button = oq.CreateFrame("CheckButton", n, parent, "UIRadioButtonTemplate")
  button:SetWidth(cx)
  button:SetHeight(cy)
  button.value = value ;
  button.string = button:CreateFontString()
  button.string:SetWidth(text_cx)
  button.string:SetJustifyH("LEFT")
  button.string:SetPoint("LEFT", 24, 1)
  button:SetFontString(button.string)
  button:SetNormalFontObject("GameFontNormalSmall")
  button:SetHighlightFontObject("GameFontHighlightSmall")
  button:SetDisabledFontObject("GameFontDisableSmall")
  button:SetText(text)
  button:SetScript("OnClick", function(self) on_click_func( self ) ; end )
  button:SetChecked( nil ) ;
  oq.moveto( button, x, y ) ;
  button:Show() 
  return button ;
end

function oq.click_label( parent, x, y, cx, cy, text, justify_v, justify_h, font, template )
  oq.nthings = (oq.nthings or 0) + 1 ;
  local name = "OQClikLabel".. oq.nthings ;
  local f = oq.CreateFrame("Button", name, parent, template )
  f:SetWidth (cx) ; -- Set these to whatever height/width is needed 
  f:SetHeight(cy) ; -- for your Texture
  f:SetBackdropColor(0.2,0.9,0.2,1.0); -- transparent

  f:SetPoint( "TOPLEFT", x, -1 * y) ;
  f.label = oq.label( f, 0, 0, cx, cy, text, justify_v, justify_h, font ) ;
  f:Show()
  return f ;
end

function oq.label( parent, x, y, cx, cy, text, justify_v, justify_h, font, strata )
  local label = parent:CreateFontString( nil, strata or "ARTWORK", font or "GameFontNormalSmall")
  label:SetWidth( cx ) ;
  label:SetHeight(cy or 25)
  label:SetJustifyV( justify_v or "MIDDLE" )
  label:SetJustifyH( justify_h or "LEFT" )
  label:SetText( text )
  label:Show() 
  oq.moveto( label, x, y ) ;
  return label ;
end

function oq.panel( parent, name, x, y, cx, cy, no_texture )
  local f = oq.CreateFrame("FRAME", "$parent".. name, parent )
  f:SetWidth (cx) ; -- Set these to whatever height/width is needed 
  f:SetHeight(cy) ; -- for your Texture
  f:SetBackdropColor(0.2,0.2,0.2,1.0);

  if (not no_texture) then
    local t = f:CreateTexture(nil,"BACKGROUND") ;
    t:SetAllPoints(f) ;
    t:SetDrawLayer("BACKGROUND") ;
    f.texture = t ;
  end

  f:SetPoint( "TOPLEFT", x, -1 * y) ;
  return f ;
end

function oq.texture( parent, x, y, cx, cy, texture )
  oq.nthings = (oq.nthings or 0) + 1 ;
  local name = "OQ_Texture".. oq.nthings ;

  local f = oq.CreateFrame("FRAME", name, parent )
  f:SetWidth(cx) ;
  f:SetHeight(cy) ;
  f:SetBackdropColor(0.2,0.2,0.2,1.0) ;

  local t = f:CreateTexture( nil, "BACKGROUND" ) ;
  t:SetTexture( texture ) ;
  t:SetAllPoints( f ) ;
  t:SetAlpha( 1.0 ) ;
  f.texture = t ;

  f:SetPoint( "TOPLEFT", x, -1 * y ) ;
  f:Show() ;
  return f ;
end

function oq.texture_button( parent, x, y, cx, cy, up_texture, dn_texture, disable_texture )
  oq.nthings = (oq.nthings or 0) + 1 ;
  local name = "OQ_TexturedButton".. oq.nthings ;

  local f = oq.CreateFrame("BUTTON", name, parent )
  f:SetWidth(cx) ;
  f:SetHeight(cy) ;
  f:SetBackdropColor(0.2,0.2,0.2,1.0) ;
  f:SetText( "" ) ;
  f._dn_texture = dn_texture ;
  f._up_texture = up_texture ;
  f._disable_texture = disable_texture ;
  f:SetScript("OnMouseDown", function(self, button) 
                               if (self._dn_texture) and (self:IsEnabled()) then 
                                 self.texture:SetTexture( self._dn_texture ) ; 
                               end 
                             end ) ;
  f:SetScript("OnMouseUp", function(self, button) 
                             if (self._up_texture) and (self:IsEnabled()) then 
                               self.texture:SetTexture( self._up_texture ) ; 
                             end 
                           end ) ;

  local t = f:CreateTexture( nil, "BACKGROUND" ) ;
  t:SetTexture( up_texture ) ;
  t:SetAllPoints( f ) ;
  t:SetAlpha( 1.0 ) ;
  f.texture = t ;

  f:SetPoint( "TOPLEFT", x, -1 * y ) ;
  f:Show() ;
  return f ;
end

function oq.next_button( parent, x, y, func ) 
  local f = oq.texture_button( parent, x, y, OQ.BUTTON_SZ, OQ.BUTTON_SZ, OQ.BUTTON_NEXT_UP, OQ.BUTTON_NEXT_DN, OQ.BUTTON_NEXT_DISABLED ) ;
  f:SetScript( "OnClick", func ) ;
  return f ;
end

function oq.prev_button( parent, x, y, func ) 
  local f = oq.texture_button( parent, x, y, OQ.BUTTON_SZ, OQ.BUTTON_SZ, OQ.BUTTON_PREV_UP, OQ.BUTTON_PREV_DN, OQ.BUTTON_PREV_DISABLED ) ;
  f:SetScript( "OnClick", func ) ;
  return f ;
end

function oq.button_enable( f )
  if (f == nil) then
    return ;
  end
  f.texture:SetTexture( f._up_texture ) ; 
  f:Enable() ;
end

function oq.button_disable( f )
  if (f == nil) then
    return ;
  end
  f.texture:SetTexture( f._disable_texture ) ; 
  f:Disable() ;
end

function oq.button( parent, x, y, cx, cy, text, on_click_func )
  oq.nthings = (oq.nthings or 0) + 1 ;
  local button = oq.CreateFrame("Button", "$parent".. "Button".. oq.nthings, parent, "UIPanelButtonTemplate")

  button:SetWidth(cx)
  button:SetHeight(cy)
  button:SetNormalFontObject("GameFontNormalSmall")
  button:SetHighlightFontObject("GameFontHighlightSmall")
  button:SetDisabledFontObject("GameFontDisableSmall")
  button:SetText( text )
  button:SetScript("OnClick", on_click_func )
  oq.moveto( button, x, y ) ;
  button:Show() 
  button:SetScript("OnEnter", function(self, ...) oq.hint(self, self.tt, true) ; end ) ;
  button:SetScript("OnLeave", function(self, ...) oq.hint(self, self.tt, nil ) ; end ) ;

  return button ;
end

function oq.button2( parent, x, y, cx, cy, text, font_sz, on_click_func )
  oq.nthings = (oq.nthings or 0) + 1 ;
  local button = oq.CreateFrame("Button", "$parent".. "Button".. oq.nthings, parent, "UIPanelButtonTemplate")

  button:SetWidth(cx)
  button:SetHeight(cy)
  button.string = button:CreateFontString()
  button.string:SetJustifyH("CENTER")
  button.string:SetPoint("CENTER", 0, 0)
  button.font_sz = font_sz or 11 ;
  button.string:SetFont(OQ.FONT, button.font_sz, "") ;
  button:SetFontString(button.string)
  button:SetText( text )
  button:SetScript("OnClick", on_click_func )
  oq.moveto( button, x, y ) ;
  button:Show() ;
  button:SetScript("OnEnter", function(self, ...) oq.hint(self, self.tt, true) ; end ) ;
  button:SetScript("OnLeave", function(self, ...) oq.hint(self, self.tt, nil ) ; end ) ;
  return button ;
end

function oq.closebox( parent, on_close )
  oq.nthings = (oq.nthings or 0) + 1 ;
  local closepb = oq.CreateFrame("Button","$parent".. "Close".. oq.nthings, parent, "UIPanelCloseButton") ;
  closepb:SetWidth(25) ;
  closepb:SetHeight(25) ;
  closepb:SetPoint("TOPRIGHT", parent, "TOPRIGHT", -7, -7) ;
  if (on_close == nil) then
    closepb:SetScript("OnClick", function(self) self:GetParent():Hide() ; end) ;
  else
    closepb:SetScript("OnClick", on_close ) ;
  end
  closepb:Show() ;
  return closepb ;
end

function oq.menu_clear() 
  oq.__menu:Hide() ;
  for i=1,OQ.MAX_MENU_OPTIONS do
    if (oq.__menu_options[i]) then
      oq.__menu_options[i]:Hide() ;
      oq.__menu_options[i]._text    = nil ;
      oq.__menu_options[i]._checked = nil ;
      oq.__menu_options[i]._arg1    = nil ;
      oq.__menu_options[i]._arg2    = nil ;
      oq.__menu_options[i]._func    = nil ;
    end
  end
end

function oq.menu_create()
  if (oq.__menu == nil) then
    oq.__menu = oq.CreateFrame( "FRAME", "OQMenu", UIParent ) ;
    oq.__menu_options = tbl.new() ;
    oq.__menu:SetBackdrop({bgFile="Interface/Tooltips/CHATBUBBLE-BACKGROUND", 
                           edgeFile="Interface/Tooltips/UI-Tooltip-Border", 
                           tile=true, tileSize = 16, edgeSize = 16,
                           insets = { left = 1, right = 1, top = 1, bottom = 2 }
                          }) ;
    oq.__menu:SetBackdropColor( 1,0,0 ) ;
    oq.__menu:SetAlpha( 1.0 ) ;
    oq.__menu._cy = 18 ;
    oq.__menu:SetScript( "OnShow"  , function(self, ...) self._last_move_tm = GetTime() ; end ) ;
    oq.__menu:SetScript( "OnHide"  , function(self, ...) self._last_move_tm = nil ; end ) ;
    oq.__menu:SetScript( "OnUpdate", function(self, ...) 
                                       if ((self._last_move_tm) and (abs(GetTime() - self._last_move_tm) > OQ.MENU_DISPLAY_TM)) then 
                                         self:Hide() ; 
                                       end 
                                     end ) ;

    local y = 8 ;
    for i=1,OQ.MAX_MENU_OPTIONS do
      local m = oq.CreateFrame( "BUTTON", "OQMenuOption".. i, oq.__menu ) ;
      y = oq.__menu._cy * (i-1) ;
      m:SetBackdrop({bgFile="Interface/Tooltips/UI-Tooltip-Background", 
                     tile=true, tileSize = 16, edgeSize = 16,
                     insets = { left = 1, right = 1, top = 1, bottom = 1 }
                    }) ;
      m:SetBackdropColor( 0,0,0 ) ;
      m:SetAlpha( 1.0 ) ;
      m:SetPoint( "TOP"  , oq.__menu, "TOP"  ,  0, -1 * y - 4 ) ;
      m:SetPoint( "LEFT" , oq.__menu, "LEFT" ,  3, 0 ) ;
      m:SetPoint( "RIGHT", oq.__menu, "RIGHT", -3, 0 ) ;
      m:SetHeight( oq.__menu._cy + 2 ) ;
      
      local t = m:CreateTexture( nil, "BORDER" ) ;
--      t:SetTexture( "INTERFACE/BUTTONS/UI-Listbox-Highlight2" ) ;
      t:SetTexture( "INTERFACE/QUESTFRAME/UI-QuestTitleHighlight" ) ;
      t:SetPoint( "TOPLEFT", 5, 0, "TOPLEFT", 0, 0 ) ;
      t:SetPoint( "BOTTOMRIGHT", -5, 0, "BOTTOMRIGHT", 0, 0 ) ;
      t:SetAlpha( 0.6 ) ;
      t:Hide() ;
      m._highlight = t ;
      
      m._label = oq.label( m, 18, 3, 140, oq.__menu._cy, "" ) ;
      m._label:SetTextColor( 1,1,1,1 ) ;
      m:SetScript( "OnEnter", function(self, ...) 
                                if (self._func) then self._highlight:Show() ; end 
                                if (self:GetParent()) then self:GetParent()._last_move_tm = GetTime() ; end 
                              end ) ;
      m:SetScript( "OnLeave", function(self, ...) 
                                if (self._func) then self._highlight:Hide() ; end 
                                if (self:GetParent()) then self:GetParent()._last_move_tm = GetTime() ; end 
                              end ) ;
      m:SetScript( "OnClick", function(self) 
                                if (self._func) then 
                                  self._func( self:GetParent():GetParent(), self._arg1, self._arg2 ) ; 
                                  PlaySound("igMainMenuOptionCheckBoxOff") ;
                                end 
                                self:GetParent():Hide() ;
                              end
                  ) ;
      oq.__menu_options[i] = m ;
    end
  end
  oq.menu_clear() ;
  return oq.__menu ;
end

function oq.menu_add( text, arg1, arg2, checked, func )
  if (oq.__menu == nil) then
    oq.menu_create() ;
  end
  
  for i=1,OQ.MAX_MENU_OPTIONS do
    if (oq.__menu_options[i]) and (oq.__menu_options[i]._text == nil) then
      local m = oq.__menu_options[i] ;
      m._text    = text ;
      m._checked = checked ;
      m._arg1    = arg1 ;
      m._arg2    = arg2 ;
      m._func    = func ;
      m._label:SetText( text ) ;
      m:Show() ;
      return ;
    end
  end
end

function oq.menu_show_core( f, width )
  if (oq.__menu) then
    local n = 0 ;
    for i=1,OQ.MAX_MENU_OPTIONS do 
      if (oq.__menu_options[i]) and (oq.__menu_options[i]._text ~= nil) then
        n = n + oq.__menu._cy ;
      else
        break ;
      end
    end
    oq.__menu:SetParent( f ) ;
    oq.__menu:SetFrameLevel( 125 ) ;
    oq.__menu:SetWidth( width or f:GetWidth() ) ;
    oq.__menu:SetHeight( max( 10, n + 16 )) ;
    PlaySound("igMainMenuOptionCheckBoxOn") ;
  end
end

function oq.menu_show( f, my_corner, adj_x, adj_y, their_corner, width )
  if (oq.__menu) then
    oq.menu_show_core( f, width ) ;
    
    oq.__menu:SetPoint( my_corner, adj_x, adj_y, their_corner, 0, 0 ) ;
    oq.__menu:Show() ;
    oq.__menu:SetFrameStrata("TOOLTIP") ;
    oq.__menu:SetFrameLevel( f:GetFrameLevel() + 5 ) ;
    oq.__menu:Raise() ;
  end
end

function oq.menu_show_at_cursor( width, adj_x, adj_y )
  if (oq.__menu) then
    oq.menu_show_core( UIParent, width ) ;
    
    local cursorX, cursorY = GetCursorPosition() ;
    cursorX = floor(cursorX / UIParent:GetEffectiveScale()) ;
    cursorY = floor(cursorY / UIParent:GetEffectiveScale()) ;
    oq.__menu:SetPoint( "TOPLEFT", UIParent, "BOTTOMLEFT", cursorX + adj_x, cursorY + adj_y ) ;
    oq.__menu:Show() ;
  end
end

function oq.menu_hide()
  if (oq.__menu) then
    PlaySound("igMainMenuOptionCheckBoxOff") ;
    oq.__menu:Hide() ;
  end
end

function oq.menu_is_visible()
  if (oq.__menu) then
    return oq.__menu:IsVisible() ;
  end
  return nil ;
end

function oq.combo_box( parent, x, y, edit_cx, cy, populate_list_func, init_text ) 
  local cb = oq.texture_button( parent, x + edit_cx + 2, y, 20, cy, OQ.DOWNARROW_UP, OQ.DOWNARROW_DOWN ) ;
  cb:SetFrameLevel( parent:GetFrameLevel() + 5 ) ;
  cb._populate = populate_list_func ;
  cb._edit = oq.editbox( parent, cb:GetName() .."Edit", x, y, edit_cx, cy, 35, nil, "" ) ;   
  cb._edit:SetFontObject("GameFontNormalSmall") ;
  cb._edit:SetTextColor( 1,1,1,1 ) ;
  cb._edit:SetTextInsets( 10, 5, 7, 2 ) ;
  cb._edit:Disable() ;
  cb._edit:SetText( init_text or "" ) ;
  cb._edit:SetFrameLevel( parent:GetFrameLevel() + 5 ) ;
  cb:SetScript( "OnClick", function(self) 
                             if (oq.menu_is_visible()) then
                               oq.menu_hide() ;
                             else
                               if (self._populate) then
                                 self._populate() ;
                               end
                               oq.menu_show( self._edit, "TOPLEFT", 0, -25, "BOTTOMLEFT", self._edit:GetWidth() + 22 ) ;
                             end
                           end 
              ) ;
  return cb ;
end