AceGUI for Ace 1.x

From WowAce Wiki

Jump to: navigation, search

1 All About AceGUI
2 AceGUI Downloads
- 2.1 Latest Release
- 2.2 Pre-Release Versions
3 AceGUI Reference Manual
4 AceGUI Tutorials / Example Code
5 FAQ
6 AceGUI Resources

[edit]

All About AceGUI

{placeholder}

[edit]

AceGUI Downloads

[edit]

Latest Release

Below is the latest stable version of AceGUI. It is always highly recommended you use the latest stable version unless you are a developer or you wish to help test the newer versions.

No current stable release : Please check out the Pre-Release link below

[edit]

Pre-Release Versions

Should you wish to use a more current version, please pay careful attention to the AceGUI Patch Submission Forum and the AceGUI Development Discussion Forum.

[edit]

AceGUI Reference Manual

This section covers only syntax. For a guide on use, please read through the tutorials section below.

[edit]

Creating a new AceGUI Object

The AceGUI Object requires a corresponding XML file, with elements specified so that the "name" field of these objects tallies up with the relevant elements in the .xml file.

Addon.DlgInit   = {
   name                = "AddonFrame",
   type                = ACEGUI_DIALOG,
   title               = "Addon",
   isSpecial           = TRUE,
   backdrop            = "small",
   width               = x,
   height              = y,
   OnShow              = "Build",
   elements            = {
-- In this section would go any elements contained within the parent element.  e.g.
--      AceGUIItem1      = {
--         type          = See ACEGUI_DRIVER_MAP for types,
--         element       = See Elements for each Type.
--      },
--      AceGUIItem2      = {
--         type          = See ACEGUI_DRIVER_MAP for types,
--         element       = See Elements for each Type.
--      }
   },
}

Addon.Dialog = AceGUI:new({

  Build = function(self)
-- I recommend you put any settings needed to set up your dialog here.
-- e.g. load variables from database etc to populate UI fields.
  end,
})

[edit]

Using an AceGUI Object

Inside your Ace addon's Enable function, you will need to include a line such as:

Addon.Dialog:Initialize(self, Addon.DlgInit)

This will cause the dialog to be created, then when you want to display it:

Addon.Dialog:Show()

or to close it again

Addon.Dialog:Hide()

The show event will trigger the Build function as specified, thus setting up the dialog for use.

[edit]

Elements

[edit]

AceGUI Tutorials / Example Code

The following tutorials will step you through the creation of a simple GUI based mod for Ace. The mod itself won't actually do much, it only exists to demonstrate different functions in AceGUI and how they interact with Ace as a whole.