ui/ui/toolkit.h

/*
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
 *
 * Copyright 2017 Olaf Wintermann. All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *
 *   1. Redistributions of source code must retain the above copyright
 *      notice, this list of conditions and the following disclaimer.
 *
 *   2. Redistributions in binary form must reproduce the above copyright
 *      notice, this list of conditions and the following disclaimer in the
 *      documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef UI_TOOLKIT_H
#define	UI_TOOLKIT_H

#include <inttypes.h>
#include <stdlib.h>

#ifdef UI_COCOA

#include <stdlib.h>
#ifdef __OBJC__
#import <Cocoa/Cocoa.h>
#endif
typedef void* UIWIDGET; // NSView*
typedef void* UIWINDOW; // NSWindow*
typedef void* UIMENU;   // NSMenu*

#elif UI_GTK2 || UI_GTK3 || UI_GTK4
#define UI_GTK

#include <gtk/gtk.h>
#define UIWIDGET GtkWidget*
#define UIWINDOW void*

#if UI_GTK2 || UI_GTK3
#define UIMENU   GtkMenu*
#endif
#ifdef UI_GTK4
#define UIMENU   GtkPopoverMenu*
#endif

#define UI_GTK

#ifdef UI_LIBADWAITA
#include <adwaita.h>
#endif

#elif defined(UI_QT4) || defined(UI_QT5)
#define UI_QT

#ifdef	__cplusplus

#include <QApplication>
#include <QWidget>
#include <QMenu>

#define UIWIDGET QWidget*
#define UIWINDOW QWidget*
#define UIMENU   QMenu*
#else /* __cplusplus */
#define UIWIDGET void*
#define UIWINDOW void*
#define UIMENU   void*
#endif

#elif UI_MOTIF

#include <Xm/XmAll.h> 
#define UIWIDGET Widget
#define UIWINDOW void*
#define UIMENU   Widget


#elif UI_WIN32

#include "win32.h"

#define UIWIDGET W32Widget*
#define UIWINDOW void*
#define UIMENU   void*

#elif UI_WINUI

#define UIEXPORT __declspec(dllexport) 

#ifdef __cplusplus

#include <functional>
#ifndef UI_WINUI_PCH
#include <Windows.h>
#undef GetCurrentTime
#include <winrt/Windows.Foundation.Collections.h>
#include <winrt/Windows.UI.Xaml.Interop.h>
#include <winrt/Microsoft.UI.Xaml.Controls.h>
#endif

class UiWindow {
public:
    winrt::Microsoft::UI::Xaml::Window window { nullptr };

    UiWindow(winrt::Microsoft::UI::Xaml::Window& win);
};

class UiWidget {
public:
    winrt::Microsoft::UI::Xaml::UIElement uielement;
    void* data1 = nullptr;
    void* data2 = nullptr;
    void* data3 = nullptr;
    std::function<void()> Show;
    UiWidget(winrt::Microsoft::UI::Xaml::UIElement& elm);

};

#define UIWIDGET UiWidget*
#define UIWINDOW UiWindow*
#define UIMENU   void*

/*
// winrt::Microsoft::UI::Xaml::UIElement
#define UIWIDGET void*
// winrt::Microsoft::UI::Xaml::Window
#define UIWINDOW void*
#define UIMENU   void*
*/

#else
#define UIWIDGET void*
#define UIWINDOW void*
#define UIMENU   void*
#endif


#elif UI_SERVER

typedef struct UiWidget UiWidget;

#define UIWIDGET UiWidget*
#define UIWINDOW UiWidget*
#define UIMENU   void*

#else

#define UI_GENERIC
#define UIWIDGET void*
#define UIWINDOW void*
#define UIMENU   void*

#endif

#ifndef TRUE
#define TRUE 1
#endif
#ifndef FALSE
#define FALSE 0
#endif

#ifndef UIEXPORT
#define UIEXPORT
#endif

#ifdef	__cplusplus
extern "C" {
#endif

#define UI_GROUP_SELECTION  20000

#define UI_GROUPS(...) (const int[]){ __VA_ARGS__, -1 }
    
/* public types */
#ifndef __cplusplus
typedef _Bool UiBool;
#else
typedef bool UiBool;
#endif

typedef struct UiObject     UiObject;
typedef struct UiEvent      UiEvent;
typedef struct UiMouseEvent UiMouseEvent;
typedef struct UiObserver   UiObserver;

typedef struct UiInteger    UiInteger;
typedef struct UiDouble     UiDouble;
typedef struct UiString     UiString;
typedef struct UiText       UiText;
typedef struct UiList       UiList;
typedef struct UiRange      UiRange;
typedef struct UiGeneric    UiGeneric;

typedef struct UiStr        UiStr;

typedef struct UiFileList   UiFileList;

typedef struct UiListSelection UiListSelection;

typedef struct UiTextStyle  UiTextStyle;
typedef struct UiColor      UiColor;

typedef enum UiEventType UiEventType;

/* begin opaque types */
typedef struct UiContext     UiContext;
typedef struct UiContainer   UiContainer;
typedef struct UiMenuBuilder UiMenuBuilder;

typedef struct UiIcon        UiIcon;
typedef struct UiImage       UiImage;

typedef struct UiDnD         UiDnD;

typedef struct UiThreadpool  UiThreadpool;
/* end opaque types */

typedef enum UiTri {
    UI_DEFAULT = 0,
    UI_ON,
    UI_OFF
} UiTri;

enum UiMouseEventType { UI_PRESS = 0, UI_PRESS2 };

typedef enum UiLabelType {
    UI_LABEL_DEFAULT,
    UI_LABEL_TEXT,
    UI_LABEL_ICON,
    UI_LABEL_TEXT_ICON
} UiLabelType;

typedef enum UiDnDAction {
    UI_DND_ACTION_NONE,
    UI_DND_ACTION_COPY,
    UI_DND_ACTION_MOVE,
    UI_DND_ACTION_LINK,
    UI_DND_ACTION_CUSTOM
} UiDnDAction;

enum UiAlignment {
    UI_ALIGN_DEFAULT = 0,
    UI_ALIGN_LEFT,
    UI_ALIGN_RIGHT,
    UI_ALIGN_CENTER
};

typedef enum UiAlignment UiAlignment;

typedef void(*ui_callback)(UiEvent*, void*); /* event, user data */

typedef void*(*ui_getvaluefunc)(void *elm, int col);
typedef void*(*ui_getvaluefunc2)(UiList *list, void *elm, int row, int col, void *userdata, UiBool *freeResult);
typedef UiBool(*ui_getstylefunc)(UiList *list, void *elm, int row, int col, void *userdata, UiTextStyle *style);

typedef int(*ui_threadfunc)(void*);

typedef void(*ui_freefunc)(void*);

typedef void(*ui_enablefunc)(void*, int);

typedef void (*ui_destructor_func)(void *memory);


struct UiObject {
    /*
     * native widget
     */
    UIWIDGET    widget;

    /*
     * native window object 
     */
    UIWINDOW    wobj;
    
    /*
     * user window data
     */
    void        *window;
    
    /*
     * window context
     */
    UiContext   *ctx;
    
    /*
     * container list
     */
    UiContainer *container_begin;
    UiContainer *container_end;
    
    /*
     * called when someone requests to close the window
     */
    void (*onclose)(UiEvent *event, void *userdata);
    void *onclosedata;
    
    /*
     * obj destroy func
     */
    void (*destroy)(UiObject *obj);
    
    /*
     * reference counter
     */
    unsigned int ref;
};

enum UiEventType {
    UI_EVENT_DATA_NULL = 0,
    UI_EVENT_DATA_POINTER,
    UI_EVENT_DATA_STRING,
    UI_EVENT_DATA_INTEGER_VALUE,
    UI_EVENT_DATA_STRING_VALUE,
    UI_EVENT_DATA_TEXT_VALUE,
    UI_EVENT_DATA_DOUBLE_VALUE,
    UI_EVENT_DATA_RANGE_VALUE,
    UI_EVENT_DATA_TEXT_CHANGED,
    UI_EVENT_DATA_LIST_SELECTION,
    UI_EVENT_DATA_LIST_ELM,
    UI_EVENT_DATA_DND,
    UI_EVENT_DATA_SUBLIST,
    UI_EVENT_DATA_FILE_LIST,
    UI_EVENT_DATA_TYPED_OBJECT
};

struct UiEvent {
    UiObject     *obj;
    void         *document;
    void         *window;
    void         *eventdata;
    UiEventType  eventdatatype;
    int          intval;
    int          set;
};

struct UiMouseEvent {
    int x;
    int y;
    enum UiMouseEventType type;
    int button;
};

struct UiObserver {
    ui_callback callback;
    void *data;
    UiObserver *next;
};

struct UiStr {
    char *ptr;
    void (*free)(void *v);
};

struct UiInteger {
    int64_t  (*get)(UiInteger*);
    void (*set)(UiInteger*, int64_t);
    void *obj;
    
    int64_t value;
    UiObserver *observers;
};

struct UiDouble {
    double  (*get)(UiDouble*);
    void (*set)(UiDouble*, double);
    void *obj;
    
    double value;
    UiObserver *observers;
};

struct UiString {
    char* (*get)(UiString*);
    void  (*set)(UiString*, const char*);
    void  *obj;
    
    UiStr value;
    UiObserver *observers;
};

struct UiText {
    void  (*save)(UiText*);
    void  (*destroy)(UiText*);
    void  (*restore)(UiText*);
    void  (*set)(UiText*, const char*);
    char* (*get)(UiText*);
    char* (*getsubstr)(UiText*, int, int); /* text, begin, end */
    void  (*insert)(UiText*, int, const char*);
    void  (*replace)(UiText*, int, int, const char*);
    void  (*setposition)(UiText*,int);
    int   (*position)(UiText*);
    void  (*showposition)(UiText*, int);
    void  (*setselection)(UiText*, int, int); /* text, begin, end */
    void  (*selection)(UiText*, int*, int*); /* text, begin, end */
    int   (*length)(UiText*);
    void  (*remove)(UiText*, int, int); /* text, begin, end */
    UiStr value;
    int   pos;
    void  *obj;
    int   datatype;
    void  *data1;
    void  *data2;
    UiObserver *observers;
};

/* UiText.datatype */
#define UI_TEXT_TYPE_BUFFER 1

struct UiGeneric {
    void* (*get)(UiGeneric*);
    const char* (*get_type)(UiGeneric*);
    int (*set)(UiGeneric*, void *, const char *type);
    void (*destroy)(UiGeneric*);
    void *obj;
    
    void *value;
    const char *type;
    UiObserver *observers;
};
    
typedef void (*ui_list_init_func)(UiContext *ctx, UiList *list, void *userdata);
typedef void (*ui_list_destroy_func)(UiContext *ctx, UiList *list, void *userdata);

/*
 * abstract list
 */
struct UiList {
    // destructor
    ui_list_destroy_func destroy;
    // get the first element
    void*(*first)(UiList *list);
    // get the next element
    void*(*next)(UiList *list);
    // get the nth element
    void*(*get)(UiList *list, int i);
    // get the number of elements 
    int(*count)(UiList *list);
    // iterator changes after first() next() and get() 
    void *iter;
    // private - implementation dependent
    void *data;
    
    // binding functions 
    void (*update)(UiList *list, int i);
    UiListSelection (*getselection)(UiList *list);
    void (*setselection)(UiList *list, UiListSelection selection);
    // binding object
    void *obj;
    // saved selection after unbind
    UiListSelection *saved_selection;
    // enable selection saving
    UiBool save_selection;
    
    // list of observers
    UiObserver *observers;
};


struct UiListSelection {
    /*
    * number of selected items
    */
    int count;

    /*
    * indices of selected rows
    */
    int *rows;
};

struct UiRange {
    double (*get)(UiRange *range);
    void   (*set)(UiRange *range, double value);
    void   (*setrange)(UiRange *range, double min, double max);
    void   (*setextent)(UiRange *range, double extent);
    double value;
    double min;
    double max;
    double extent;
    void   *obj;
    /* list of observers */
    UiObserver *observers;
};

struct UiFileList {
    char **files;
    size_t nfiles;
};

typedef struct UiCondVar {
    void *data;
    int intdata;
} UiCondVar;

// eventdata in case eventdatatype is UI_EVENT_DATA_TYPED_OBJECT
typedef struct UiTypedObj {
    void *ptr;
    uint64_t type;
} UiTypedObj;

#define UI_COLOR(r, g, b) (UiColor){r, g, b}
struct UiColor {
    uint8_t red;
    uint8_t green;
    uint8_t blue;
};

#define UI_TEXT_STYLE_BOLD      1
#define UI_TEXT_STYLE_ITALIC    2
#define UI_TEXT_STYLE_UNDERLINE 4

struct UiTextStyle {
    uint32_t text_style;
    UiColor  fg;
    UiBool   fg_set;
};


UIEXPORT void ui_init(const char *appname, int argc, char **argv);
UIEXPORT const char* ui_appname(void);

UIEXPORT void ui_add_styledata(const char *styledata, int len);

UIEXPORT UiContext* ui_global_context(void);

UIEXPORT void ui_context_closefunc(UiContext *ctx, ui_callback fnc, void *udata);

UIEXPORT UiContext* ui_context_parent(UiContext *ctx);

UIEXPORT void ui_object_ref(UiObject *obj);
UIEXPORT int ui_object_unref(UiObject *obj);

UIEXPORT void ui_onstartup(ui_callback f, void *userdata);
UIEXPORT void ui_onnewwindow(ui_callback f, void *userdata);
UIEXPORT void ui_onopen(ui_callback f, void *userdata);
UIEXPORT void ui_onexit(ui_callback f, void *userdata);

UIEXPORT void ui_newwindow(void);

UIEXPORT int ui_app_save_settings(void);
UIEXPORT void ui_app_exit_on_shutdown(UiBool exitapp);

UIEXPORT void ui_main(void);
UIEXPORT void ui_app_quit(void);
UIEXPORT void ui_show(UiObject *obj);
UIEXPORT void ui_close(UiObject *obj);

UIEXPORT UiObject* ui_dummy_object(void);

UIEXPORT void ui_job(UiObject *obj, ui_threadfunc tf, void *td, ui_callback f, void *fd);
UIEXPORT void ui_call_mainthread(ui_threadfunc tf, void* td);

UIEXPORT void ui_buffer_mainthread_calls(UiBool enable_buffering);
UIEXPORT void ui_exec_buffered_mainthread_calls(void);
UIEXPORT void ui_exec_buffered_mainthread_calls_wait(int timeout);

UIEXPORT UiThreadpool* ui_threadpool_create(int nthreads);
UIEXPORT void ui_threadpool_destroy(UiThreadpool* pool);
UIEXPORT void ui_threadpool_job(UiThreadpool* pool, UiObject* obj, ui_threadfunc tf, void* td, ui_callback f, void* fd);

UIEXPORT void* ui_document_new(size_t size);
UIEXPORT void  ui_document_ref(void *doc);
UIEXPORT void  ui_document_unref(void *doc);
UIEXPORT void  ui_document_destroy(void *doc);
UIEXPORT void  ui_document_onattach(void *doc, ui_callback cb, void *data);
UIEXPORT void  ui_document_ondetach(void *doc, ui_callback cb, void *data);
UIEXPORT void  ui_document_onattach_action(void *doc, const char *action);
UIEXPORT void  ui_document_ondetach_action(void *doc, const char *action);

UIEXPORT UiContext* ui_document_context(void *doc);
UIEXPORT void* ui_context_document(UiContext *ctx);
UIEXPORT UiObject* ui_context_obj(UiContext *ctx);

UIEXPORT void* ui_context_get_document(UiContext *ctx);
UIEXPORT void ui_context_single_attachment_mode(UiContext *ctx, UiBool enable);
UIEXPORT void ui_attach_document(UiContext *ctx, void *document);
UIEXPORT void ui_detach_document(UiContext *ctx, void *document);

UIEXPORT void ui_widget_set_states(UiContext *ctx, UIWIDGET widget, ui_enablefunc enable, ...);
UIEXPORT void ui_widget_set_states2(UiContext *ctx, UIWIDGET widget, ui_enablefunc enable, const int *states, int nstates);
UIEXPORT void ui_widget_set_visibility_states(UiContext *ctx, UIWIDGET widget, const int *states, int nstates);

UIEXPORT void ui_add_action(UiContext *ctx, const char *name, ui_callback callback, void *userdata);
UIEXPORT void ui_add_action_with_accelerator(
        UiContext *ctx,
        const char *name,
        ui_callback callback,
        void *userdata,
        const char *accelerator,
        const char *accelerator_text);
UIEXPORT void ui_update_action_bindings(UiContext *ctx);
UIEXPORT int ui_call_action(UiContext *ctx, const char *action_name);
UIEXPORT int ui_call_action2(UiContext *ctx, const char *action_name, void *eventdata, int intval);
UIEXPORT int ui_call_action3(UiContext *ctx, const char *action_name, void *ptr, uint64_t type_id);
UIEXPORT void ui_broadcast_action(const char *action_name);
UIEXPORT void ui_broadcast_action2(const char *action_name, void *eventdata, int intval);
UIEXPORT void ui_broadcast_action3(const char *action_name, void *ptr, uint64_t type_id);
UIEXPORT void ui_mainthread_broadcast(const char *action_name);
UIEXPORT void ui_mainthread_broadcast2(const char *action_name, void *eventdata, int intval);
UIEXPORT void ui_mainthread_broadcast3(const char *action_name, void *ptr, uint64_t type_id);
UIEXPORT void ui_call_action_on(UiContext *ctx, const char *action);

UIEXPORT void ui_set_state(UiContext *ctx, int state);
UIEXPORT void ui_unset_state(UiContext *ctx, int state);
UIEXPORT int* ui_active_states(UiContext *ctx, int *nstates);
    
UIEXPORT void* ui_allocator(UiContext *ctx);
UIEXPORT void* ui_cx_mempool(UiContext *ctx);

UIEXPORT void* ui_malloc(UiContext *ctx, size_t size);
UIEXPORT void* ui_calloc(UiContext *ctx, size_t nelem, size_t elsize);
UIEXPORT void  ui_free(UiContext *ctx, void *ptr);
UIEXPORT void* ui_realloc(UiContext *ctx, void *ptr, size_t size);
UIEXPORT char* ui_strdup(UiContext *ctx, const char *str);
UIEXPORT void  ui_reg_destructor(UiContext *ctx, void *data, ui_destructor_func destr);
UIEXPORT void  ui_remove_destructor(UiContext *ctx, void *data);
UIEXPORT void  ui_set_destructor(void *mem, ui_destructor_func destr);

// types

UIEXPORT UiInteger* ui_int_new(UiContext *ctx, const char *name);
UIEXPORT UiDouble* ui_double_new(UiContext *ctx, const char *name);
UIEXPORT UiString* ui_string_new(UiContext *ctx, const char *name);
UIEXPORT UiText* ui_text_new(UiContext *ctx, const char *name);
UIEXPORT UiRange* ui_range_new(UiContext *ctx, const char *name);
UIEXPORT UiGeneric* ui_generic_new(UiContext *ctx, const char *name);

#define ui_get(v) _Generic(v, \
    UiInteger*: ui_int_get, \
    UiDouble*: ui_double_get, \
    UiString*: ui_string_get, \
    UiText*:ui_text_get) (v)

#define ui_set(v, n) _Generic(v, \
    UiInteger*: ui_int_set, \
    UiDouble*: ui_double_set, \
    UiString*: ui_string_set, \
    UiText*:ui_text_set) (v, n)

UIEXPORT void ui_int_set(UiInteger *i, int64_t value);
UIEXPORT int64_t ui_int_get(UiInteger *i);
UIEXPORT void ui_double_set(UiDouble *d, double value);
UIEXPORT double ui_double_get(UiDouble *d);
UIEXPORT void ui_string_set(UiString *s, const char *value);
UIEXPORT char* ui_string_get(UiString *s);
UIEXPORT void ui_text_set(UiText *s, const char* value);
UIEXPORT char* ui_text_get(UiText *s);
UIEXPORT void ui_range_set(UiRange *r, double value);
UIEXPORT void ui_range_set_range(UiRange *r, double min, double max);
UIEXPORT void ui_range_set_extent(UiRange *r, double extent);
UIEXPORT double ui_range_get(UiRange *r);
UIEXPORT double ui_range_get_min(UiRange *r);
UIEXPORT double ui_range_get_max(UiRange *r);
UIEXPORT double ui_range_get_extent(UiRange *r);
UIEXPORT void ui_generic_set_image(UiGeneric *g, void *img);
UIEXPORT void* ui_generic_get_image(UiGeneric *g);

UIEXPORT void ui_var_set_int(UiContext *ctx, const char *name, int64_t value);
UIEXPORT int64_t ui_var_get_int(UiContext *ctx, const char *name);
UIEXPORT void ui_var_set_double(UiContext *ctx, const char *name, double value);
UIEXPORT double ui_var_get_double(UiContext *ctx, const char *name);
UIEXPORT void ui_var_set_string(UiContext *ctx, const char *name, char *value);
UIEXPORT char* ui_var_get_string(UiContext *ctx, const char *name);

UIEXPORT UiInteger* ui_get_int_var(UiContext *ctx, const char *name);
UIEXPORT UiDouble* ui_get_double_var(UiContext *ctx, const char *name);
UIEXPORT UiString* ui_get_string_var(UiContext *ctx, const char *name);
UIEXPORT UiText* ui_get_text_var(UiContext *ctx, const char *name);
UIEXPORT UiRange* ui_get_range_var(UiContext *ctx, const char *name);
UIEXPORT UiList* ui_get_list_var(UiContext *ctx, const char *name);
UIEXPORT UiGeneric* ui_get_generic_var(UiContext *ctx, const char *name);

UIEXPORT void ui_var_add_observer(UiContext *ctx, const char *varname, ui_callback f, void *data);

UIEXPORT void ui_int_add_observer(UiInteger *i, ui_callback f, void *data);
UIEXPORT void ui_double_add_observer(UiDouble *d, ui_callback f, void *data);
UIEXPORT void ui_range_add_observer(UiRange *r, ui_callback f, void *data);
UIEXPORT void ui_string_add_observer(UiString *s, ui_callback f, void *data);
UIEXPORT void ui_text_add_observer(UiText *t, ui_callback f, void *data);
UIEXPORT void ui_list_add_observer(UiList *l, ui_callback f, void *data);

UIEXPORT UiObserver* ui_observer_new(ui_callback f, void *data);
UIEXPORT UiObserver* ui_obsvlist_add(UiObserver *list, UiObserver *observer);
UIEXPORT UiObserver* ui_add_observer(UiObserver *list, ui_callback f, void *data);
UIEXPORT void ui_notify(UiObserver *observer, void *data);
UIEXPORT void ui_notify_except(UiObserver *observer, UiObserver *exc, void *data);
UIEXPORT void ui_notify_evt(UiObserver *observer, UiEvent *event);


UIEXPORT UiList* ui_list_new(UiContext *ctx, const char *name);
UIEXPORT UiList* ui_list_new2(UiContext *ctx, const char *name, ui_list_init_func init, void *userdata);
UIEXPORT void ui_list_free(UiContext *ctx, UiList *list);
UIEXPORT void* ui_list_first(UiList *list);
UIEXPORT void* ui_list_next(UiList *list);
UIEXPORT void* ui_list_get(UiList *list, int i);
UIEXPORT int ui_list_count(UiList *list);
UIEXPORT void ui_list_append(UiList *list, void *data);
UIEXPORT void ui_list_prepend(UiList *list, void *data);
UIEXPORT void ui_list_insert(UiList *list, int index, void *data);
UIEXPORT void ui_list_remove(UiList *list, int i);
UIEXPORT void ui_list_clear(UiList *list);
UIEXPORT void ui_list_update(UiList *list);
UIEXPORT void ui_list_update_row(UiList *list, int row);
UIEXPORT UiListSelection ui_list_get_selection(UiList *list);
UIEXPORT void ui_list_set_selection(UiList *list, UiListSelection sel);
UIEXPORT void ui_list_addobsv(UiList *list, ui_callback f, void *data);
UIEXPORT void ui_list_notify(UiList *list);
UIEXPORT void ui_list_clear_saved_selection(UiList *list);

UIEXPORT int ui_list_getselection(UiList *list);
UIEXPORT void ui_list_setselection(UiList *list, int index);
UIEXPORT void ui_list_setselection2(UiList *list, int index, UiBool selection_event);

UIEXPORT void ui_listselection_free(UiListSelection selection);

UIEXPORT UiFileList ui_filelist_copy(UiFileList list);
UIEXPORT void ui_filelist_free(UiFileList list);

UIEXPORT void ui_clipboard_set(char *str);
UIEXPORT char* ui_clipboard_get();

UIEXPORT void ui_add_image(char *imgname, char *filename); // TODO: remove?

UIEXPORT char* ui_text_getsubstr(UiText *text, int begin, int end);
UIEXPORT void  ui_text_insert(UiText *text, int pos, const char *str);
UIEXPORT void  ui_text_replace(UiText *text, int begin, int end, const char *str);
UIEXPORT void  ui_text_setposition(UiText *text, int pos);
UIEXPORT int   ui_text_position(UiText *text);
UIEXPORT void  ui_text_showposition(UiText *text, int pos);
UIEXPORT void  ui_text_setselection(UiText *text, int begin, int end);
UIEXPORT void  ui_text_selection(UiText *text, int *begin, int *end);
UIEXPORT int   ui_text_length(UiText *text);
UIEXPORT void  ui_text_remove(UiText *text, int begin, int end);

UIEXPORT UiStr ui_str(char *cstr);
UIEXPORT UiStr ui_str_free(char *str, void (*free)(void *v));


UIEXPORT char* ui_getappdir(void);
UIEXPORT void ui_setappdir(const char *path);
UIEXPORT char* ui_configfile(const char *name);

UIEXPORT UiCondVar* ui_condvar_create(void);
UIEXPORT void ui_condvar_wait(UiCondVar *var);
UIEXPORT void ui_condvar_signal(UiCondVar *var, void *data, int intdata);
UIEXPORT void ui_condvar_destroy(UiCondVar *var);

UIEXPORT void ui_setop_enable(int set);
UIEXPORT int ui_get_setop(void);
UIEXPORT void ui_onchange_events_enable(UiBool enable);
UIEXPORT UiBool ui_onchange_events_is_enabled(void);
UIEXPORT void ui_selection_events_enable(UiBool enable);
UIEXPORT UiBool ui_selection_events_is_enabled(void);

    
UIEXPORT void ui_global_list_initializer(ui_list_init_func func, void *userdata);
UIEXPORT void ui_global_list_destructor(ui_list_destroy_func func, void *userdata);
UIEXPORT void ui_list_class_set_destructor(UiList *list, ui_list_destroy_func destroy);
UIEXPORT void ui_list_class_set_first(UiList *list, void*(*first)(UiList *list));
UIEXPORT void ui_list_class_set_next(UiList *list, void*(*next)(UiList *list));
UIEXPORT void ui_list_class_set_get(UiList *list, void*(*get)(UiList *list, int i));
UIEXPORT void ui_list_class_set_count(UiList *list, int(*count)(UiList *list));
UIEXPORT void ui_list_class_set_data(UiList *list, void *data);
UIEXPORT void ui_list_class_set_iter(UiList *list, void *iter);

UIEXPORT void ui_object_set(UiObject *obj, const char *key, void *data);
UIEXPORT void* ui_object_get(UiObject *obj, const char *key);

UIEXPORT void ui_app_ref(void);
UIEXPORT void ui_app_unref(void);

UIEXPORT void ui_open_uri(const char *uri);

#ifdef	__cplusplus
}
#endif

#endif	/* UI_TOOLKIT_H */