From de7c405aeaf23401c98e482011364f34f059b8da Mon Sep 17 00:00:00 2001
From: Leonard Ritter <contact@leonard-ritter.com>
Date: Sun, 19 Oct 2014 13:05:11 +0200
Subject: [PATCH] uiInsertBack/uiInsertFront

---
 oui.h | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/oui.h b/oui.h
index 595845f..f9e41c9 100644
--- a/oui.h
+++ b/oui.h
@@ -598,6 +598,16 @@ OUI_EXPORT int uiInsert(int item, int child);
 // sibling is inserted after item.
 OUI_EXPORT int uiAppend(int item, int sibling);
 
+// insert child into container item like uiInsert(), but prepend
+// it to the first child item, effectively putting it in
+// the background.
+// it is efficient to call uiInsertBack() repeatedly
+// in cases where drawing or layout order doesn't matter.
+OUI_EXPORT int uiInsertBack(int item, int child);
+
+// same as uiInsert()
+OUI_EXPORT int uiInsertFront(int item, int child);
+
 // set the size of the item; a size of 0 indicates the dimension to be 
 // dynamic; if the size is set, the item can not expand beyond that size.
 OUI_EXPORT void uiSetSize(int item, int w, int h);
@@ -1181,6 +1191,21 @@ int uiInsert(int item, int child) {
     return child;
 }
 
+int uiInsertFront(int item, int child) {
+    return uiInsert(item, child);
+}
+
+int uiInsertBack(int item, int child) {
+    assert(child > 0);
+    UIitem *pparent = uiItemPtr(item);
+    UIitem *pchild = uiItemPtr(child);
+    assert(!(pchild->flags & UI_ITEM_INSERTED));
+    pchild->nextitem = pparent->firstkid;
+    pparent->firstkid = child;
+    pchild->flags |= UI_ITEM_INSERTED;
+    return child;
+}
+
 void uiSetFrozen(int item, int enable) {
     UIitem *pitem = uiItemPtr(item);
     if (enable)