update ui.h

Author: neroist

headers/ui.h

@@ -20,15 +20,11 @@
 #ifndef __LIBUI_UI_H__
 #define __LIBUI_UI_H__
 
-#if defined(windows)
-#  define dllName  "libui.dll"
-#elif defined(macosx)
-#  define dllName  "libui.dylib"
-#else
-#  define dllName "libui.so"
-#endif
+#include <stddef.h>
+#include <stdint.h>
 
 #ifdef __cplusplus
+extern "C" {
 #endif
 
 // this macro is generated by cmake
@@ -301,6 +297,48 @@ _UI_EXTERN char *uiWindowTitle(uiWindow *w);
  */
 _UI_EXTERN void uiWindowSetTitle(uiWindow *w, const char *title);
 
+/**
+ * Gets the window position.
+ *
+ * Coordinates are measured from the top left corner of the screen.
+ *
+ * @param w uiWindow instance.
+ * @param[out] x X position of the window.
+ * @param[out] y Y position of the window.
+ * @note This method may return inaccurate or dummy values on Unix platforms.
+ * @memberof uiWindow
+ */
+_UI_EXTERN void uiWindowPosition(uiWindow *w, int *x, int *y);
+
+/**
+ * Moves the window to the specified position.
+ *
+ * Coordinates are measured from the top left corner of the screen.
+ *
+ * @param w uiWindow instance.
+ * @param x New x position of the window.
+ * @param y New y position of the window.
+ * @note This method is merely a hint and may be ignored on Unix platforms.
+ * @memberof uiWindow
+ */
+_UI_EXTERN void uiWindowSetPosition(uiWindow *w, int x, int y);
+
+/**
+ * Registers a callback for when the window moved.
+ *
+ * @param w uiWindow instance.
+ * @param f Callback function.\n
+ *          @p sender Back reference to the instance that triggered the callback.\n
+ *          @p senderData User data registered with the sender instance.\n
+ * @param data User data to be passed to the callback.
+ *
+ * @note Only one callback can be registered at a time.
+ * @note The callback is not triggered when calling uiWindowSetPosition().
+ * @memberof uiWindow
+ */
+_UI_EXTERN void uiWindowOnPositionChanged(uiWindow *w,
+	void (*f)(uiWindow *sender, void *senderData), void *data);
+
 /**
  * Gets the window content size.
  *
@@ -352,9 +390,7 @@ _UI_EXTERN void uiWindowSetFullscreen(uiWindow *w, int fullscreen);
  *          @p senderData User data registered with the sender instance.
  * @param data User data to be passed to the callback.
  *
- * @todo Research if this gets called on uiWindowSetContentSize().
- *       The signal on unix does not seem to get masked. Fix this on all
- *       platforms and document the masking here.
+ * @note The callback is not triggered when calling uiWindowSetContentSize().
  * @note Only one callback can be registered at a time.
  * @memberof uiWindow
  */
@@ -1216,6 +1252,7 @@ typedef struct uiProgressBar uiProgressBar;
  * Returns the progress bar value.
  *
  * @param p uiProgressBar instance.
+ * @returns Progress bar value. `[Default 0]`
  * @memberof uiProgressBar
  */
 _UI_EXTERN int uiProgressBarValue(uiProgressBar *p);
@@ -3956,6 +3993,7 @@ _UI_EXTERN void uiTableSetSelection(uiTable *t, uiTableSelection *sel);
 _UI_EXTERN void uiFreeTableSelection(uiTableSelection* s);
 
 #ifdef __cplusplus
+}
 #endif
 
 #endif