Sandbox/GUI/Getting Started - Revision history

White haired uncle: /* Adding a little flavor */

2024-11-01T23:42:15Z

‎Adding a little flavor

2024-11-01T21:13:54Z

‎Adding a little flavor

2024-11-01T20:53:55Z

‎Adding a little flavor

2024-11-01T20:51:54Z

‎Introduction

2024-11-01T20:46:33Z

‎And a bit more

2024-10-30T23:49:51Z

‎Listbox

2024-09-29T16:06:39Z

‎Listbox

2024-09-29T16:05:55Z

‎Listbox

2024-09-25T20:29:48Z

‎Slider and Textbox

2024-09-25T10:50:40Z

‎Useful Links

@@ Line 165: / Line 165: @@
+         }
+     }
-     wml.parse(wml.tostring({{"resolution", dialogDefinition}}), "schema/gui_window.cfg") -- schema validation errors will go to log
+     wml.parse(wml.tostring({wml.tag.resolution(dialogDefinition)}), "schema/gui_window.cfg") -- schema validation errors will go to log
      gui.show_dialog(dialogDefinition)
 end

@@ Line 170: / Line 170: @@
 return { most_basic_gui = most_basic_gui, most_basic_gui2 = most_basic_gui2 }
 </syntaxhighlight>
 ===And a bit more===

@@ Line 165: / Line 165: @@
+         }
+     }
      gui.show_dialog(dialogDefinition)
 end

@@ Line 11: / Line 11: @@
 gui.show_lua_console()
 </syntaxhighlight>
 In some examples, instead of defining the entire GUI at once, we'll break out some parts into separate variables.  If you try to view one in WML and get an error from wml.tostring() about expecting a WML table and not a table, try passing your variable(/table) inside a table:
@@ Line 18: / Line 20: @@
 gui.show_lua_console()
 </syntaxhighlight>
 ===What is GUI2?===

@@ Line 231: / Line 231: @@
 </syntaxhighlight>
-While we see here just the simplest of examples, you can many levels of grids in grids, rows with multiple columns some of which containing grids, etc, to build complicated dialogs to your liking.
+While we see here just the simplest of examples, you can create many levels of grids inside grids, rows with multiple columns some of which containing grids, etc, to build complicated dialogs to your liking.
 ==Containers==

@@ Line 243: / Line 243: @@
 | Now we'd like to add some more monsters.  Obviously, we could just add more rows, but what if we won't know until runtime how many and which ones?  We could break up the definition of our dialog and add new rows dynamically, it's just a table after all, but fortunately we have a widget which handles this for us, a listbox.  A listbox is kind of like an array, a collection of similar objects where the number of items can vary.  We will tell the GUI where we want the box, and what each entry in the box will look like, and then at runtime we can add entries to the box.
-Note that listbox items are added from top to bottom.  Another container, the horizontal_listbox, works just like a listbox except the items are added from left to right.
+Note that listbox items are added from top to bottom.  Another container, the horizontal_listbox, works just like a listbox except the items are added from left to right.  With a grid listbox, items are added horizontally with the list wrapping to a new line as necessary.
 |-
 | [[File:Gui with listbox.png|center|thumb|Listbox with three items.  Each item is an image and a label.  The third item has been selected.]]

@@ Line 245: / Line 245: @@
 Note that listbox items are added from top to bottom.  Another container, the horizontal_listbox, works just like a listbox except the items are added from left to right.
 |-
-| [[File:Gui with listbox.png|center|thumb|Listbox with three items.  Each item is an image and a label.]]
+| [[File:Gui with listbox.png|center|thumb|Listbox with three items.  Each item is an image and a label.  The third item has been selected.]]
 <syntaxhighlight lang=lua>

@@ Line 1,098: / Line 1,098: @@
 <syntaxhighlight lang=lua>
-function scrollbar_and_textbox()
+function slider_and_textbox()
      local dialogDefinition = {
          wml.tag.tooltip { id = "tooltip_large" },

@@ Line 1,683: / Line 1,683: @@
 ===Useful Links===
-[[GUIToolkitWML - Documents the keys/values available on various objects ("what attributes can I set on a column?"]]
+[[GUIToolkitWML]] - Documents the keys/values available on various objects (e.g. "what attributes can I set on a column?") <br>
-[[LuaAPI/gui|LuaAPI/gui - Mostly about opening windows]]<br>
+[[LuaAPI/gui|LuaAPI/gui]] - Mostly about opening windows<br>
-[[LuaAPI/types/widget|LuaAPI/types/widget - Widget attributes and callbacks]]<br>
+[[LuaAPI/types/widget]] - Widget attributes and callbacks<br>
 [https://wiki.wesnoth.org/Category:GUI_WML_Reference  GUI_WML_Reference]<br>
 [https://github.com/wesnoth/wesnoth/tree/master/data/schema/gui .../data/schema/gui/*.cfg] - Lists of valid options for various GUI objects<br>